java.io
클래스 ObjectInputStream

java.lang.Object 
  |
  +--java.io.InputStream 
        |
        +--java.io.ObjectInputStream

모든 구현 인터페이스:

DataInput , ObjectInput , ObjectStreamConstants

public class ObjectInputStream

extends InputStream

implements ObjectInput , ObjectStreamConstants

사전에 ObjectOutputStream 를 사용해 작성된 원시적 데이터와 원시적 오브젝트를 직렬화 복원합니다.

ObjectOutputStream 와 ObjectInputStream 는 FileOutputStream 또는 FileInputStream 와 함께 사용하면, 어플리케이션에, 오브젝트의 그래프를 위한 지속적인 스토리지를 제공할 수가 있습니다. ObjectInputStream 는 사전에 직렬화 된 오브젝트를 바탕으로 되돌리기 위해서(때문에) 사용합니다. 다른 사용 방법으로서는 소켓 스트림의 사용에 의한, 호스트간에서의 오브젝트의 수수나, 리모트 통신 시스템에 있어서의 속성이나 파라미터의 정렬이나 정렬 해제가 있습니다.

ObjectInputStream 는 스트림으로부터 작성된 오브젝트 그래프에 있어서의 모든 형태의 오브젝트가, Java Virual Machine 에 존재하는 클래스에 확실히 성냥 하도록(듯이) 합니다. 클래스는 표준의 기구를 사용해 필요에 따라서 로드 됩니다.

스트림으로부터 읽어들일 수가 있는 것은 java.io.Serializable 인터페이스나 java.io.Externalizable 인터페이스를 서포트하는 오브젝트만입니다.

오브젝트를 스트림으로부터 읽어들이려면 readObject 메소드를 사용합니다. 희망의 형태를 취득하려면 , Java 의 안전한 캐스트를 사용할 필요가 있습니다. Java 에서는 캐릭터 라인과 배열은 오브젝트로, 직렬화의 사이는 오브젝트로서 다루어집니다. 그것들을 읽어들이려면 , 희망의 형태에 캐스트 되고 있을 필요가 있습니다.

기본 데이터형을 스트림으로부터 읽어들이려면 , DataInput 의 적절한 메소드를 사용합니다.

오브젝트의 디폴트의 직렬화 복원 기구는 각 필드의 내용을, 기입해졌을 때 상태에 되돌립니다. transient 또는 static 라고 선언된 필드는 직렬화 복원 처리에서는 무시됩니다. 다른 오브젝트를 참조하면(자), 그러한 오브젝트는 필요에 따라서 스트림으로부터 읽힙니다. 오브젝트의 그래프는 참조 공유 기구를 사용해 올바르게 복원됩니다. 직렬화 복원을 할 때는 항상 새로운 오브젝트를 할당할 수 있어 거기에 따라 기존의 오브젝트에의 덧쓰기가 방지됩니다.

오브젝트의 read는 새로운 오브젝트의 constructor 의 실행을 닮아 있습니다. 메모리를 오브젝트에 할당할 수 있어 제로 (NULL)에 초기화됩니다. 직렬화 가능하지 않은 클래스에 대해서, 인수 없음의 constructor 이 불려 간 뒤, 직렬화 가능 클래스의 필드가, java.lang.Object 에 가장 가까운 클래스로부터 시작되어 가장 오브젝트에 고유의 클래스에서 끝나는 스트림으로부터 복원됩니다.

예를 들어, ObjectOutputStream 의 예로 기입해진 스트림으로부터 의 read는 다음과 같이 실시합니다.

	FileInputStream istream = new FileInputStream("t.tmp");
	ObjectInputStream p = new ObjectInputStream(istream);

	int i = p.readInt();
	String today = (String) p.readObject();
	Date date = (Date) p.readObject();

	istream.close();
 

클래스는 인터페이스 java.io.Serializable 또는 java.io.Externalizable 를 구현하는 것에 의해, 클래스가 어떻게 직렬화 되는지를 제어합니다.

Serializable 인터페이스를 구현하는 것에 의해, 오브젝트의 직렬화가, 오브젝트 상태 전체의 보존과 복원을 실시하는 것이 가능하게 되어, 또 클래스가, 스트림의 기입시와 스트림의 read시의 사이에 전개하는 것이 가능하게 됩니다. 오브젝트의 직렬화는 오브젝트간의 참조를 자동적으로 이동해, 오브젝트 그래프의 전체를 보존 및 복원합니다.

직렬화 처리와 직렬화 복원 처리 때에 특별한 조작을 필요로 하는 Serializable 클래스는 다음의 메소드를 구현할 필요가 있습니다.

 private void writeObject(java.io.ObjectOutputStream stream)
     throws IOException;
 private void readObject(java.io.ObjectInputStream stream)
     throws IOException, ClassNotFoundException; 
 private void readObjectNoData() 
     throws ObjectStreamException;
 

readObject 메소드는 대응하는 writeObject 메소드에 의해 스트림에 기입해진 데이터를 사용하는 특정의 클래스에 도착해, 오브젝트 상태를 보존 및 복원할 책임을 가집니다. 이 메소드는 그 슈퍼 클래스나 서브 클래스에 속하는 상태에 관여할 필요는 없습니다. 상태를 복원하려면 , 개개의 필드에 도착해 ObjectInputStream 로부터 데이터를 읽어들여, 오브젝트의 적절한 필드에의 할당을 실시합니다. 기본 데이터형의 read는 DataInput 에 의해 서포트됩니다.

