public class PObjectOutputStream extends ObjectOutputStream
writeConditionalObject, which only serializes the specified
object to the stream if there is a strong reference (if it has been written
somewhere else using writeObject()) to that object elsewhere in the stream.
To discover strong references to objects, PObjectOutputStream uses a
two-phase writing process. First, a "discovery" phase is used to find out
what objects are about to be serialized. This works by effectively
serializing the object graph to /dev/null, recording which objects are
unconditionally written using the standard writeObject method. Then, in the
second "write" phase, ObjectOutputStream actually serializes the data to the
output stream. During this phase, calls to writeConditionalObject() will only
write the specified object if the object was found to be serialized during
the discovery stage. If the object was not recorded during the discovery
stage, a an optional null (the default) is unconditionally written in place
of the object. To skip writting out the null use
writeConditionalObject(object, false)
By careful implementation of readObject and writeObject methods, streams serialized using PObjectOutputStream can be deserialized using the standard ObjectInputStream.
ObjectOutputStream.PutFieldbaseWireHandle, 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| Constructor and Description |
|---|
PObjectOutputStream(OutputStream out)
Constructs a PObjectOutputStream that wraps the provided OutputStream.
|
| Modifier and Type | Method and Description |
|---|---|
protected void |
recordUnconditionallyWritten(Object aRoot)
Performs a scan of objects that can be serialized once.
|
void |
reset()
Resets the ObjectOutputStream clearing any memory about objects already
being written while it's at it.
|
static byte[] |
toByteArray(Object object)
Transform the given object into an array of bytes.
|
void |
writeConditionalObject(Object object)
Writes the given object, but only if it was not in the object tree
multiple times.
|
void |
writeObjectTree(Object object)
Writes the provided object to the underlying stream like an ordination
ObjectOutputStream except that it does not record duplicates at all.
|
annotateClass, annotateProxyClass, close, defaultWriteObject, drain, enableReplaceObject, flush, putFields, replaceObject, useProtocolVersion, write, write, write, writeBoolean, writeByte, writeBytes, writeChar, writeChars, writeClassDescriptor, writeDouble, writeFields, writeFloat, writeInt, writeLong, writeObject, writeObjectOverride, writeShort, writeStreamHeader, writeUnshared, writeUTFpublic PObjectOutputStream(OutputStream out) throws IOException
out - underlying outputstream that will receive the serialized
objectsIOException - when underlying subsystem throws onepublic static byte[] toByteArray(Object object) throws IOException
object - the object to be transformedIOException - when serialization system throws onepublic void writeObjectTree(Object object) throws IOException
object - object to be serializedIOException - when underlying subsystem throws onepublic void writeConditionalObject(Object object) throws IOException
object - object to write to the stream.IOException - when underlying subsystem throws onepublic void reset()
throws IOException
reset in class ObjectOutputStreamIOException - when underlying subsystem throws oneprotected void recordUnconditionallyWritten(Object aRoot) throws IOException
aRoot - Object from which to start the scanIOException - when serialization failsCopyright © 1995-2013 Piccolo2D. All Rights Reserved.