ObjectOutputStream (Java 2 Platform SE 5.0)

개요

패키지

클래스

사용

계층 트리

비추천 API

색인

헬프

Java^TM 2 Platform
Standard Ed. 5.0

이전 클래스 다음 클래스

프레임으로 프레임 없이

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

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

java.io
클래스 ObjectOutputStream

java.lang.Object 
  java.io.OutputStream 
      java.io.ObjectOutputStream

모든 구현된 인터페이스:: Closeable, DataOutput, Flushable, ObjectOutput, ObjectStreamConstants

public class ObjectOutputStream
extends OutputStream
implements ObjectOutput, ObjectStreamConstants
extends OutputStream
implements ObjectOutput, ObjectStreamConstants

Java 기본 데이터형과 객체 그래프를 OutputStream에 출력합니다. 이러한 객체를 읽어들이려면 (재구축 하기) ObjectInputStream를 사용합니다. 객체의 지속적 기억은 그 스트림을 위한 파일을 사용하면 가능합니다. 스트림이 네트워크 소켓 스트림의 경우는 다른 호스트나 다른 프로세스상에서 객체를 재구축 할 수도 있습니다.

스트림에 출력할 수 있는 것은 java.io.Serializable 인터페이스를 지원하는 객체만입니다. 각 직렬화 가능 객체의 클래스는 클래스의 이름과 시그니쳐, 객체의 필드값와 배열 및 초기 객체로부터 참조되는 것 외의 모든 객체의 크로쟈를 포함해 encode 됩니다.

객체를 스트림에 출력하려면 writeObject 메서드를 사용합니다. String 나 배열을 포함한 임의의 객체가 writeObject에 의해 출력해집니다. 복수의 객체나 원시적도, 스트림에의 출력이 가능합니다. 객체를 읽어들일 때는 대응하는 ObjectInputstream 로부터 같은 형태로서 한편 출력해졌을 때와 같은 순서로 읽어들이지 않으면 안됩니다.

기본 데이터형을 스트림에 출력하려면, DataOutput 적절한 메서드를 사용합니다. String를 출력하는 경우는 writeUTF 메서드를 사용합니다.

객체의 디폴트의 직렬화 도구는 클래스의 객체, 클래스의 시그니쳐 및 모든 비 transient와 비 static 필드가 가지는 값을 출력합니다. 다른 객체에의 참조 (transient와 static 필드는 제외하다)가 있으면, 이러한 객체도 역시 출력해집니다. 단일 객체에의 다중 참조는 참조 공유 도구에 의해 encode 되어 객체 그래프를, 오리지날이 출력해졌을 때의 형상에 복원할 수 있습니다 .

예를 들어 ObjectInputStream 예로 읽어들일 수 있도록 객체를 출력하려면, 다음과 같이 합니다.


        FileOutputStream fos = new FileOutputStream("t.tmp");
        ObjectOutputStream oos = new ObjectOutputStream(fos);

        oos.writeInt(12345);
        oos.writeObject("Today");
        oos.writeObject(new Date());

        oos.close();

직렬화와 직렬화 복원 시에 특수한 취급이 필요한 클래스에서는 정확하게 다음과 같은 시그니쳐를 가지는 특수한 메서드를 구현할 필요가 있습니다.


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

writeObject 메서드는 대응하는 readObject가 객체 상태를 복원할 수가 있도록, 객체의 특정의 클래스에 도착해, 객체 상태를 출력할 책임이 있습니다. 이 메서드는 객체의 슈퍼 클래스나 서브 클래스에 속하는 상태에 관여할 필요는 없습니다. 상태를 보존하려면, 개개의 필드에 도착해 writeObject 메서드를 사용해 ObjectOutputStream에 출력하는지, 또는 DataOutput가 지원하는 기본 데이터형용의 메서드를 사용합니다.

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

writeObject와 readObject 메서드로 NotSerializableException을 Throw 하도록 구현해 두면, 객체의 직렬화를 방지할 수 있습니다. 예외는 ObjectOutputStream에 캐치 되어 직렬화 처리를 이상종료(ABEND) 시킵니다.

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