오브젝트 데이터를 읽어들이려고 할 경우에, 그 위치가 대응하는 writeObject 메소드에 의해 기입해진 커스텀 데이터의 경계를 넘고 있는 경우는 eof 필드의 값이 true 상태로 OptionalDataException 가 슬로우 됩니다. 오브젝트를 직렬화해 읽어들이려고 할 경우에, 그 위치가 할당하고가 끝난 데이터의 마지막을 넘고 있는 경우는 스트림의 경우와 같게, 데이터의 마지막을 나타내는 예외가 돌려주어집니다. 즉, 바이트 단위의 read에서는 바이트가 읽혔을 때에 -1 가 돌려주어집니다. 원시적 read에서는 EOFException 가 슬로우 됩니다. 대응하는 writeObject 메소드가 없는 경우는 디폴트의 직렬화 데이터의 마지막이 할당하고가 끝난 데이터가 끝나게 됩니다.

원시적 read와 오브젝트 read가 readExternal 메소드로부터 불려 갔을 경우는 양쪽 모두 똑같이 동작합니다. 스트림의 위치가 대응하는 writeExternal 메소드에 의해 기입해진 데이터의 마지막에 있는 경우, 오브젝트 read에서는 eof 가 true 로 설정된 상태로 OptionalDataException 가 슬로우 되어 원시적 read에서는 EOFException 가 슬로우 됩니다. 다만, 낡은 ObjectStreamConstants.PROTOCOL_VERSION_1 프로토콜을 사용해 기입해진 스트림에서는 이 동작은 적용되지 않습니다. writeExternal 메소드와 달리, 데이터의 마지막이 기입해지지 않기 때문에, 데이터의 마지막을 검출할 수 없기 때문입니다.

readObjectNoData 메소드는 직렬화 복원되는 오브젝트의 슈퍼 클래스가 직렬화 스트림으로 지정되어 있지 않을 때에, 특정의 클래스에 도착해 그 오브젝트 상태를 초기화합니다. 직렬화 복원되는 인스턴스의 클래스가 수신측과 송신측에서 다른 경우나, 수신측의 인스턴스로 확장되고 있는 클래스가 송신측에서 확장되어 있지 않은 경우에, 이러한 상황이 발생하는 일이 있습니다. 또, 직렬화 스트림이 개찬되고 있는 경우에도 발생합니다. 악의가 있는 또는 불완전한 소스 스트림으로부터 직렬화 복원한 오브젝트를 적절히 초기화할 때는 readObjectNoData 를 사용합니다.

직렬화는 java.io.Serializable 인터페이스를 구현하지 않는 오브젝트의 필드의 read나, 그러한 필드에의 값의 할당은 실시하지 않습니다. 직렬화 가능하지 않은 오브젝트의 서브 클래스를 직렬화 가능하게 하는 것은 가능합니다. 이 경우, 직렬화 가능하지 않은 클래스는 그 필드를 초기화할 수 있게 하기 위한(해), 인수 없음의 constructor를 가질 필요가 있습니다. 이 경우, 직렬화 가능하지 않은 클래스 상태를 보존 및 복원하는 것은 서브 클래스의 책임이 됩니다. 그 클래스의 필드가 액세스 가능한 (public, package, 또는 protected) 경우, 혹은 상태의 복원에 이용할 수 있는 set 메소드나 get 메소드가 있는 경우가 자주 있습니다.

오브젝트를 직렬화 복원하는 동안에 발생한 모든 예외는 ObjectInputStream 에 캐치 되어 read 처리를 이상종료(ABEND) 시킵니다.

Externalizable 인터페이스를 구현하면(자), 오브젝트의 직렬화 된 형식의 내용 및 형식을 오브젝트측이 완전하게 제어하는 것이 가능하게 됩니다. Externalizable 인터페이스의 메소드인 writeExternal 와 readExternal 는 오브젝트 상태를 보존 및 복원하기 위해서(때문에) 불려 갑니다. 이러한 메소드는 클래스에 의해 구현되었을 경우에는 ObjectOutput 와 ObjectInput 의 모든 메소드를 사용해, 자신 상태의 기입 및 read를 실시할 수가 있습니다. 어떠한 버젼이어도 처리할 수 있게 하는 것은 오브젝트의 책임입니다.

도입된 버젼:

JDK1. 1

관련 항목:

DataInput , ObjectOutputStream , Serializable , 「오브젝트 직렬화 사양의 제 3 장 오브젝트 입력 클래스」

중첩된 클래스의 개요

static class

ObjectInputStream.GetField 입력 스트림으로부터 읽힌 지속 필드에의 액세스를 제공합니다.

필드의 개요

인터페이스 java.io. ObjectStreamConstants 에서 상속받은 필드

baseWireHandle , PROTOCOL_VERSION_1 , PROTOCOL_VERSION_2 , SC_BLOCK_DATA , SC_EXTERNALIZABLE , SC_SERIALIZABLE , SC_WRITE_METHOD , STREAM_MAGIC , STREAM_VERSION , SUBCLASS_IMPLEMENTATION_PERMISSION , SUBSTITUTION_PERMISSION , TC_ARRAY , TC_BASE , TC_BLOCKDATA , TC_BLOCKDATALONG , TC_CLASS , TC_CLASSDESC , TC_ENDBLOCKDATA , TC_EXCEPTION , TC_LONGSTRING , TC_MAX , TC_NULL , TC_OBJECT , TC_PROXYCLASSDESC , TC_REFERENCE , TC_RESET , TC_STRING

