ObjectInputStream (Java 2 Platform SE 5.0)

개요

패키지

클래스

사용

계층 트리

비추천 API

색인

헬프

Java^TM 2 Platform
Standard Ed. 5.0

이전 클래스 다음 클래스

프레임으로 프레임 없이

개요: 상자 | 필드 | constructor | 메서드

상세: 필드 | 생성자 | 메서드

java.io
클래스 ObjectInputStream

java.lang.Object 
  java.io.InputStream 
      java.io.ObjectInputStream

모든 구현된 인터페이스:: Closeable, DataInput, ObjectInput, ObjectStreamConstants

public class ObjectInputStream
extends InputStream
implements ObjectInput, ObjectStreamConstants
extends InputStream
implements ObjectInput, ObjectStreamConstants

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

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

ObjectInputStream는 스트림로부터 작성된 객체 그래프에 있어서의 모든 형태의 객체가 Java 가상 머신에 존재하는 클래스에 확실히 성냥 하도록 합니다. 클래스는 표준의 도구를 사용해 필요에 따라서 로드 됩니다.

스트림로부터 읽어들일 수 있는 것은 java.io.Serializable 인터페이스나 java.io.Externalizable 인터페이스를 지원하는 객체만입니다.

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

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

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

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

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


        FileInputStream fis = new FileInputStream("t.tmp");
        ObjectInputStream ois = new ObjectInputStream(fis);

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

        ois.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가 Throw 되어 바이트 단위의 read에서는 -1 이 돌려주고져 원시적 read에서는 EOFException가 발생 됩니다. 다만, 낡은 ObjectStreamConstants.PROTOCOL_VERSION_1 프로토콜을 사용해 출력해진 스트림에서는 이 동작은 적용되지 않습니다. writeExternal 메서드와 달리, 데이터의 마지막이 출력해지지 않기 때문에 데이터의 마지막을 검출할 수 없기 때문입니다.

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

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

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

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

enum 정수는 보통 의 직렬화 가능 객체나 외부화 가능 객체와는 다른 방법으로 직렬화 복원됩니다. enum 정수의 직렬화 형식은 이름만으로 구성됩니다. 정수의 필드값는 전송 되지 않습니다. enum 정수를 직렬화 복원하려면, ObjectInputStream가 스트림로부터 정수의 이름을 읽어들입니다. 다음에 enum 정수의 기저형이라고 받은 정수명을 인수로서 사용해, static 메서드 Enum.valueOf(Class, String)를 호출하면 직렬화 복원된 정수를 취득할 수 있습니다. 다른 직렬화 가능 객체 또는 외부화 가능 객체와 같이, enum 정수도, 직렬화 스트림에 나중에 나타나는 역참조의 타겟으로서 기능할 수 있습니다. enum 정수가 직렬화 복원되는 순서는 커스터마이즈 할 수 없습니다. 즉, enum 형에 의해 정의된, 클래스 특유의 readObject, readObjectNoData 및 readResolve 메서드는 직렬화 복원동안은 무시됩니다. 같이 serialPersistentFields 또는 serialVersionUID 필드 선언도 무시됩니다. 모든 enum 형은 serialVersionUID가 0L에 고정되고 있습니다.

도입된 버전 :: JDK1. 1
관련 항목:: DataInput, ObjectOutputStream, Serializable, Object Serialization Specification, Section 3, Object Input Classes

중첩(Nested) 클래스 개요
`static class`	`ObjectInputStream.GetField` 입력 스트림로부터 읽힌 지속 필드에의 액세스를 제공합니다.

필드 개요

인터페이스 java.io. ObjectStreamConstants 로부터 상속된 필드
`baseWireHandle, PROTOCOL_VERSION_1, PROTOCOL_VERSION_2, SC_BLOCK_DATA, SC_ENUM, 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_ENUM, TC_EXCEPTION, TC_LONGSTRING, TC_MAX, TC_NULL, TC_OBJECT, TC_PROXYCLASSDESC, TC_REFERENCE, TC_RESET, TC_STRING`

인터페이스 java.io. ObjectStreamConstants 로부터 상속된 필드

baseWireHandle,
 PROTOCOL_VERSION_1,
 PROTOCOL_VERSION_2,
 SC_BLOCK_DATA,
 SC_ENUM,
 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_ENUM,
 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 생성자를 사용해 ObjectOutputStream를 작성한 ObjectOutputStream 신뢰할 수 있는 서브 클래스에 의해 호출합니다.