enum 정수는 보통 의 직렬화 가능 객체나 외부화 가능 객체와는 다른 방법으로 직렬화 됩니다. enum 정수의 직렬화 형식은 이름만으로 구성됩니다. 정수의 필드값는 전송 되지 않습니다. enum 정수를 직렬화하기 위해서 ObjectOutputStream는 정수의 이름 메서드로부터 리턴된 캐릭터 라인을 출력합니다. 다른 직렬화 가능 객체 또는 외부화 가능 객체와 같이, enum 정수도, 직렬화 스트림에 나중에 나타나는 역참조의 타겟으로서 기능할 수 있습니다. enum 정수가 직렬화 되는 순서는 커스터마이즈 할 수 없습니다. 즉, enum 형에 의해 정의된, 클래스 특유의 writeObject 및 writeReplace 메서드는 직렬화의 사이는 무시됩니다. 같이 serialPersistentFields 또는 serialVersionUID 필드 선언도 무시됩니다. 모든 enum 형은 serialVersionUID가 0L에 고정되고 있습니다.

직렬화 가능 필드 및 외부화 가능 데이터를 제외한 원시적 데이터는 블록 데이터 레코드로서 ObjectOutputStream에 출력해집니다. 블록 데이터 레코드는 헤더와 데이터로 구성됩니다. 블록 데이터의 헤더는 마커 및 헤더에 계속되는 바이트수로 구성됩니다. 연속하는 원시적 데이터의 출력은 1개의 블록 데이터 레코드에 머지 됩니다. 블록 데이터 레코드에 사용되는 블록 계수는 1024 바이트입니다. 각 블록 데이터 레코드는 1024 바이트까지 파묻히는지, 블록 데이터 모드의 종료까지 출력해집니다. ObjectOutputStream 메서드 writeObject, defaultWriteObject 및 writeFields를 호출하면, 최초로 기존의 블록 데이터 레코드가 종료됩니다.

도입된 버전 :: JDK1. 1
관련 항목:: DataOutput, ObjectInputStream, Serializable, Externalizable, Object Serialization Specification, Section 2, Object Output Classes

중첩(Nested) 클래스 개요
`static class`	`ObjectOutputStream.PutField` ObjectOutput에 출력해지는 지속 필드에의 프로그램에 한 액세스를 제공합니다.

필드 개요