생성자의 개요

protected	ObjectInputStream () ObjectInputStream 를 완전하게 재구현하는 서브 클래스가, ObjectInputStream 의 이 구현에 의해 사용된지 얼마 안된 private 데이터를 할당할 필요가 없게 하는 수단을 제공합니다.
	ObjectInputStream (InputStream in) 지정된 InputStream 로부터 읽어들이는 ObjectInputStream 를 작성합니다.

메소드의 개요

int	available () 블록 하지 않고 읽어들일 수가 있는 바이트수를 돌려줍니다.
void	close () 입력 스트림을 닫습니다.
void	defaultReadObject () 현재의 클래스의 비 static 및 비 transient 의 필드를, 이 스트림으로부터 읽어들입니다.
protected boolean	enableResolveObject (boolean enable) 스트림으로부터 읽힌 오브젝트가 치환됩니다.
int	read () 데이터의 바이트를 읽어들입니다.
int	read (byte[] buf, int off, int len) 바이트의 배열에 읽어들입니다.
boolean	readBoolean () boolean 를 읽어들입니다.
byte	readByte () 8 비트의 바이트를 읽어들입니다.
char	readChar () 16 비트의 char 를 읽어들입니다.
protected ObjectStreamClass	readClassDescriptor () 직렬화 스트림으로부터 클래스 기술자를 읽어들입니다.
double	readDouble () 64 비트의 double 를 읽어들입니다.
ObjectInputStream.GetField	readFields () 스트림으로부터 지속 필드를 읽어들여, 그것들을 이름을 지정해 액세스 할 수 있게 합니다.
float	readFloat () 32 비트의 float 를 읽어들입니다.
void	readFully (byte[] buf) 바이트를 읽어들입니다.
void	readFully (byte[] buf, int off, int len) 바이트를 읽어들입니다.
int	readInt () 32 비트의 int 를 읽어들입니다.
String	readLine () 추천 되고 있지 않습니다. 이 메소드는 바이트를 정확하게 캐릭터로 변환하지 않습니다. 상세 및 대체 메소드에 대해서는 DataInputStream 를 참조해 주세요.
long	readLong () 64 비트의 long 를 읽어들입니다.
Object	readObject () ObjectInputStream 로부터 오브젝트를 읽어들입니다.
protected Object	readObjectOverride () 인수 없음의 protected constructor를 사용해 ObjectOutputStream 를 작성한 ObjectOutputStream 의 신뢰할 수 있는 서브 클래스에 의해 불려 갑니다.
short	readShort () 16 비트의 short 를 읽어들입니다.
protected void	readStreamHeader () 서브 클래스가 자신의 스트림 헤더의 read와 검증을 실시할 수 있게 하기 위해서 제공되고 있습니다.
Object	readUnshared () ObjectInputStream 로부터 「공유되지 않는다」오브젝트를 읽어들입니다.
int	readUnsignedByte () 부호 없음 8 비트 바이트를 읽어들입니다.
int	readUnsignedShort () 부호 없음 16 비트의 short 를 읽어들입니다.
String	readUTF () UTF 형식의 캐릭터 라인을 읽어들입니다.
void	registerValidation (ObjectInputValidation obj, int prio) 오브젝트 그래프가 돌려주어지기 전에 검증되어야 할 오브젝트를 등록합니다.
protected Class	resolveClass (ObjectStreamClass desc) 지정된 스트림 클래스의 기술에 대응하는 로컬 클래스를 로드합니다.
protected Object	resolveObject (Object obj) 직렬화 복원 시에, ObjectInputStream 의 신뢰할 수 있는 서브 클래스가, 어느 오브젝트를 다른 오브젝트에 치환할 수 있게 합니다.
protected Class	resolveProxyClass (String [] interfaces) 프록시 클래스 기술자로 지정된 인터페이스를 구현하는 프록시 클래스를 돌려줍니다.
int	skipBytes (int len) 바이트를 스킵 합니다.

클래스 java.io. InputStream 에서 상속받은 메소드

mark , markSupported , read , reset , skip

클래스 java.lang. Object 에서 상속받은 메소드

clone , equals , finalize , getClass , hashCode , notify , notifyAll , toString , wait , wait , wait

인터페이스 java.io. ObjectInput 에서 상속받은 메소드

read , skip

생성자의 상세

ObjectInputStream

public ObjectInputStream(InputStream  in)
                  throws IOException 

지정된 InputStream 로부터 읽어들이는 ObjectInputStream 를 작성합니다. 직렬화 스트림 헤더는 스트림으로부터 읽힌 뒤, 검증됩니다. 이 constructor 은 대응하는 ObjectOutputStream 가 헤더를 기입해 플래시 할 때까지 블록 합니다.

시큐러티 매니저가 인스톨 되고 있는 경우, ObjectInputStream.readFields 메소드 또는 ObjectInputStream.readUnshared 메소드를 오버라이드(override) 하는 서브 클래스의 constructor 에 의해 SerializablePermission("enableSubclassImplementation")가 직접 또는 간접에 불려 갔을 때에, 이 constructor 은 이 액세스권을 확인합니다.