`short`	`readShort ()` 16 비트의 short를 읽어들입니다.
`protected void`	`readStreamHeader ()` 서브 클래스가 자신의 스트림 헤더의 read와 검증을 실시할 수 있도록 하기 위해서 제공되고 있습니다.
`Object`	`readUnshared ()` ObjectInputStream 로부터 「공유되지 않는다」객체를 읽어들입니다.
`int`	`readUnsignedByte ()` 부호 없음 8 비트 바이트를 읽어들입니다.
`int`	`readUnsignedShort ()` 부호 없음 16 비트의 short를 읽어들입니다.
`String`	`readUTF ()` 수정 UTF-8 형식의 캐릭터 라인을 읽어들입니다.
`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를 작성합니다. 직렬화 스트림 헤더는 스트림로부터 읽힌뒤 검증됩니다. 이 생성자는 대응하는 ObjectOutputStream가 헤더를 출력플래시 할 때까지 블록 합니다.

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

파라미터:: in - 읽을 입력 스트림
예외:: StreamCorruptedException - 스트림 헤더가 부정한 경우; IOException - 스트림 헤더의 read중에 입출력 에러가 발생했을 경우; SecurityException - 신뢰되어 있지 않은 서브 클래스가 보안상 중요한 메서드를 부정하게 오버라이드(override) 했을 경우; NullPointerException - in가 null인 경우
관련 항목:: 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 생성자를 사용해 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가 Throw 된다
readUnshared가 정상적으로 복귀한 다음에 readUnshared가 직렬화 복원한 스트림 핸들에의 역참조를 직렬화 복원하려고 하면, ObjectStreamException가 Throw 된다

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

다만, 복원된 객체가 enum 정수 또는 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을 Throw 합니다.

예외:: 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회 만 호출합니다. 이 메서드는 대체의 로드 도구를 사용하기 위해서 구현할 수 있습니다 만, Class 객체를 돌려줄 필요가 있습니다. 클래스 객체가 돌려주고지면, 그 클래스의 serialVersionUID 가 직렬화 된 클래스의 serialVersionUID 라고 비교됩니다. 불일값이 있으면, 직렬화 복원에 불편이 발생해, 예외가 호출됩니다.

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

파라미터:: desc - ObjectStreamClass 클래스의 인스턴스
반환값:: desc에 대응하는 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가 Throw 된다). Proxy.getProxyClass가 IllegalArgumentException을 Throw 하면, resolveProxyClass는 IllegalArgumentException와 함께 ClassNotFoundException을 Throw 합니다.

파라미터:: 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 - 데이터의 독해처의 버퍼; 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

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

정의:: 인터페이스 Closeable 내의 close
정의:: 인터페이스 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 - 데이터의 독해처의 버퍼
예외:: EOFException - 파일의 마지막에 이르렀을 경우; IOException - 다른 입출력 에러가 발생했을 경우

readFully

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

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

정의:: 인터페이스 DataInput 내의 readFully

파라미터:: buf - 데이터의 독해처의 버퍼; off - 데이터의 개시 오프셋(offset); len - 읽어들이는 최대 바이트수
예외:: EOFException - 파일의 마지막에 이르렀을 경우; IOException - 다른 입출력 에러가 발생했을 경우

skipBytes

public int skipBytes(int len)
              throws IOException

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

정의:: 인터페이스 DataInput 내의 skipBytes

파라미터:: len - 스킵 하는 바이트수
반환값:: 실제로 스킵 된 바이트수
예외:: EOFException - 파일의 마지막에 이르렀을 경우; IOException - 다른 입출력 에러가 발생했을 경우

readLine

@Deprecated 
public String  readLine()
                throws IOException

추천하지 않습니다. 이 메서드는 바이트를 정확하게 문자로 변환하지 않습니다. 상세 및 대체 메서드에 대해서는 DataInputStream를 참조하십시오.

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

정의:: 인터페이스 DataInput 내의 readLine

반환값:: 행의 캐릭터 라인의 카피
예외:: IOException - 기본이 되는 InputStream read중에 입출력 에러가 발생했을 경우

readUTF

public String  readUTF()
               throws IOException

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

정의:: 인터페이스 DataInput 내의 readUTF

반환값:: 캐릭터 라인
예외:: IOException - 기본이 되는 InputStream read중에 입출력 에러가 발생했을 경우; UTFDataFormatException - 캐릭터 라인중의 read 바이트가 유효한 수정 UTF-8 형식에서 encode 된 캐릭터 라인 이외에서 만났을 경우

개요

패키지

클래스

사용

계층 트리

비추천 API

색인

헬프

Java^TM 2 Platform
Standard Ed. 5.0

이전 클래스 다음 클래스

프레임으로 프레임 없이

개요: 상자 | 필드 | constructor | 메서드

상세: 필드 | 생성자 | 메서드

java.io 클래스 ObjectInputStream

ObjectInputStream

ObjectInputStream

readObject

readObjectOverride

readUnshared

defaultReadObject

readFields

registerValidation

resolveClass

resolveProxyClass

resolveObject

enableResolveObject

readStreamHeader

readClassDescriptor

read

read

available

close

readBoolean

readByte

readUnsignedByte

readChar

readShort

readUnsignedShort

readInt

readLong

readFloat

readDouble

readFully

readFully

skipBytes

readLine

readUTF

java.io
클래스 ObjectInputStream