인터페이스 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`	`ObjectOutputStream ()` ObjectOutputStream를 완전하게 다시 구현하는 서브 클래스가 ObjectOutputStream 이 구현에 의해 사용된지 얼마 안된 private 데이터를 할당할 필요가 없게 하는 수단을 제공합니다.
	`ObjectOutputStream (OutputStream out)` 지정된 OutputStream에 출력하는 ObjectOutputStream를 작성합니다.

메서드 개요
`protected void`	`annotateClass (Class <? > cl)` 서브 클래스는 클래스의 데이터를 스트림에 보존할 수 있도록 이 메서드를 구현하는 경우가 있습니다.
`protected void`	`annotateProxyClass (Class <? > cl)` 서브 클래스는 이 메서드를 구현해, 다이나믹 프록시 클래스에 대한 기술자와 함께 커스텀 데이터를 스트림에 포함합니다.
`void`	`close ()` 스트림을 닫습니다.
`void`	`defaultWriteObject ()` 현재의 클래스의 비 static 필드와 비 transient 필드를, 스트림에 출력합니다.
`protected void`	`drain ()` ObjectOutputStream에 있는 버퍼 데이터를 모두 비웁니다.
`protected boolean`	`enableReplaceObject (boolean enable)` 스트림내에서 객체를 치환할 수 있도록 합니다.
`void`	`flush ()` 스트림을 플래시 합니다.
`ObjectOutputStream.PutField`	`putFields ()` 스트림에 출력해지는 지속 필드를 버퍼에 포함하기 위해서 사용되는 객체를 취득합니다.
`protected Object`	`replaceObject (Object obj)` 직렬화 시에 ObjectOutputStream 신뢰할 수 있는 서브 클래스가 어느 객체를 다른 객체에 치환할 수 있도록 합니다.
`void`	`reset ()` 스트림에 이미 출력해지고 있는 객체 상태를 무효로 합니다.
`void`	`useProtocolVersion (int version)` 스트림의 출력시에 사용하는 스트림 프로토콜의 버전을 지정합니다.
`void`	`write (byte[] buf)` 바이트 배열을 출력합니다.
`void`	`write (byte[] buf, int off, int len)` 바이트 배열의 일부를 출력합니다.
`void`	`write (int val)` 데이터의 바이트를 출력합니다.
`void`	`writeBoolean (boolean val)` boolean를 출력합니다.
`void`	`writeByte (int val)` 8 비트의 바이트를 출력합니다.
`void`	`writeBytes (String str)` String를 바이트의 열로서 출력합니다.
`void`	`writeChar (int val)` 16 비트의 char를 출력합니다.
`void`	`writeChars (String str)` String를 char 열로서 출력합니다.
`protected void`	`writeClassDescriptor (ObjectStreamClass desc)` ObjectOutputStream 로 지정된 클래스 기술자를 출력합니다.
`void`	`writeDouble (double val)` 64 비트의 double를 출력합니다.
`void`	`writeFields ()` 버퍼에 포함된 필드를 스트림에 출력합니다.
`void`	`writeFloat (float val)` 32 비트의 float를 출력합니다.
`void`	`writeInt (int val)` 32 비트의 int를 출력합니다.
`void`	`writeLong (long val)` 64 비트의 long를 출력합니다.
`void`	`writeObject (Object obj)` 지정된 객체를 ObjectOutputStream에 출력합니다.
`protected void`	`writeObjectOverride (Object obj)` 서브 클래스에 의해 디폴트의 writeObject 메서드의 오버라이드(override)에 사용됩니다.
`void`	`writeShort (int val)` 16 비트의 short를 출력합니다.
`protected void`	`writeStreamHeader ()` 서브 클래스가 자신의 헤더를 스트림의 전 또는 뒤로 추가할 수 있도록 제공되고 있습니다.
`void`	`writeUnshared (Object obj)` ObjectOutputStream에 「공유되지 않는다」객체를 출력합니다.
`void`	`writeUTF (String str)` 이 String 원시적 데이터를수정 UTF-8 형식에서 출력합니다.

클래스 java.lang. Object 로부터 상속된 메서드
`clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait`

생성자 상세

ObjectOutputStream

public ObjectOutputStream(OutputStream  out)
                   throws IOException

지정된 OutputStream에 출력하는 ObjectOutputStream를 작성합니다. 이 생성자는 직렬화 스트림 헤더를 기본으로 되는 스트림에 출력합니다. 이 스트림은 호출해 옆에서 즉시 플래시의해 주세요. ObjectInputStreams를 받은 생성자는 헤더를 읽어들일 때 블록 하기 때문에입니다.

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

파라미터:: out - 출력처의 출력 스트림
예외:: IOException - 스트림 헤더의 출력중에 입출력 에러가 발생했을 경우; SecurityException - 신뢰되어 있지 않은 서브 클래스가 보안상 중요한 메서드를 부정하게 오버라이드(override) 했을 경우; NullPointerException - out이 null인 경우
관련 항목:: ObjectOutputStream(), putFields(), ObjectInputStream.ObjectInputStream(InputStream)

ObjectOutputStream

protected ObjectOutputStream()
                      throws IOException,

                             SecurityException

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

시큐러티 매니저가 인스톨 되고 있는 경우, 이 메서드는 우선 시큐러티 매니저의 checkPermission 메서드를 접근 권한 SerializablePermission("enableSubclassImplementation")로 호출해, 상속 유효하게 할 수 있도록 합니다.

예외:: SecurityException - 시큐러티 매니저가 존재해, 그 checkPermission 메서드가 상속 유효하게 하는 것을 거부했을 경우; IOException
관련 항목:: SecurityManager.checkPermission(java.security.Permission), SerializablePermission

메서드의 상세

useProtocolVersion

public void useProtocolVersion(int version)
                        throws IOException

스트림의 출력시에 사용하는 스트림 프로토콜의 버전을 지정합니다.

이 루틴은 현재의 버전의 직렬화가 전의 버전의 스트림 형식과 하위 호환성이 있는 형식에서 출력할 수 있도록 하는 훅을 제공합니다.

하위 호환성이 없는 형식이 또한 도입되는 것을 막기 위해서 모든 노력을 합니다만, 선택의 여지가 없는 경우도 있습니다.

파라미터:: version - java.io.ObjectStreamConstants 로부터 ProtocolVersion를 사용
예외:: IllegalStateException - 객체가 직렬화 된 뒤에 불려 갔을 경우; IllegalArgumentException - 건네받은 버전이 무효인 경우; IOException - 입출력 에러가 발생했을 경우
도입된 버전 :: 1.2
관련 항목:: ObjectStreamConstants.PROTOCOL_VERSION_1, ObjectStreamConstants.PROTOCOL_VERSION_2

writeObject

public final void writeObject(Object  obj)
                       throws IOException

지정된 객체를 ObjectOutputStream에 출력합니다. 객체의 클래스, 클래스의 시그니쳐, 클래스의 비 transient 및 비 static 필드와 그 슈퍼 클래스의 모든 값이 출력해집니다. 어느 클래스에 도착해 디폴트의 직렬화는 writeObject와 readObject 메서드를 사용해 오버라이드(override) 할 수 있습니다 . 이 객체에 의해 참조되는 객체는 중간적으로 출력해져 거기에 따라, 객체의 완전하게 동등한 그래프가 ObjectInputStream 에 해를 재구축 됩니다.

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

정의:: 인터페이스 ObjectOutput 내의 writeObject

파라미터:: obj - 출력해지는 객체
예외:: InvalidClassException - 직렬화로 사용되는 클래스에 하등의 불편이 있었을 경우; NotSerializableException - 직렬화의 대상 객체가 java.io.Serializable 인터페이스를 구현하고 있지 않는 경우; IOException - 기본이 되는 OutputStream가 예외를 Throw 했을 경우

writeObjectOverride

protected void writeObjectOverride(Object  obj)
                            throws IOException

서브 클래스에 의해 디폴트의 writeObject 메서드의 오버라이드(override)에 사용됩니다. 인수 없음의 protected 생성자를 사용해 ObjectInputStream를 작성한 ObjectInputStream 신뢰할 수 있는 서브 클래스에 의해 호출합니다. 서브 클래스는 수식자가 final 오버라이드(override) 메서드를 제공한다고 보여집니다.

파라미터:: obj - 기본이 되는 스트림에 출력해지는 객체
예외:: IOException - 기본이 되는 스트림의 출력중에 입출력 에러가 발생했을 경우
도입된 버전 :: 1.2
관련 항목:: ObjectOutputStream(), writeObject(Object)

writeUnshared

public void writeUnshared(Object  obj)
                   throws IOException

ObjectOutputStream에 「공유되지 않는다」객체를 출력합니다. 이 메서드는 writeObject와 닮아 있습니다. 다만, 직렬화 된 인스턴스를 가리키는 역참조로서가 아니고, 스트림내에서 일의의 새로운 객체로서 출력합니다. 예를 들어 구체적으로 다음과 같이 됩니다.

writeUnshared를 사용해 출력해진 객체는 그 객체가 스트림에 출력해지고 있는지 어떤지에 관계없이, 새롭게 출력해진 객체 (스트림에 출력해지지 않은 객체)로서 직렬화 된다
writeUnshared 로 이미 출력해지고 있는 객체를 writeObject를 사용해 출력했을 경우, 전의 writeUnshared 조작에 의해 출력해진 객체와 관련성을 가지지 않는 객체라고 보여진다. 즉, ObjectOutputStream는 writeUnshared 호출에 의해 출력해진 객체 데이터에 대해서 역참조를 생성할 것은 없다

writeUnshared를 사용해 출력한 객체를 직렬화 복원했을 때에 그 객체에의 참조가 일의이다고는 할 수 없습니다. writeUnshared 에서는 1개의 객체를 스트림내에 여러 차례 정의할 수 있기 때문에 수신측으로부터 readUnshared를 여러 차례 호출해도 중복은 발생하지 않습니다. 이 규칙은 writeUnshared를 사용해 출력해진 베이스 레벨의 객체에만 적용됩니다. 직렬화하는 객체 그래프내에서 참조되는 서브 객체에는 적용되지 않습니다.

이 메서드를 오버라이드(override) 하는 ObjectOutputStream 서브 클래스는 SerializablePermission("enableSubclassImplementation")를 가지는 시큐러티 컨텍스트 내에서만 구축할 수 있습니다. 이 접근 권한을 가지지 않는 시큐러티 컨텍스트 으로 인스턴스화하려고 하면, SecurityException가 발생 됩니다.

파라미터:: obj - 스트림에 출력하는 객체
예외:: NotSerializableException - 직렬화하는 그래프내의 객체가 Serializable 인터페이스를 구현하지 않는 경우; InvalidClassException - 직렬화하는 객체의 클래스에 문제가 있는 경우; IOException - 직렬화중에 입출력 에러가 발생했을 경우

defaultWriteObject

public void defaultWriteObject()
                        throws IOException

현재의 클래스의 비 static 필드와 비 transient 필드를, 스트림에 출력합니다. 이 메서드를 호출할 수 있는 것은 직렬화를 하고 있는 클래스의 writeObject 메서드 뿐입니다. 다른 방법으로 불려 갔을 경우는 NotActiveException을 Throw 합니다.

예외:: IOException - 기본이 되는 OutputStream 출력중에 입출력 에러가 발생했을 경우

putFields

public ObjectOutputStream.PutField  putFields()
                                      throws IOException

스트림에 출력해지는 지속 필드를 버퍼에 포함하기 위해서 사용되는 객체를 취득합니다. 필드는 writeFields 메서드가 불려 갔을 때에 스트림에 출력해집니다.

반환값:: 직렬화 가능 필드를 보관 유지하고 있는 클래스 Putfield 인스턴스
예외:: IOException - 입출력 에러가 발생했을 경우
도입된 버전 :: 1.2

writeFields

public void writeFields()
                 throws IOException

버퍼에 포함된 필드를 스트림에 출력합니다.

예외:: IOException - 기본이 되는 스트림의 출력중에 입출력 에러가 발생했을 경우; NotActiveException - 객체 상태를 출력하기 위해서 클래스의 writeObject 메서드가 불려가 지 않았을 때에 불려 갔을 경우
도입된 버전 :: 1.2

reset

public void reset()
           throws IOException

스트림에 이미 출력해지고 있는 객체 상태를 무효로 합니다. 상태는 새로운 ObjectOutputStream 작성시와 같게 리셋 됩니다. 스트림의 현재 위치에 마크가 설정되어 대응하는 ObjectInputStream도 같은 위치에 리셋 됩니다. 그 이전에 스트림에 출력해지고 있던 객체는 스트림상에 있다고는 보여지지 않고, 재차 스트림에 출력해집니다.

예외:: IOException - 객체를 직렬화중에 reset()가 불려 갔을 경우

annotateClass

protected void annotateClass(Class <? > cl)
                      throws IOException

서브 클래스는 클래스의 데이터를 스트림에 보존할 수 있도록 이 메서드를 구현하는 경우가 있습니다. 디폴트에서는 이 메서드는 아무것도 실시하지 않습니다. ObjectInputStream 대응하는 메서드는 resolveClass 입니다. 이 메서드는 스트림의 일의의 클래스 각각 붙어 1회 만 호출합니다. 그 시점에서 클래스명과 시그니쳐는 이미 스트림에 출력해지고 있습니다. 이 메서드는 ObjectOutputStream를 자유롭게 사용해, 적당이라고 판단된다면 클래스의 임의의 표현 (예를 들어 클래스 파일의 바이트)을 보존할 수 있습니다. ObjectInputStream 대응하는 서브 클래스의 resolveClass 메서드는 annotateClass에 의해 출력해진 데이터나 객체를 읽기, 사용하지 않으면 안됩니다.

파라미터:: cl - 커스텀 데이터에 주석을 붙이는 클래스
예외:: IOException - 기본이 되는 OutputStream가 예외를 Throw 했을 경우

annotateProxyClass

protected void annotateProxyClass(Class <? > cl)
                           throws IOException

서브 클래스는 이 메서드를 구현해, 다이나믹 프록시 클래스에 대한 기술자와 함께 커스텀 데이터를 스트림에 포함합니다.

이 메서드는 스트림의 일의의 프록시 클래스 기술자의 각각 붙어 1회 만 호출합니다. ObjectOutputStream에 있는 이 메서드의 디폴트 구현은 아무것도 하지 않습니다.

ObjectInputStream에 서의 대응하는 메서드는 resolveProxyClass 입니다. 이 메서드를 오버라이드(override) 하는 지정된 서브 클래스 ObjectOutputStream에 대해서 ObjectInputStream 대응하는 서브 클래스에 있는 resolveProxyClass 메서드는 annotateProxyClass가 출력하는 임의의 데이터 또는 객체를 읽어들일 필요가 있습니다.

파라미터:: cl - 커스텀 데이터에 주석을 붙이는 프록시 클래스
예외:: IOException - 기본이 되는 OutputStream가 예외를 Throw 했을 경우
도입된 버전 :: 1.3
관련 항목:: ObjectInputStream.resolveProxyClass(String[])

replaceObject

protected Object  replaceObject(Object  obj)
                        throws IOException

직렬화 시에 ObjectOutputStream 신뢰할 수 있는 서브 클래스가 어느 객체를 다른 객체에 치환할 수 있도록 합니다. 객체의 치환은 enableReplaceObject가 불려 갈 때까지는 실시할 수 없습니다. enableReplaceObject 메서드는 치환을 요구하고 있는 스트림을 신뢰할 수 있을지 어떨지를 조사합니다. 직렬화 스트림에 출력해지는 각 객체의 쳐 최초로 출현한 것은 replaceObject 에게 건네집니다. 객체의 private 인 상태가 도하지 않고 누설 하는 것이 없게, replaceObject를 사용하는 것은 신뢰할 수 있는 스트림로 한정됩니다.

ObjectOutputStream.writeObject 메서드는 Object 형의 파라미터 (Serializable 형과는 다르다)를 취해, 직렬화 가능하지 않은 객체가 직렬화 가능 객체로 옮겨지도록 합니다.

서브 클래스는 객체를 치환할 때, 직렬화 복원 실행시에 상보적으로 치환을 하는지, 또는 치환된 객체와 참조가 포함되는 각 필드와의 호환성을 보증할 필요가 있습니다. 필드 또는 배열 요소의 형태의 서브 클래스가 아닌 형태의 객체는 예외를 발생시키는 것에 의해 직렬화를 중단해, 그 결과 객체는 포함되지 않습니다.

이 메서드는 각 객체가 최초로 검출되었을 때에 1회 만 호출합니다. 이것 이후 검출되는 그 객체에의 참조는 새로운 객체에 리다이렉트 됩니다. 이 메서드는 치환되는 메서드인가 또는 오리지날의 어느 쪽인지를 돌려주지 않으면 안됩니다.

치환되는 객체로서 null을 돌려줄 수도 있습니다만, 오리지날 객체에의 참조를 포함한 클래스에서는 null은 아니고 객체가 리턴된 것을 가정하고 있는 것이 있어, 이 경우는 NullReferenceException가 발생 됩니다.

파라미터:: obj - 옮겨놓을 수 있는 객체
반환값:: 지정된 객체와 옮겨놓을 수 있었던 대체 객체
예외:: IOException - 기본이 되는 OutputStream가 예외를 Throw 했을 경우

enableReplaceObject

protected boolean enableReplaceObject(boolean enable)
                               throws SecurityException

스트림내에서 객체를 치환할 수 있도록 합니다. 치환이 가능하게 되면, 직렬화 되는 각 객체에 대해 replaceObject 메서드가 호출됩니다.

enable가 true 로 시큐러티 매니저가 인스톨 되고 있는 경우, 이 메서드는 우선 시큐러티 매니저의 checkPermission 메서드를 접근 권한 SerializablePermission("enableSubstitution")로 호출해, 스트림의 객체를 스트림을 치환할 수 있도록 합니다.

파라미터:: enable - 객체의 치환을 가능하게 하는 boolean 파라미터
반환값:: 이 메서드가 불려가기 전의 설정
예외:: SecurityException - 시큐러티 매니저가 존재해, 그 checkPermission 메서드가 스트림내의 객체의 스트림에 한 치환을 허가하지 않았던 경우
관련 항목:: SecurityManager.checkPermission(java.security.Permission), SerializablePermission

writeStreamHeader

protected void writeStreamHeader()
                          throws IOException

서브 클래스가 자신의 헤더를 스트림의 전 또는 뒤로 추가할 수 있도록 제공되고 있습니다. 이 메서드는 매직 번호와 버전 정보를 스트림에 출력합니다.

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

writeClassDescriptor

protected void writeClassDescriptor(ObjectStreamClass  desc)
                             throws IOException

ObjectOutputStream 로 지정된 클래스 기술자를 출력합니다. 클래스 기술자는 스트림에 출력해진 객체의 클래스를 식별할 때에 사용합니다. ObjectOutputStream 서브 클래스는 이 메서드에 오버라이드(override) 해, 클래스 기술자가 직렬화 스트림에 출력하는 방법을 커스터마이즈 합니다. ObjectInputStream 내의 대응하는 메서드 readClassDescriptor 은 오버라이드(override) 되고 클래스 기술자를 커스텀 스트림 표현으로부터 복원할 필요가 있습니다. 디폴트에서는 이 메서드는 객체 직렬화 사양으로 정의된 형식에 따라 클래스 기술자를 출력합니다.

이 메서드는 ObjectOutputStream가 낡은 직렬화 스트림 형식 (ObjectOutputStream useProtocolVersion 메서드를 호출해 설정)을 사용하고 있지 않는 경우에 한정해 호출되는 점에 주의해 주세요. 이 직렬화 스트림이 낡은 형식 (PROTOCOL_VERSION_1)을 사용하고 있는 경우, 클래스 기술자는 오버라이드(override) 되지 않는 방법 또는 커스터마이즈 할 수 없는 방법으로 내부적으로 출력해집니다.

파라미터:: desc - 스트림에 출력하는 클래스 기술자
예외:: IOException - 입출력 에러가 발생했을 경우
도입된 버전 :: 1.3
관련 항목:: ObjectInputStream.readClassDescriptor(), useProtocolVersion(int), ObjectStreamConstants.PROTOCOL_VERSION_1

write

public void write(int val)
           throws IOException

데이터의 바이트를 출력합니다. 이 메서드는 데이터가 실제로 출력해질 때까지 블록 합니다.

정의:: 인터페이스 DataOutput 내의 write
정의:: 인터페이스 ObjectOutput 내의 write
정의:: 클래스 OutputStream 내의 write

파라미터:: val - 스트림에 출력해지는 바이트
예외:: IOException - 입출력 에러가 발생했을 경우

write

public void write(byte[] buf)
           throws IOException

바이트 배열을 출력합니다. 이 메서드는 데이터가 실제로 출력해질 때까지 블록 합니다.

정의:: 인터페이스 DataOutput 내의 write
정의:: 인터페이스 ObjectOutput 내의 write
오버라이드(override):: 클래스 OutputStream 내의 write

파라미터:: buf - 출력해지는 데이터
예외:: IOException - 입출력 에러가 발생했을 경우
관련 항목:: OutputStream.write(byte[], int, int)

write

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

바이트 배열의 일부를 출력합니다.

정의:: 인터페이스 DataOutput 내의 write
정의:: 인터페이스 ObjectOutput 내의 write
오버라이드(override):: 클래스 OutputStream 내의 write

파라미터:: buf - 출력해지는 데이터; off - 데이터의 개시 오프셋(offset); len - 출력해지는 바이트수
예외:: IOException - 입출력 에러가 발생했을 경우

flush

public void flush()
           throws IOException

스트림을 플래시 합니다. 이 메서드는 버퍼링 떠날 수 있어 모든 출력 바이트를 출력해, 기본이 되는 스트림을 통해 플래시 합니다.

정의:: 인터페이스 Flushable 내의 flush
정의:: 인터페이스 ObjectOutput 내의 flush
오버라이드(override):: 클래스 OutputStream 내의 flush

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

drain

protected void drain()
              throws IOException

ObjectOutputStream에 있는 버퍼 데이터를 모두 비웁니다. flush와 닮은 동작입니다만, 이 메서드에서는 기본이 되는 스트림의 flush는 일어나지 않습니다.

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

close

public void close()
           throws IOException

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

정의:: 인터페이스 Closeable 내의 close
정의:: 인터페이스 ObjectOutput 내의 close
오버라이드(override):: 클래스 OutputStream 내의 close

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

writeBoolean

public void writeBoolean(boolean val)
                  throws IOException

boolean를 출력합니다.

정의:: 인터페이스 DataOutput 내의 writeBoolean

파라미터:: val - 출력해지는 boolean 치
예외:: IOException - 기본이 되는 스트림의 출력중에 입출력 에러가 발생했을 경우

writeByte

public void writeByte(int val)
               throws IOException

8 비트의 바이트를 출력합니다.

정의:: 인터페이스 DataOutput 내의 writeByte

파라미터:: val - 출력해지는 바이트값
예외:: IOException - 기본이 되는 스트림의 출력중에 입출력 에러가 발생했을 경우

writeShort

public void writeShort(int val)
                throws IOException

16 비트의 short를 출력합니다.

정의:: 인터페이스 DataOutput 내의 writeShort

파라미터:: val - 출력해지는 short값
예외:: IOException - 기본이 되는 스트림의 출력중에 입출력 에러가 발생했을 경우

writeChar

public void writeChar(int val)
               throws IOException

16 비트의 char를 출력합니다.

정의:: 인터페이스 DataOutput 내의 writeChar

파라미터:: val - 출력해지는 char값
예외:: IOException - 기본이 되는 스트림의 출력중에 입출력 에러가 발생했을 경우

writeInt

public void writeInt(int val)
              throws IOException

32 비트의 int를 출력합니다.

정의:: 인터페이스 DataOutput 내의 writeInt

파라미터:: val - 출력해지는 int값
예외:: IOException - 기본이 되는 스트림의 출력중에 입출력 에러가 발생했을 경우

writeLong

public void writeLong(long val)
               throws IOException

64 비트의 long를 출력합니다.

정의:: 인터페이스 DataOutput 내의 writeLong

파라미터:: val - 출력해지는 long값
예외:: IOException - 기본이 되는 스트림의 출력중에 입출력 에러가 발생했을 경우

writeFloat

public void writeFloat(float val)
                throws IOException

32 비트의 float를 출력합니다.

정의:: 인터페이스 DataOutput 내의 writeFloat

파라미터:: val - 출력해지는 float값
예외:: IOException - 기본이 되는 스트림의 출력중에 입출력 에러가 발생했을 경우

writeDouble

public void writeDouble(double val)
                 throws IOException

64 비트의 double를 출력합니다.

정의:: 인터페이스 DataOutput 내의 writeDouble

파라미터:: val - 출력해지는 double값
예외:: IOException - 기본이 되는 스트림의 출력중에 입출력 에러가 발생했을 경우

writeBytes

public void writeBytes(String  str)
                throws IOException

String를 바이트의 열로서 출력합니다.

정의:: 인터페이스 DataOutput 내의 writeBytes

파라미터:: str - 출력해지는 바이트의 캐릭터 라인
예외:: IOException - 기본이 되는 스트림의 출력중에 입출력 에러가 발생했을 경우

writeChars

public void writeChars(String  str)
                throws IOException

String를 char 열로서 출력합니다.

정의:: 인터페이스 DataOutput 내의 writeChars

파라미터:: str - 출력해지는 char 캐릭터 라인
예외:: IOException - 기본이 되는 스트림의 출력중에 입출력 에러가 발생했을 경우

writeUTF

public void writeUTF(String  str)
              throws IOException

이 String 원시적 데이터를수정 UTF-8 형식에서 출력합니다. 스트림에 String를 원시적 데이터로서 출력하는 것으로 Object 로서 출력하는 것에는 큰 차이가 있습니다. writeObject에 의해 출력해지는 String 인스턴스는 처음은 String 로서 스트림에 출력해집니다. 그 이후의 writeObject()의 호출은 캐릭터 라인에의 참조를 스트림에 출력합니다.

정의:: 인터페이스 DataOutput 내의 writeUTF

파라미터:: str - 출력해지는 캐릭터 라인
예외:: IOException - 기본이 되는 스트림의 출력중에 입출력 에러가 발생했을 경우

개요

패키지

클래스

사용

계층 트리

비추천 API

색인

헬프

Java^TM 2 Platform
Standard Ed. 5.0

이전 클래스 다음 클래스

프레임으로 프레임 없이

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

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

java.io 클래스 ObjectOutputStream

ObjectOutputStream

ObjectOutputStream

useProtocolVersion

writeObject

writeObjectOverride

writeUnshared

defaultWriteObject

putFields

writeFields

reset

annotateClass

annotateProxyClass

replaceObject

enableReplaceObject

writeStreamHeader

writeClassDescriptor

write

write

write

flush

drain

close

writeBoolean

writeByte

writeShort

writeChar

writeInt

writeLong

writeFloat

writeDouble

writeBytes

writeChars

writeUTF

java.io
클래스 ObjectOutputStream