파라미터:

in - read원의 입력 스트림

예외:

StreamCorruptedException - 스트림 헤더가 부정한 경우

IOException - 스트림 헤더의 read중에 입출력 에러가 발생했을 경우

SecurityException - 신뢰되어 있지 않은 서브 클래스가, 보안상 중요한 메소드를 부정하게 오버라이드(override) 했을 경우

관련 항목:

ObjectInputStream() , readFields() , ObjectOutputStream.ObjectOutputStream(OutputStream)

ObjectInputStream

protected ObjectInputStream()
                     throws IOException ,
                            SecurityException 

ObjectInputStream 를 완전하게 재구현하는 서브 클래스가, ObjectInputStream 의 이 구현에 의해 사용된지 얼마 안된 private 데이터를 할당할 필요가 없게 하는 수단을 제공합니다.

시큐러티 매니저가 인스톨 되고 있는 경우, 이 메소드는 우선 시큐러티 매니저의 checkPermission 메소드를 액세스권 SerializablePermission("enableSubclassImplementation") 로 호출해, 서브 클래스화를 유효하게 할 수 있게 합니다.

예외:

SecurityException - 시큐러티 매니저가 존재해, 그 checkPermission 메소드가 서브 클래스화를 유효하게 하는 것을 거부했을 경우

IOException

관련 항목:

SecurityManager.checkPermission(java.security.Permission) , SerializablePermission

메소드의 상세

readObject

public final Object  readObject()
                        throws IOException ,
                               ClassNotFoundException 

ObjectInputStream 로부터 오브젝트를 읽어들입니다. 오브젝트의 클래스, 클래스의 형태, 클래스의 비 transient 및 비 static 필드와 그 슈퍼타입의 모든 값이 읽힙니다. 어느 클래스에 대한 디폴트의 직렬화 복원은 writeObject 와 readObject 메소드를 사용해 오버라이드(override) 할 수가 있습니다. 이 오브젝트에 의해 참조되는 오브젝트는 중간적으로 읽혀 거기에 따라, 완전하게 동등한 오브젝트 그래프가 readObject 에 의해 재구축 됩니다.

루트 오브젝트는 참조하는 필드와 오브젝트의 모든 것이 복원되었을 때, 완전하게 복원됩니다. 이 시점에서, 그러한 등록된 우선 순위에 근거해, 오브젝트 검증 콜백이 실행됩니다. 이 콜백은 (특별한 readObject 메소드의) 오브젝트에 의해, 그것들이 개별적으로 복원될 때 등록됩니다.

예외는 InputStream 에 관한 문제나, 직렬화 복원해야 하는 것이 아닌 클래스에 도착해 슬로우 됩니다. 모든 예외는 InputStream 에 있어 치명적이어, InputStream 를 불확정 상태로 합니다. 스트림 상태를 무시할까 회복 처리할까를 결정하는 것은 호출측입니다.

정의:

인터페이스 ObjectInput 내의 readObject

반환값:

스트림으로부터 읽힌 오브젝트

예외:

ClassNotFoundException - 직렬화 된 오브젝트의 클래스가 발견되지 않았던 경우

InvalidClassException - 직렬화로 사용되는 클래스에 하등의 불편이 있었을 경우

StreamCorruptedException - 스트림의 제어 정보에 일관성이 없는 경우

OptionalDataException - 원시적 데이터가, 오브젝트는 아니고 스트림에 발견되었을 경우

IOException - 입출력에 관련한 예외의 어떤 것인가가 발생했을 경우

readObjectOverride

protected Object  readObjectOverride()
                             throws IOException ,
                                    ClassNotFoundException 

인수 없음의 protected constructor를 사용해 ObjectOutputStream 를 작성한 ObjectOutputStream 의 신뢰할 수 있는 서브 클래스에 의해 불려 갑니다. 서브 클래스는 수식자가 final 의 오버라이드(override) 메소드를 제공한다고 보여집니다.

반환값:

스트림으로부터 읽힌 오브젝트

예외:

ClassNotFoundException - 직렬화 된 오브젝트의 클래스가 발견되지 않았던 경우

OptionalDataException - 원시적 데이터가, 오브젝트는 아니고 스트림에 발견되었을 경우

IOException - 기본이 되는 스트림의 read중에 입출력 에러가 발생했을 경우

도입된 버젼:

1.2

관련 항목:

ObjectInputStream() , readObject()

readUnshared

public Object  readUnshared()
                    throws IOException ,
                           ClassNotFoundException 

ObjectInputStream 로부터 「공유되지 않는다」오브젝트를 읽어들입니다. 이 메소드는 readObject 와 닮아 있습니다. 다만, readObject 및 readUnshared 를 호출해, 이 호출이 취득한 직렬화 복원된 인스턴스에 대한 참조를 돌려줄 수 없습니다. 예를 들어, 다음과 같은 참조는 할 수 없습니다.

• readUnshared 를 호출해 역참조 (스트림에 기입해진 오브젝트의 스트림 표현)를 직렬화 복원하려고 하면(자), ObjectStreamException 가 슬로우 된다
• readUnshared 가 정상적으로 복귀한 다음에, readUnshared 가 직렬화 복원한 스트림 핸들에의 역참조를 직렬화 복원하려고 하면(자), ObjectStreamException 가 슬로우 된다

