com.threerings.io

Class ObjectOutputStream

java.lang.Object

java.io.OutputStream

java.io.FilterOutputStream

java.io.DataOutputStream

com.threerings.io.ObjectOutputStream

All Implemented Interfaces:

Closeable, DataOutput, Flushable, AutoCloseable

Direct Known Subclasses:

UnreliableObjectOutputStream

public class ObjectOutputStream
extends DataOutputStream

Used to write Streamable objects to an OutputStream. Other common object types are supported as well: Boolean, Byte, Character, Short, Integer, Long, Float, Double, boolean[], byte[], char[], short[], int[], long[], float[], double[], Object[].

See Also:

Streamable

Constructor Summary

Constructors

Constructor and Description
ObjectOutputStream(OutputStream target) Constructs an object output stream which will write its data to the supplied target stream.

Method Summary

Modifier and Type	Method and Description
void	addTranslation(String className, String streamedName) Configures this object output stream with a mapping from a classname to a streamed name.
void	defaultWriteObject() Uses the default streamable mechanism to write the contents of the object currently being streamed.
void	writeBareObject(Object object) Writes a Streamable instance or one of the support object types without associated class metadata to the output stream.
void	writeIntern(String value) Writes a pooled string value to the output stream.
void	writeObject(Object object) Writes a Streamable instance or one of the support object types to the output stream.
void	writeUnmodifiedUTF(String str) Write a string encoded as real UTF-8 (rather than the modified format handled by {link #writeUTF}).

Methods inherited from class java.io.DataOutputStream

flush, size, write, write, writeBoolean, writeByte, writeBytes, writeChar, writeChars, writeDouble, writeFloat, writeInt, writeLong, writeShort, writeUTF

Methods inherited from class java.io.FilterOutputStream

close, write

Methods inherited from class java.lang.Object

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

Methods inherited from interface java.io.DataOutput

write

Constructor Detail

ObjectOutputStream

public ObjectOutputStream(OutputStream target)

Constructs an object output stream which will write its data to the supplied target stream.

Method Detail

addTranslation

public void addTranslation(String className,
                           String streamedName)

Configures this object output stream with a mapping from a classname to a streamed name.

writeObject

public void writeObject(Object object)
                 throws IOException

Writes a Streamable instance or one of the support object types to the output stream.

Throws:

IOException

writeIntern

public void writeIntern(String value)
                 throws IOException

Writes a pooled string value to the output stream.

Throws:

IOException

writeBareObject

public void writeBareObject(Object object)
                     throws IOException

Writes a Streamable instance or one of the support object types without associated class metadata to the output stream. The caller is responsible for knowing the exact class of the written object, creating an instance of such and calling ObjectInputStream.readBareObject(Object) to read its data from the stream.

Parameters:

object - the object to be written. It cannot be null.

Throws:

IOException

defaultWriteObject

public void defaultWriteObject()
                        throws IOException

Uses the default streamable mechanism to write the contents of the object currently being streamed. This can only be called from within a writeObject implementation in a Streamable object.

Throws:

IOException

writeUnmodifiedUTF

public void writeUnmodifiedUTF(String str)
                        throws IOException

Write a string encoded as real UTF-8 (rather than the modified format handled by {link #writeUTF}).

Throws:

IOException