MarshalOutputStream

Class Overview

A MarshalOutputStream extends ObjectOutputStream to add functions specific to marshaling of remote object references. If it is necessary to serialize remote objects or objects that contain references to remote objects a MarshalOutputStream must be used instead of ObjectOutputStream.

A new MarshalOutputStream is constructed to serialize remote objects or graphs containing remote objects. Objects are written to the stream using the ObjectOutputStream.writeObject method.

MarshalOutputStream maps remote objects to the corresponding remote stub and embeds the location from which to load the stub classes. The location may be ignored by the client but is supplied.

Summary

[Expand] Inherited Constants

From interface java.io.ObjectStreamConstants int PROTOCOL_VERSION_1 A Stream Protocol Version. int PROTOCOL_VERSION_2 A Stream Protocol Version. byte SC_BLOCK_DATA Bit mask for ObjectStreamClass flag. byte SC_ENUM Bit mask for ObjectStreamClass flag. byte SC_EXTERNALIZABLE Bit mask for ObjectStreamClass flag. byte SC_SERIALIZABLE Bit mask for ObjectStreamClass flag. byte SC_WRITE_METHOD Bit mask for ObjectStreamClass flag. short STREAM_MAGIC Magic number that is written to the stream header. short STREAM_VERSION Version number that is written to the stream header. byte TC_ARRAY new Array. byte TC_BASE First tag value. byte TC_BLOCKDATA Block of optional data. byte TC_BLOCKDATALONG long Block data. byte TC_CLASS Reference to Class. byte TC_CLASSDESC new Class Descriptor. byte TC_ENDBLOCKDATA End of optional block data blocks for an object. byte TC_ENUM new Enum constant. byte TC_EXCEPTION Exception during write. byte TC_LONGSTRING Long string. byte TC_MAX Last tag value. byte TC_NULL Null object reference. byte TC_OBJECT new Object. byte TC_PROXYCLASSDESC new Proxy Class Descriptor. byte TC_REFERENCE Reference to an object already written into the stream. byte TC_RESET Reset stream context. byte TC_STRING new String. int baseWireHandle First wire handle to be assigned.

[Expand] Inherited Fields
From interface java.io.ObjectStreamConstants public static final SerializablePermission SUBCLASS_IMPLEMENTATION_PERMISSION Enable overriding of readObject and writeObject. public static final SerializablePermission SUBSTITUTION_PERMISSION Enable substitution of one object for another during serialization/deserialization.

