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

Deklaration

Beschreibung

Geschachtelte Klassen
public abstract static	ObjectOutputStream.PutField

Konstruktoren
public	ObjectOutputStream(OutputStream out)
protected	ObjectOutputStream()

Methoden
protected void	annotateClass(Class cl)
protected void	annotateProxyClass(Class cl)
public void	close()
public final void	defaultWriteObject()
protected void	drain()
protected final boolean	enableReplaceObject(boolean enable)
public void	flush()
public PutField	putFields()
protected Object	replaceObject(Object obj)
public void	reset()
public void	useProtocolVersion(int version)
public void	write(byte[] b)
public void	write(int data)
public void	write(byte[] b, int off, int len)
public void	writeBoolean(boolean data)
public void	writeByte(int data)
public void	writeBytes(String data)
public void	writeChar(int data)
public void	writeChars(String data)
protected void	writeClassDescriptor(ObjectStreamClass desc)
public void	writeDouble(double data)
public void	writeFields()
public void	writeFloat(float data)
public void	writeInt(int data)
public void	writeLong(long data)
public final void	writeObject(Object obj)
protected void	writeObjectOverride(Object obj)
public void	writeShort(int data)
protected void	writeStreamHeader()
public void	writeUnshared(Object obj)
public void	writeUTF(String data)

Konstruktoren im Detail

public ObjectOutputStream(OutputStream out)

Erzeugt einen neuen ObjectOutputStream auf dem Stream out.

Exception: IOException

protected ObjectOutputStream()     

Dieser Konstruktor kann von Unterklassen benutzt werden, die eine andere Implementierung zum Speichern von Objekten realisieren wollen. Dieser Konstruktor setzt die Berechtigung enableSubclassImplementation voraus, die mit einer SerializablePermission gesetzt werden kann.

Methoden im Detail

protected void annotateClass(Class cl)

Diese Methode wird für jede Klasse bei ihrem ersten Auftreten bei der Serialisierung eines Objekt-Graphen aufgerufen und erlaubt es, eine Klasse durch eine andere zu ersetzen. Das Gegenstück zu dieser Methode ist ObjectInputStream.resolveClass().

Exception: IOException

protected void annotateProxyClass(Class cl)     

Diese Methode wird für jede Proxy-Klasse bei ihrem ersten Auftreten bei der Serialisierung eines Objekt-Graphen aufgerufen und erlaubt es, eine Klasse durch eine andere zu ersetzen. Das Gegenstück zu dieser Methode ist ObjectInputStream.resolveProxyClass().

Exception: IOException

public void close()

Schließt den Stream.

Exception: IOException

• Falls beim Schließen des Streams ein Fehler aufgetreten ist.

public final void defaultWriteObject()

Schreibt ein Objekt gemäß den Regeln des Serializable-Interfaces in den darunterliegenden Stream.

Exception: IOException

protected void drain()     

Schreibt alle noch gepufferten Daten in den darunterliegenden Stream, ohne dessen flush()-Methode aufzurufen.

Exception: IOException

protected final boolean enableReplaceObject(boolean enable)

Diese Methode gestattet es dem Stream in Abhängigkeit vom Parameter enable, bei der Serialisierung ein Objekt durch ein anderes zu ersetzen. Das Ersetzen von Objektreferenzen ist nur gestattet, falls dieser ObjectOutputStream von einem ClassLoader geladen wurde.

Exception: SecurityException

• Falls die Klasse nicht von einem ClassLoader geladen wurde.

public void flush()

Bewirkt, dass noch gepufferte Daten in den Stream geschrieben werden.

Exception: IOException

public PutField putFields()     

Liefert ein PutField-Objekt, in das die Werte der abzuspeichernden Datenelemente eingetragen werden können. Durch Aufruf von writeFields() werden die eingetragenen Werte in den Stream geschrieben.

Exception: IOException

protected Object replaceObject(Object obj)

Diese Methode wird für jedes Objekt, das serialisiert wird, aufgerufen und erlaubt es, anstelle des zu schreibenden Objekts obj ein anderes abzuspeichern. Hierzu muß diese Methode so überschrieben werden, daß sie entweder ein Ersatzobjekt für obj liefert oder obj zurückgibt, falls das Objekt belassen werden soll.

Exception: IOException