readUnshared 를 호출해 오브젝트를 직렬화 복원하면(자), 돌려주어지는 오브젝트에 관련지을 수 있었던 스트림 핸들이 무효가 됩니다. 다만, readUnshared 로부터 돌려주어지는 참조가 일의이다고는 할 수 없습니다. 직렬화 복원된 오브젝트에 readResolve 메소드가 정의되고 있었을 경우, 공유되고 있는 오브젝트가 돌려주어지는 일이 있습니다. 또, 그 스트림외의 장소나 외부로부터 취득한 Class 오브젝트를 돌려주는 일도 있습니다.

다만, 복원된 오브젝트가 java.lang.Class 의 인스턴스는 아니고, readResolve 메소드를 정의하고 있지 않는 경우, readUnshared 로부터 돌려주어지는 오브젝트 참조는 항상 일의입니다. 바탕으로 되는 데이터 스트림이 조작되고 있는 경우에서도, 그것을 작성한 ObjectInputStream 로부터 오브젝트 참조를 재차 취득할 수 없습니다. 이 규칙은 readUnshared 로부터 돌려주어진 베이스 레벨의 오브젝트인 만큼 적용되어 돌려주어진 오브젝트 그래프내에서 참조되는 서브 오브젝트에는 적용되지 않습니다.

이 메소드를 오버라이드(override) 하는 ObjectInputStream 서브 클래스는 SerializablePermission("enableSubclassImplementation")를 가지는 시큐러티 문맥내에서만 구축할 수 있습니다. 이 액세스권을 가지지 않는 시큐러티 문맥으로 인스턴스화하려고 하면(자), SecurityException 가 슬로우 됩니다.

반환값:

직렬화 복원 오브젝트에의 참조

예외:

ClassNotFoundException - 직렬화 복원하는 오브젝트의 클래스가 발견되지 않았던 경우

StreamCorruptedException - 스트림의 제어 정보에 일관성이 없는 경우

ObjectStreamException - 직렬화 복원하는 오브젝트가 벌써 스트림내에 있었을 경우

OptionalDataException - 스트림내의 다음의 데이터가 원시적의 경우

IOException - 직렬화 복원중에 입출력 에러가 발생했을 경우

defaultReadObject

public void defaultReadObject()
                       throws IOException ,
                              ClassNotFoundException 

현재의 클래스의 비 static 및 비 transient 의 필드를, 이 스트림으로부터 읽어들입니다. 이 메소드를 호출할 수가 있는 것은 직렬화가 복원되고 있는 클래스의 readObject 메소드 뿐입니다. 다른 방법으로 불려 갔을 경우는 NotActiveException 를 슬로우 합니다.

예외:

ClassNotFoundException - 직렬화 된 오브젝트의 클래스가 발견되지 않았던 경우

IOException - 입출력 에러가 발생했을 경우

NotActiveException - 스트림이 현재 오브젝트를 읽어들이지 않은 경우

readFields

public ObjectInputStream.GetField  readFields()
                                      throws IOException ,
                                             ClassNotFoundException 

스트림으로부터 지속 필드를 읽어들여, 그것들을 이름을 지정해 액세스 할 수 있게 합니다.

반환값:

직렬화 복원되고 있는 오브젝트의 지속 필드를 나타내는 GetField 오브젝트

예외:

ClassNotFoundException - 직렬화 된 오브젝트의 클래스가 발견되지 않았던 경우

IOException - 입출력 에러가 발생했을 경우

NotActiveException - 스트림이 현재 오브젝트를 읽어들이지 않은 경우

도입된 버젼:

1.2

registerValidation

public void registerValidation(ObjectInputValidation  obj,
                               int prio)
                        throws NotActiveException ,
                               InvalidObjectException 

오브젝트 그래프가 돌려주어지기 전에 검증되어야 할 오브젝트를 등록합니다. 이 검증은 resolveObject 를 닮아 있습니다만, 오브젝트 그래프 전체가 재구축 된 뒤에 불려 가는 점이 다릅니다. 통상, readObject 메소드는 스트림과 함께 오브젝트를 등록해, 거기에 따라 오브젝트의 모든 것이 복원되었을 때에 최종적인 검증을 실행할 수 있게 합니다.

파라미터:

obj - 검증의 콜백을 받는 오브젝트

prio - 콜백의 순서를 제어하는 값. 0 이 적절한 디폴트 값이다. 빨리 콜백 하는 경우는 큰 번호를, 나중에 콜백 하는 경우는 작은 번호를 사용한다. 같은 우선 순위내에서는 콜백의 처리에 특별한 순서는 없다

예외:

NotActiveException - 스트림이 현재 오브젝트를 읽어들이지 않기 때문에, 콜백을 등록할 수 없는 경우

InvalidObjectException - 검증 오브젝트가 null 의 경우

resolveClass

protected Class  resolveClass(ObjectStreamClass  desc)
                      throws IOException ,
                             ClassNotFoundException 

지정된 스트림 클래스의 기술에 대응하는 로컬 클래스를 로드합니다. 서브 클래스는 이 메소드를 구현해, 대체 소스로부터 클래스를 취득합니다.