[Expand] Inherited Methods
From class java.io.ObjectOutputStream void annotateClass(Class<?> cl) Subclasses may implement this method to allow class data to be stored in the stream. void annotateProxyClass(Class<?> cl) Subclasses may implement this method to store custom data in the stream along with descriptors for dynamic proxy classes. void close() Closes the stream. void defaultWriteObject() Write the non-static and non-transient fields of the current class to this stream. void drain() Drain any buffered data in ObjectOutputStream. boolean enableReplaceObject(boolean enable) Enable the stream to do replacement of objects in the stream. void flush() Flushes the stream. ObjectOutputStream.PutField putFields() Retrieve the object used to buffer persistent fields to be written to the stream. Object replaceObject(Object obj) This method will allow trusted subclasses of ObjectOutputStream to substitute one object for another during serialization. void reset() Reset will disregard the state of any objects already written to the stream. void useProtocolVersion(int version) Specify stream protocol version to use when writing the stream. void write(int val) Writes a byte. void write(byte[] buf, int off, int len) Writes a sub array of bytes. void write(byte[] buf) Writes an array of bytes. void writeBoolean(boolean val) Writes a boolean. void writeByte(int val) Writes an 8 bit byte. void writeBytes(String str) Writes a String as a sequence of bytes. void writeChar(int val) Writes a 16 bit char. void writeChars(String str) Writes a String as a sequence of chars. void writeClassDescriptor(ObjectStreamClass desc) Write the specified class descriptor to the ObjectOutputStream. void writeDouble(double val) Writes a 64 bit double. void writeFields() Write the buffered fields to the stream. void writeFloat(float val) Writes a 32 bit float. void writeInt(int val) Writes a 32 bit int. void writeLong(long val) Writes a 64 bit long. final void writeObject(Object obj) Write the specified object to the ObjectOutputStream. void writeObjectOverride(Object obj) Method used by subclasses to override the default writeObject method. void writeShort(int val) Writes a 16 bit short. void writeStreamHeader() The writeStreamHeader method is provided so subclasses can append or prepend their own header to the stream. void writeUTF(String str) Primitive data write of this String in modified UTF-8 format. void writeUnshared(Object obj) Writes an "unshared" object to the ObjectOutputStream.
From class java.io.OutputStream void close() Closes this output stream and releases any system resources associated with this stream. void flush() Flushes this output stream and forces any buffered output bytes to be written out. void write(byte[] b, int off, int len) Writes len bytes from the specified byte array starting at offset off to this output stream. void write(byte[] b) Writes b.length bytes from the specified byte array to this output stream. abstract void write(int b) Writes the specified byte to this output stream.
From class java.lang.Object Object clone() Creates and returns a copy of this object. boolean equals(Object obj) Indicates whether some other object is "equal to" this one. void finalize() Called by the garbage collector on an object when garbage collection determines that there are no more references to the object. final Class<?> getClass() Returns the runtime class of this Object. int hashCode() Returns a hash code value for the object. final void notify() Wakes up a single thread that is waiting on this object's monitor. final void notifyAll() Wakes up all threads that are waiting on this object's monitor. String toString() Returns a string representation of the object. final void wait() Causes the current thread to wait until another thread invokes the notify() method or the notifyAll() method for this object. final void wait(long timeout, int nanos) Causes the current thread to wait until another thread invokes the notify() method or the notifyAll() method for this object, or some other thread interrupts the current thread, or a certain amount of real time has elapsed. final void wait(long timeout) Causes the current thread to wait until either another thread invokes the notify() method or the notifyAll() method for this object, or a specified amount of time has elapsed.
From interface java.io.Closeable abstract void close() Closes this stream and releases any system resources associated with it.
From interface java.io.DataOutput abstract void write(int b) Writes to the output stream the eight low-order bits of the argument b. abstract void write(byte[] b, int off, int len) Writes len bytes from array b, in order, to the output stream. abstract void write(byte[] b) Writes to the output stream all the bytes in array b. abstract void writeBoolean(boolean v) Writes a boolean value to this output stream. abstract void writeByte(int v) Writes to the output stream the eight low- order bits of the argument v. abstract void writeBytes(String s) Writes a string to the output stream. abstract void writeChar(int v) Writes a char value, which is comprised of two bytes, to the output stream. abstract void writeChars(String s) Writes every character in the string s, to the output stream, in order, two bytes per character. abstract void writeDouble(double v) Writes a double value, which is comprised of eight bytes, to the output stream. abstract void writeFloat(float v) Writes a float value, which is comprised of four bytes, to the output stream. abstract void writeInt(int v) Writes an int value, which is comprised of four bytes, to the output stream. abstract void writeLong(long v) Writes a long value, which is comprised of eight bytes, to the output stream. abstract void writeShort(int v) Writes two bytes to the output stream to represent the value of the argument. abstract void writeUTF(String s) Writes two bytes of length information to the output stream, followed by the modified UTF-8 representation of every character in the string s.
From interface java.io.Flushable abstract void flush() Flushes this stream by writing any buffered output to the underlying stream.
From interface java.io.ObjectOutput abstract void close() Closes the stream. abstract void flush() Flushes the stream. abstract void write(byte[] b, int off, int len) Writes a sub array of bytes. abstract void write(byte[] b) Writes an array of bytes. abstract void write(int b) Writes a byte. abstract void writeObject(Object obj) Write an object to the underlying storage or stream.