public class

MarshalInputStream

extends ObjectInputStream

java.lang.Object
↳	java.io.InputStream
	↳	java.io.ObjectInputStream
		↳	sun.rmi.server.MarshalInputStream

Class Overview

MarshalInputStream is an extension of ObjectInputStream. When resolving a class, it reads an object from the stream written by a corresponding MarshalOutputStream. If the class to be resolved is not available locally, from the first class loader on the execution stack, or from the context class loader of the current thread, it will attempt to load the class from the location annotated by the sending MarshalOutputStream. This location object must be a string representing a path of URLs. A new MarshalInputStream should be created to deserialize remote objects or graphs containing remote objects. Objects are created from the stream using the ObjectInputStream.readObject method.

Summary

[Expand]

Inherited Constants

From interface java.io.ObjectStreamConstants

Fields
protected static Map	permittedSunClasses	table to hold sun classes to which access is explicitly permitted

[Expand]

Inherited Fields

From interface java.io.ObjectStreamConstants

Public Constructors
	MarshalInputStream(InputStream in) Create a new MarshalInputStream object.

Public Methods
void	close() Closes this stream, implicitly invoking done() first.
void	done() Indicates that the user of this MarshalInputStream is done reading objects from it, so all callbacks registered with the setDoneCallback method should now be (synchronously) executed.
Runnable	getDoneCallback(Object key) Returns a callback previously registered via the setDoneCallback method with given key, or null if no callback has yet been registered with that key.
void	setDoneCallback(Object key, Runnable callback) Registers a callback to make when this stream's done() method is invoked, along with a key for retrieving the same callback instance subsequently from the getDoneCallback method.

Protected Methods
Object	readLocation() Return the location for the class in the stream.
Class	resolveClass(ObjectStreamClass classDesc) resolveClass is extended to acquire (if present) the location from which to load the specified class.
Class	resolveProxyClass(String[] interfaces) resolveProxyClass is extended to acquire (if present) the location to determine the class loader to define the proxy class in.

[Expand]

Inherited Methods

From class java.io.ObjectInputStream

int	available() Returns the number of bytes that can be read without blocking.
void	close() Closes the input stream.
void	defaultReadObject() Read the non-static and non-transient fields of the current class from this stream.
boolean	enableResolveObject(boolean enable) Enable the stream to allow objects read from the stream to be replaced.
int	read(byte[] buf, int off, int len) Reads into an array of bytes.
int	read() Reads a byte of data.
boolean	readBoolean() Reads in a boolean.
byte	readByte() Reads an 8 bit byte.
char	readChar() Reads a 16 bit char.
ObjectStreamClass	readClassDescriptor() Read a class descriptor from the serialization stream.
double	readDouble() Reads a 64 bit double.
ObjectInputStream.GetField	readFields() Reads the persistent fields from the stream and makes them available by name.
float	readFloat() Reads a 32 bit float.
void	readFully(byte[] buf) Reads bytes, blocking until all bytes are read.
void	readFully(byte[] buf, int off, int len) Reads bytes, blocking until all bytes are read.
int	readInt() Reads a 32 bit int.
String	readLine() This method is deprecated. This method does not properly convert bytes to characters. see DataInputStream for the details and alternatives.
long	readLong() Reads a 64 bit long.
final Object	readObject() Read an object from the ObjectInputStream.
Object	readObjectOverride() This method is called by trusted subclasses of ObjectOutputStream that constructed ObjectOutputStream using the protected no-arg constructor.
short	readShort() Reads a 16 bit short.
void	readStreamHeader() The readStreamHeader method is provided to allow subclasses to read and verify their own stream headers.
String	readUTF() Reads a String in modified UTF-8 format.
Object	readUnshared() Reads an "unshared" object from the ObjectInputStream.
int	readUnsignedByte() Reads an unsigned 8 bit byte.
int	readUnsignedShort() Reads an unsigned 16 bit short.
void	registerValidation(ObjectInputValidation obj, int prio) Register an object to be validated before the graph is returned.
Class<?>	resolveClass(ObjectStreamClass desc) Load the local class equivalent of the specified stream class description.
Object	resolveObject(Object obj) This method will allow trusted subclasses of ObjectInputStream to substitute one object for another during deserialization.
Class<?>	resolveProxyClass(String[] interfaces) Returns a proxy class that implements the interfaces named in a proxy class descriptor; subclasses may implement this method to read custom data from the stream along with the descriptors for dynamic proxy classes, allowing them to use an alternate loading mechanism for the interfaces and the proxy class.
int	skipBytes(int len) Skips bytes.