ObjectOutputStream 의 대응하는 메소드는 annotateClass 입니다. 이 메소드는 스트림의 일의의 클래스 각각 붙어 1 회만 불려 갑니다. 이 메소드는 대체의 로드 기구를 사용하기 위해서 구현할 수가 있습니다만, 클래스 오브젝트를 돌려줄 필요가 있습니다. 클래스 오브젝트가 돌려주어지면(자), 그 클래스의 serialVersionUID 가, 직렬화 된 클래스의 serialVersionUID 라고 비교됩니다. 불일치가 있으면(자), 직렬화 복원에 불편이 발생해, 예외가 불려 갑니다.

디폴트에서는 클래스명은 readObject 를 호출한 클래스와 대응 붙여 해결됩니다.

파라미터:

desc - ObjectStreamClass 클래스의 인스턴스

반환값:

v 에 대응하는 Class 오브젝트

예외:

IOException - 통상의 입출력 관련의 예외가 발생했을 경우

ClassNotFoundException - 직렬화 된 오브젝트가 발견되지 않았던 경우

resolveProxyClass

protected Class  resolveProxyClass(String [] interfaces)
                           throws IOException ,
                                  ClassNotFoundException 

프록시 클래스 기술자로 지정된 인터페이스를 구현하는 프록시 클래스를 돌려줍니다. 서브 클래스는 이 메소드를 구현해 다이나믹 프록시 클래스의 기술자와 함께 스트림으로부터 커스텀 데이터를 읽어들여, 인터페이스나 프록시 클래스의 대체 로딩 기구를 사용할 수 있게 합니다.

이 메소드는 스트림의 일의의 각 프록시 클래스 기술자에 대해 1 회만 불려 갑니다.

ObjectOutputStream 에서의 대응하는 메소드는 annotateProxyClass 입니다. 이 메소드를 오버라이드(override) 하는 지정된 서브 클래스 ObjectInputStream 에 대해서,ObjectOutputStream 의 대응하는 서브 클래스에 있는 annotateProxyClass 메소드는 이 메소드가 읽어들이는 임의의 데이터 또는 오브젝트를 기입할 필요가 있습니다.

ObjectInputStream 에 있는 이 메소드의 디폴트 구현은 interfaces 파라미터로 지정된 인터페이스의 Class 오브젝트의 리스트와 함께 Proxy.getProxyClass 의 호출 결과를 돌려줍니다. 각 인터페이스명 i 의 Class 오브젝트가 돌려주어집니다.

     Class.forName(i, false, loader)
 

여기서 loader 는 실행 스택까지의 최초의 null 가 아닌 클래스, 또는 null 가 아닌 클래스 로더가 스택측 (resolveClass 메소드가 사용하는 같은 클래스 로더의 선택)에 없는 경우는 null 입니다. 해결된 인터페이스가 public 가 아닌 경우는 같은 값의 loader 가 Proxy.getProxyClass 에게 건네집니다. public 가 아닌 인터페이스가 있는 경우는 그 클래스 로더가 건네받습니다 (public 가 아닌 인터페이스의 클래스 로더가 복수 검출되었을 경우는 IllegalAccessError 가 슬로우 된다). Proxy.getProxyClass 가 IllegalArgumentException 를 슬로우 하면(자),resolveProxyClass 는 IllegalArgumentException 와 함께 ClassNotFoundException 를 슬로우 합니다.

파라미터:

interfaces - 프록시 클래스 기술자에게 직렬화 복원된 인터페이스명의 리스트

반환값:

지정된 인터페이스의 프록시 클래스

예외:

IOException - 기본이 되는 InputStream 에 예외가 발생했을 경우

ClassNotFoundException - 프록시 클래스 또는 지정된 인터페이스가 어느 것도 발견되지 않았던 경우

도입된 버젼:

1.3

관련 항목:

ObjectOutputStream.annotateProxyClass(Class)

resolveObject

protected Object  resolveObject(Object  obj)
                        throws IOException 

직렬화 복원 시에, ObjectInputStream 의 신뢰할 수 있는 서브 클래스가, 어느 오브젝트를 다른 오브젝트에 치환할 수 있게 합니다. 오브젝트의 치환은 enableResolveObject 가 불려 갈 때까지는 실시할 수 없습니다. enableResolveObject 메소드는 오브젝트의 해석 처리를 요구하고 있는 스트림을 신뢰할 수 있을지 어떨지를 조사합니다. 직렬화 가능 오브젝트에의 모든 참조는 resolveObject 에게 건네집니다. 오브젝트의 private 인 상태가 의도하지 않고 누설 하는 것이 없게, resolveObject 를 사용하는 것은 신뢰할 수 있는 스트림으로 한정됩니다.

이 메소드는 오브젝트가 읽힌 뒤, readObject 로부터 복귀하기 전에 불려 갑니다. 디폴트의 resolveObject 메소드는 같은 오브젝트만을 돌려줍니다.

서브 클래스는 오브젝트를 치환할 때, 치환된 오브젝트와 참조가 저장되는 각 필드와의 호환성을 프로텍션할 필요가 있습니다. 필드 또는 배열 요소의 형태의 서브 클래스가 아닌 형태의 오브젝트는 예외를 발생시키는 것에 의해 직렬화를 중단해, 그 결과 오브젝트는 저장되지 않습니다.

이 메소드는 각 오브젝트가 최초로 검출되었을 때에 1 회만 불려 갑니다. 이것 이후 검출되는 그 오브젝트에의 참조는 새로운 오브젝트에 리디렉트 됩니다.

파라미터:

obj - 치환되는 오브젝트

반환값:

치환된 오브젝트

예외:

