java.io
클래스 ObjectOutputStream

java.lang.Object 
  |
  +--java.io.OutputStream 
        |
        +--java.io.ObjectOutputStream

모든 구현 인터페이스:

DataOutput , ObjectOutput , ObjectStreamConstants

public class ObjectOutputStream

extends OutputStream

implements ObjectOutput , ObjectStreamConstants

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

스트림에 기입할 수 있는 것은 java.io.Serializable 인터페이스를 서포트하는 오브젝트만입니다. 각 직렬화 가능 오브젝트의 클래스는 클래스의 이름과 형태, 오브젝트의 필드와 배열, 및 초기 오브젝트로부터 참조되는 것 외의 모든 오브젝트의 크로쟈를 포함해 코드화 됩니다.

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

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

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

예를 들어, ObjectInputStream 의 예로 읽어들일 수 있게 오브젝트를 기입하려면 , 다음과 같이 합니다.

	FileOutputStream ostream = new FileOutputStream("t.tmp");
	ObjectOutputStream p = new ObjectOutputStream(ostream);

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

	p.flush();
	ostream.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 인터페이스를 구현하지 않는 오브젝트의 필드의 기입은 실시하지 않습니다. 직렬화 가능하지 않은 오브젝트의 서브 클래스를 직렬화 가능하게 하는 것은 가능합니다. 이 경우, 직렬화 가능하지 않은 클래스는 그 필드를 초기화할 수 있게 하기 위한(해), 인수 없음의 constructor를 가질 필요가 있습니다. 이 경우, 직렬화 가능하지 않은 클래스 상태를 보존 및 재구축 하는 것은 서브 클래스의 책임이 됩니다. 그 클래스의 필드가 액세스 가능하다 (public, package, 또는 protected)인가, 또는 상태를 재구축 하기 위해서 사용할 수 있는 get 와 set 메소드가 존재하는 경우가 자주 있습니다.

writeObject 와 readObject 메소드로 NotSerializableException 를 슬로우 하도록(듯이) 구현해 두면(자), 오브젝트의 직렬화를 방지할 수 있습니다. 예외는 ObjectOutputStream 에 캐치 되어 직렬화 처리를 이상종료(ABEND) 시킵니다.

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

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

도입된 버젼:

JDK1. 1

관련 항목:

DataOutput , ObjectInputStream , Serializable , Externalizable , 「오브젝트 직렬화 사양의 제 2 장 오브젝트 출력 클래스」

중첩된 클래스의 개요

static class

ObjectOutputStream.PutField ObjectOutput 에 기입해지는 지속 필드에의 프로그램에 의한 액세스를 제공합니다.

필드의 개요

인터페이스 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	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 형식에서 기입합니다.

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

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

생성자의 상세

ObjectOutputStream

public ObjectOutputStream(OutputStream  out)
                   throws IOException 

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

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

파라미터:

out - 기입처의 출력 스트림

예외:

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

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

관련 항목:

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 

스트림의 기입시에 사용하는 스트림 프로토콜의 버젼을 지정합니다.

이 routine는 현재의 버젼의 직렬화가, 전의 버젼의 스트림 형식과 하위 호환성이 있는 형식에서 기입할 수 있게 하는 훅을 제공합니다.

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

파라미터:

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 가 예외를 슬로우 했을 경우

writeObjectOverride

protected void writeObjectOverride(Object  obj)
                            throws IOException 

서브 클래스에 의해 디폴트의 writeObject 메소드의 오버라이드(override)에 사용됩니다. 인수 없음의 protected constructor를 사용해 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 를 슬로우 합니다.

예외:

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 가 예외를 슬로우 했을 경우

annotateProxyClass

protected void annotateProxyClass(Class  cl)
                           throws IOException 

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

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

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

파라미터:

cl - 커스텀 데이터에 주석을 붙이는 프록시 클래스

예외:

IOException - 기본이 되는 OutputStream 가 예외를 슬로우 했을 경우

도입된 버젼:

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 가 예외를 슬로우 했을 경우

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 

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

정의:

인터페이스 ObjectOutput 내의 write

정의:

클래스 OutputStream 내의 write

파라미터:

val - 스트림에 기입해지는 바이트

예외:

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

write

public void write(byte[] buf)
           throws IOException 

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

정의:

인터페이스 ObjectOutput 내의 write

오버라이드(override):

클래스 OutputStream 내의 write

파라미터:

buf - 기입해지는 데이터

예외:

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

write

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

바이트 배열의 일부를 기입합니다.

정의:

인터페이스 ObjectOutput 내의 write

오버라이드(override):

클래스 OutputStream 내의 write

파라미터:

buf - 기입해지는 데이터

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

len - 기입해지는 바이트수

예외:

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

flush

public void flush()
           throws IOException 

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

정의:

인터페이스 ObjectOutput 내의 flush

오버라이드(override):

클래스 OutputStream 내의 flush

예외:

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

drain

protected void drain()
              throws IOException 

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

예외:

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

close

public void close()
           throws IOException 

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

정의:

인터페이스 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 형식에서 기입합니다. 스트림에 String 를 원시적 데이터로서 기입하는 것으로, Object 로서 기입하는 것에는 큰 차이가 있습니다. writeObject 에 의해 기입해지는 String 의 인스턴스는 처음은 String 로서 스트림에 기입해집니다. 그 이후의 writeObject()의 호출은 캐릭터 라인에의 참조를 스트림에 기입합니다.

정의:

인터페이스 DataOutput 내의 writeUTF

파라미터:

str - UTF 형식의 String

예외:

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