From class java.io.InputStream

int	available() Returns an estimate of the number of bytes that can be read (or skipped over) from this input stream without blocking by the next invocation of a method for this input stream.
void	close() Closes this input stream and releases any system resources associated with the stream.
synchronized void	mark(int readlimit) Marks the current position in this input stream.
boolean	markSupported() Tests if this input stream supports the `mark` and `reset` methods.
int	read(byte[] b) Reads some number of bytes from the input stream and stores them into the buffer array `b`.
abstract int	read() Reads the next byte of data from the input stream.
int	read(byte[] b, int off, int len) Reads up to `len` bytes of data from the input stream into an array of bytes.
synchronized void	reset() Repositions this stream to the position at the time the `mark` method was last called on this input stream.
long	skip(long n) Skips over and discards `n` bytes of data from this input 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

From interface java.io.DataInput

abstract boolean	readBoolean() Reads one input byte and returns `true` if that byte is nonzero, `false` if that byte is zero.
abstract byte	readByte() Reads and returns one input byte.
abstract char	readChar() Reads two input bytes and returns a `char` value.
abstract double	readDouble() Reads eight input bytes and returns a `double` value.
abstract float	readFloat() Reads four input bytes and returns a `float` value.
abstract void	readFully(byte[] b) Reads some bytes from an input stream and stores them into the buffer array `b`.
abstract void	readFully(byte[] b, int off, int len) Reads `len` bytes from an input stream.
abstract int	readInt() Reads four input bytes and returns an `int` value.
abstract String	readLine() Reads the next line of text from the input stream.
abstract long	readLong() Reads eight input bytes and returns a `long` value.
abstract short	readShort() Reads two input bytes and returns a `short` value.
abstract String	readUTF() Reads in a string that has been encoded using a modified UTF-8 format.
abstract int	readUnsignedByte() Reads one input byte, zero-extends it to type `int`, and returns the result, which is therefore in the range `0` through `255`.
abstract int	readUnsignedShort() Reads two input bytes and returns an `int` value in the range `0` through `65535`.
abstract int	skipBytes(int n) Makes an attempt to skip over `n` bytes of data from the input stream, discarding the skipped bytes.

From interface java.io.ObjectInput

Fields

protected static Map permittedSunClasses

table to hold sun classes to which access is explicitly permitted

Public Constructors

public MarshalInputStream (InputStream in)

Create a new MarshalInputStream object.

Throws

IOException
StreamCorruptedException

Public Methods

public void close ()

Closes this stream, implicitly invoking done() first.

Throws

IOException

public void done ()

Indicates that the user of this MarshalInputStream is done reading objects from it, so all callbacks registered with the setDoneCallback method should now be (synchronously) executed. When this method returns, there are no more callbacks registered. This method is implicitly invoked by close() before it delegates to the superclass's close method.

public Runnable getDoneCallback (Object key)

Returns a callback previously registered via the setDoneCallback method with given key, or null if no callback has yet been registered with that key.

public void setDoneCallback (Object key, Runnable callback)

Registers a callback to make when this stream's done() method is invoked, along with a key for retrieving the same callback instance subsequently from the getDoneCallback method.

Protected Methods

protected Object readLocation ()

Return the location for the class in the stream. This method can be overridden by subclasses that store this annotation somewhere else than as the next object in the stream, as is done by this class.

Throws

ClassNotFoundException
IOException

protected Class resolveClass (ObjectStreamClass classDesc)

resolveClass is extended to acquire (if present) the location from which to load the specified class. It will find, load, and return the class.

Parameters

classDesc	an instance of class `ObjectStreamClass`

Returns

a Class object corresponding to desc

Throws

IOException
ClassNotFoundException

protected Class resolveProxyClass (String[] interfaces)

resolveProxyClass is extended to acquire (if present) the location to determine the class loader to define the proxy class in.

Parameters

interfaces	the list of interface names that were deserialized in the proxy class descriptor

Returns

a proxy class for the specified interfaces

Throws

IOException
ClassNotFoundException

Interfaces

Classes

Exceptions

MarshalInputStream

Class Overview

Summary

Fields

protected static Map permittedSunClasses

Public Constructors

public MarshalInputStream (InputStream in)

Throws

Public Methods

public void close ()

Throws

public void done ()

public Runnable getDoneCallback (Object key)

public void setDoneCallback (Object key, Runnable callback)

Protected Methods

protected Object readLocation ()

Throws

protected Class resolveClass (ObjectStreamClass classDesc)

Parameters

Returns

Throws

protected Class resolveProxyClass (String[] interfaces)

Parameters

Returns

Throws