IOException - 통상의 입출력 관련의 예외가 발생했을 경우

enableResolveObject

protected boolean enableResolveObject(boolean enable)
                               throws SecurityException 

스트림으로부터 읽힌 오브젝트가 치환됩니다. 유효하게 하면(자), 오브젝트가 직렬화 복원될 때, 항상 resolveObject 메소드가 불려 갑니다.

enable 가 true 로, 시큐러티 매니저가 인스톨 되고 있는 경우, 이 메소드는 우선 시큐러티 매니저의 checkPermission 메소드를 액세스권 SerializablePermission("enableSubstitution") 로 호출해, 스트림으로부터 읽힌 오브젝트의 치환을 스트림을 허가할 수 있게 합니다.

파라미터:

enable - 직렬화 복원되는 각 오브젝트에 대해 resolveObject 의 사용을 유효하게 하는 경우는 true

반환값:

이 메소드가 불려 가기 전의 설정

예외:

SecurityException - 시큐러티 매니저가 존재해, 그 checkPermission 메소드가, 스트림으로부터 읽힌 오브젝트의 치환을 스트림을 허가할 수 있게 하는 것을 거부하는 경우

관련 항목:

SecurityManager.checkPermission(java.security.Permission) , SerializablePermission

readStreamHeader

protected void readStreamHeader()
                         throws IOException ,
                                StreamCorruptedException 

서브 클래스가 자신의 스트림 헤더의 read와 검증을 실시할 수 있게 하기 위해서 제공되고 있습니다. 이 메소드는 매직 번호와 버젼 번호를 읽어들입니다.

예외:

IOException - 기본이 되는 InputStream 의 read중에 입출력 에러가 발생했을 경우

StreamCorruptedException - 스트림의 제어 정보에 일관성이 없는 경우

readClassDescriptor

protected ObjectStreamClass  readClassDescriptor()
                                         throws IOException ,
                                                ClassNotFoundException 

직렬화 스트림으로부터 클래스 기술자를 읽어들입니다. 이 메소드는 ObjectInputStream 가 직렬화 스트림의 다음의 아이템으로서 클래스 기술자를 요구하면(자) 불려 갑니다. ObjectInputStream 의 서브 클래스는 이 메소드를 오버라이드(override) 해 표준이 아닌 형식에서 (writeClassDescriptor 메소드를 오버라이드(override) 한 ObjectOutputStream 의 서브 클래스에 의해) 기입해진 클래스 기술자에게 읽어들입니다. 디폴트에서는 이 메소드는 클래스 기술자를 오브젝트 직렬화 사양에 정의된 형식에서 읽어들입니다.

반환값:

읽힌 클래스 기술자

예외:

IOException - 입출력 에러가 발생했을 경우

ClassNotFoundException - 클래스 기술자 표현에 사용한 직렬화 된 오브젝트의 클래스가 발견되지 않았던 경우

도입된 버젼:

1.3

관련 항목:

ObjectOutputStream.writeClassDescriptor(java.io.ObjectStreamClass)

read

public int read()
         throws IOException 

데이터의 바이트를 읽어들입니다. 이 메소드는 유효한 입력이 아직 없는 경우는 블록 합니다.

정의:

인터페이스 ObjectInput 내의 read

정의:

클래스 InputStream 내의 read

반환값:

읽힌 바이트. 스트림의 마지막에 이르렀을 경우는 -1

예외:

IOException - 입출력 에러가 발생했을 경우

read

public int read(byte[] buf,
                int off,
                int len)
         throws IOException 

바이트의 배열에 읽어들입니다. 이 메소드는 입력을 할 수 있게 될 때까지 블록 합니다. 바이트의 길이를 정확하게 읽어들이려면 , java.io.DataInputStream.readFully 를 사용해 주세요.

정의:

인터페이스 ObjectInput 내의 read

오버라이드(override):

클래스 InputStream 내의 read

파라미터:

buf - 데이터의 read처의 버퍼

off - 데이터의 개시 오프셋(offset)

len - 읽히는 최대 바이트수

반환값:

읽히는 바이트의 실제의 수. 스트림의 마지막에 이르렀을 경우는 -1

예외:

IOException - 입출력 에러가 발생했을 경우

관련 항목:

DataInputStream.readFully(byte[], int, int)

available

public int available()
              throws IOException 

블록 하지 않고 읽어들일 수가 있는 바이트수를 돌려줍니다.

정의:

인터페이스 ObjectInput 내의 available

오버라이드(override):

클래스 InputStream 내의 available

반환값:

읽어들여 가능한 바이트수

예외:

IOException - 기본이 되는 InputStream 의 read중에 입출력 에러가 발생했을 경우

close

public void close()
           throws IOException 

입력 스트림을 닫습니다. 스트림에 관련하는 모든 리소스를 해방하기 위해서 호출할 필요가 있습니다.

정의:

인터페이스 ObjectInput 내의 close

오버라이드(override):

클래스 InputStream 내의 close

예외:

IOException - 입출력 에러가 발생했을 경우

readBoolean

public boolean readBoolean()
                    throws IOException 

boolean 를 읽어들입니다.

정의:

인터페이스 DataInput 내의 readBoolean

반환값:

읽히는 boolean 치

예외:

EOFException - 파일의 마지막에 이르렀을 경우

IOException - 다른 입출력 에러가 발생했을 경우

readByte

public byte readByte()
              throws IOException 

