com.threerings.io

Class ObjectInputStream

java.lang.Object

java.io.InputStream

java.io.FilterInputStream

java.io.DataInputStream

com.threerings.io.ObjectInputStream

All Implemented Interfaces:

Closeable, DataInput, AutoCloseable

Direct Known Subclasses:

ClientObjectInputStream, UnreliableObjectInputStream

public class ObjectInputStream
extends DataInputStream

Used to read Streamable objects from an InputStream. Other common object types are supported as well (@see ObjectOutputStream).

See Also:

Streamable

Constructor Summary

Constructors

Constructor and Description
ObjectInputStream(InputStream source) Constructs an object input stream which will read its data from the supplied source stream.

Method Summary

Modifier and Type	Method and Description
void	addTranslation(String oldname, String newname) Configures this object input stream with a mapping from an old class name to a new one.
void	defaultReadObject() Reads the fields of the specified Streamable instance from the input stream using the default object streaming mechanisms (a call is not made to readObject(), even if such a method exists).
void	readBareObject(Object object) Reads an object from the input stream that was previously written with ObjectOutputStream.writeBareObject(Object).
String	readIntern() Reads a pooled string value from the input stream.
Object	readObject() Reads a Streamable instance or one of the supported object types from the input stream.
String	readUnmodifiedUTF() Read a string encoded as real UTF-8 (rather than the modified format handled by {link #readUTF}).
void	setClassLoader(ClassLoader loader) Customizes the class loader used to instantiate objects read from the input stream.
String	toString()

Methods inherited from class java.io.DataInputStream

read, read, readBoolean, readByte, readChar, readDouble, readFloat, readFully, readFully, readInt, readLine, readLong, readShort, readUnsignedByte, readUnsignedShort, readUTF, readUTF, skipBytes

Methods inherited from class java.io.FilterInputStream

available, close, mark, markSupported, read, reset, skip

Methods inherited from class java.lang.Object

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

Constructor Detail

ObjectInputStream

public ObjectInputStream(InputStream source)

Constructs an object input stream which will read its data from the supplied source stream.

Method Detail

setClassLoader

public void setClassLoader(ClassLoader loader)

Customizes the class loader used to instantiate objects read from the input stream.

addTranslation

public void addTranslation(String oldname,
                           String newname)

Configures this object input stream with a mapping from an old class name to a new one. Serialized instances of the old class name will use the new class name when unserializing.

readObject

public Object readObject()
                  throws IOException,
                         ClassNotFoundException

Reads a Streamable instance or one of the supported object types from the input stream.

Throws:

IOException

ClassNotFoundException

readIntern

public String readIntern()
                  throws IOException

Reads a pooled string value from the input stream.

Throws:

IOException

readBareObject

public void readBareObject(Object object)
                    throws IOException,
                           ClassNotFoundException

Reads an object from the input stream that was previously written with ObjectOutputStream.writeBareObject(Object).

Parameters:

object - the object to be populated from data on the stream. It cannot be null.

Throws:

IOException

ClassNotFoundException

defaultReadObject

public void defaultReadObject()
                       throws IOException,
                              ClassNotFoundException

Reads the fields of the specified Streamable instance from the input stream using the default object streaming mechanisms (a call is not made to readObject(), even if such a method exists).

Throws:

IOException

ClassNotFoundException

readUnmodifiedUTF

public String readUnmodifiedUTF()
                         throws IOException

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

Throws:

IOException

toString

public String toString()

Overrides:

toString in class Object