public void reset()

Verwirft alle bisher ausgegebenen Daten und versetzt das Stream-Objekt in den Initialzustand. Im darunterliegenden Stream wird eine Marke gesetzt, so daß der ObjectInputStream, der die Daten liest, entsprechend synchronisieren kann. Alle bis zu diesem Zeitpunkt geschriebenen Daten werden erneut in den darunterliegenden Stream ausgegeben.

Exception: IOException

• Falls der Aufruf nicht aus der writeObject()-Methode eines zu serialisierenden Objekts aufgerufen wurde.

public void useProtocolVersion(int version)     

In Version 1.2 wurde das Datenformat der Object Serialization abwärtsinkompatibel geändert. Mit dieser Methode kann der Stream so umgestellt werden, daß er das alte Format benutzt. Für version muß eine der PROTOCOL_VERSION-Konstanten von ObjectStreamConstants übergeben werden.

Exception: IOException

Exception: IllegalStateException

• Falls diese Methode aufgerufen wird, nachdem bereits Objekte geschrieben wurden.

Exception: IllegalArgumentException

• Falls für version ein ungültiger Wert übergeben wird.

public void write(byte[] b)

Schreibt den gesamten Inhalt von b in den Stream.

Exception: IOException

public void write(int data)

Schreibt das niederwertigste Byte von data in den Stream.

Exception: IOException

public void write(byte[] b, int off, int len)

Schreibt len Bytes ab dem Index off aus dem Array b in den Stream.

Exception: IOException

public void writeBoolean(boolean data)

Schreibt den boolean-Wert data in den Stream.

Exception: IOException

public void writeByte(int data)

Schreibt das niederwertigste Byte von data in dem Stream.

Exception: IOException

public void writeBytes(String data)

Schreibt den String data als eine Folge von byte-Werten in den Stream.

Exception: IOException

public void writeChar(int data)

Schreibt die niederwertigen 2 Bytes von data in dem Stream.

Exception: IOException

public void writeChars(String data)

Schreibt den String data als Folge von char-Werten in den Stream.

Exception: IOException

protected void writeClassDescriptor(ObjectStreamClass desc)     

Schreibt den Klassendeskriptor desc in den Stream.

Exception: IOException

public void writeDouble(double data)

Schreibt den double-Wert data in den Stream.

Exception: IOException

public void writeFields()     

Schreibt die Datenelemente des zuletzt abgerufenen PutFields-Objekts in den Stream.

Exception: IOException

public void writeFloat(float data)

Schreibt den float-Wert data in den Stream.

Exception: IOException

public void writeInt(int data)

Schreibt den int-Wert data in den Stream.

Exception: IOException

public void writeLong(long data)

Schreibt den long-Wert data in den Stream.

Exception: IOException

public final void writeObject(Object obj)

Schreibt das Objekt obj in den Stream.

Exception: IOException

• Falls beim Schreiben des Objekts ein Fehler aufgetreten ist.

protected void writeObjectOverride(Object obj)     

Mit dieser Methode kann eine Unterklasse ein eigenes Verfahren zum Speichern von Objekten implementieren. Wenn die Unterklasse in ihrem Konstruktor den parameter-freien Konstruktor dieser Klasse aufruft, wird intern ein Flag gesetzt, durch das die Methode writeObject() automatisch diese Methode aufruft und dann zurückkehrt. Die Neuimplementierung erfolgt durch Überschreiben dieser Methode.

Exception: IOException

• Falls beim Schreiben des Objekts ein Fehler aufgetreten ist.

public void writeShort(int data)

Schreibt den short-Wert data in den Stream.

Exception: IOException

protected void writeStreamHeader()

Schreibt den Header des Objektstreams. Kann überschrieben werden, um ein eigenes Header-Format zu implementieren.

Exception: IOException

public void writeUnshared(Object obj)     

Diese Methode ist im wesentlichen identisch mit writeObject(). Im Gegensatz zu writeObject() wird bei dieser Methode sichergestellt, dass das Objekt von keinen anderen Objekten referenziert wird, die in den Stream geschrieben werden.

public void writeUTF(String data)

Schreibt den String data in den Stream, wobei die Unicode-Zeichen von data mit der UTF-8-Codierung verschlüsselt werden.

Exception: IOException