8 비트의 바이트를 읽어들입니다.

정의:

인터페이스 DataInput 내의 readByte

반환값:

읽히는 8 비트의 바이트치

예외:

EOFException - 파일의 마지막에 이르렀을 경우

IOException - 다른 입출력 에러가 발생했을 경우

readUnsignedByte

public int readUnsignedByte()
                     throws IOException 

부호 없음 8 비트 바이트를 읽어들입니다.

정의:

인터페이스 DataInput 내의 readUnsignedByte

반환값:

읽히는 8 비트의 바이트치

예외:

EOFException - 파일의 마지막에 이르렀을 경우

IOException - 다른 입출력 에러가 발생했을 경우

readChar

public char readChar()
              throws IOException 

16 비트의 char 를 읽어들입니다.

정의:

인터페이스 DataInput 내의 readChar

반환값:

읽히는 16 비트의 char 치

예외:

EOFException - 파일의 마지막에 이르렀을 경우

IOException - 다른 입출력 에러가 발생했을 경우

readShort

public short readShort()
                throws IOException 

16 비트의 short 를 읽어들입니다.

정의:

인터페이스 DataInput 내의 readShort

반환값:

읽히는 16 비트의 short 치

예외:

EOFException - 파일의 마지막에 이르렀을 경우

IOException - 다른 입출력 에러가 발생했을 경우

readUnsignedShort

public int readUnsignedShort()
                      throws IOException 

부호 없음 16 비트의 short 를 읽어들입니다.

정의:

인터페이스 DataInput 내의 readUnsignedShort

반환값:

읽히는 16 비트의 short 치

예외:

EOFException - 파일의 마지막에 이르렀을 경우

IOException - 다른 입출력 에러가 발생했을 경우

readInt

public int readInt()
            throws IOException 

32 비트의 int 를 읽어들입니다.

정의:

인터페이스 DataInput 내의 readInt

반환값:

읽히는 32 비트의 int 치

예외:

EOFException - 파일의 마지막에 이르렀을 경우

IOException - 다른 입출력 에러가 발생했을 경우

readLong

public long readLong()
              throws IOException 

64 비트의 long 를 읽어들입니다.

정의:

인터페이스 DataInput 내의 readLong

반환값:

읽히는 64 비트의 long 치

예외:

EOFException - 파일의 마지막에 이르렀을 경우

IOException - 다른 입출력 에러가 발생했을 경우

readFloat

public float readFloat()
                throws IOException 

32 비트의 float 를 읽어들입니다.

정의:

인터페이스 DataInput 내의 readFloat

반환값:

읽히는 32 비트의 float 치

예외:

EOFException - 파일의 마지막에 이르렀을 경우

IOException - 다른 입출력 에러가 발생했을 경우

readDouble

public double readDouble()
                  throws IOException 

64 비트의 double 를 읽어들입니다.

정의:

인터페이스 DataInput 내의 readDouble

반환값:

읽히는 64 비트의 double 치

예외:

EOFException - 파일의 마지막에 이르렀을 경우

IOException - 다른 입출력 에러가 발생했을 경우

readFully

public void readFully(byte[] buf)
               throws IOException 

바이트를 읽어들입니다. 모든 바이트가 읽힐 때까지 블록 합니다.

정의:

인터페이스 DataInput 내의 readFully

파라미터:

buf - 데이터의 read처의 버퍼

예외:

EOFException - 파일의 마지막에 이르렀을 경우

IOException - 다른 입출력 에러가 발생했을 경우

readFully

public void readFully(byte[] buf,
                      int off,
                      int len)
               throws IOException 

바이트를 읽어들입니다. 모든 바이트가 읽힐 때까지 블록 합니다.

정의:

인터페이스 DataInput 내의 readFully

파라미터:

buf - 데이터의 read처의 버퍼

off - 데이터의 개시 오프셋(offset)

len - 읽어들이는 최대 바이트수

예외:

EOFException - 파일의 마지막에 이르렀을 경우

IOException - 다른 입출력 에러가 발생했을 경우

skipBytes

public int skipBytes(int len)
              throws IOException 

바이트를 스킵 합니다. 모든 바이트가 스킵 될 때까지 블록 합니다.

정의:

인터페이스 DataInput 내의 skipBytes

파라미터:

len - 스킵 하는 바이트수

반환값:

실제로 스킵 된 바이트수

예외:

EOFException - 파일의 마지막에 이르렀을 경우

IOException - 다른 입출력 에러가 발생했을 경우

readLine

public String  readLine()
                throws IOException 

추천 되고 있지 않습니다. 이 메소드는 바이트를 정확하게 캐릭터로 변환하지 않습니다. 상세 및 대체 메소드에 대해서는 DataInputStream 를 참조해 주세요.

\n, \r, \r\n, 또는 EOF 로 종료하는 행을 읽어들입니다.

정의:

인터페이스 DataInput 내의 readLine

반환값:

행의 캐릭터 라인의 카피

예외:

IOException - 기본이 되는 InputStream 의 read중에 입출력 에러가 발생했을 경우

readUTF

public String  readUTF()
               throws IOException 

UTF 형식의 캐릭터 라인을 읽어들입니다.

정의:

인터페이스 DataInput 내의 readUTF

반환값:

캐릭터 라인

예외:

IOException - 기본이 되는 InputStream 의 read중에 입출력 에러가 발생했을 경우