java.rmi
Class MarshalledObject

java.lang.Object
  extended byjava.rmi.MarshalledObject
All Implemented Interfaces:
Serializable

public final class MarshalledObject
extends Object
implements Serializable

A MarshalledObject contains a byte stream with the serialized representation of an object given to its constructor. The get method returns a new copy of the original object, as deserialized from the contained byte stream. The contained object is serialized and deserialized with the same serialization semantics used for marshaling and unmarshaling parameters and return values of RMI calls: When the serialized form is created:

When copy of the object is retrieved (via the get method), if the class is not available locally, it will be loaded from the appropriate location (specified the URL annotated with the class descriptor when the class was serialized.

MarshalledObject facilitates passing objects in RMI calls that are not automatically deserialized immediately by the remote peer.

Since:
1.2
Author:
Ann Wollrath, Peter Jones
See Also:
Serialized Form

Nested Class Summary
private static class MarshalledObject.MarshalledObjectInputStream
          The counterpart to MarshalledObjectOutputStream.
private static class MarshalledObject.MarshalledObjectOutputStream
          This class is used to marshal objects for MarshalledObject.
 
Field Summary
private  int hash
           
private  byte[] locBytes
           
private  byte[] objBytes
           
private static long serialVersionUID
          Indicate compatibility with 1.2 version of class.
 
Constructor Summary
MarshalledObject(Object obj)
          Creates a new MarshalledObject that contains the serialized representation of the current state of the supplied object.
 
Method Summary
 boolean equals(Object obj)
          Compares this MarshalledObject to another object.
 Object get()
          Returns a new copy of the contained marshalledobject.
 int hashCode()
          Return a hash code for this MarshalledObject.
 
Methods inherited from class java.lang.Object
clone, finalize, getClass, notify, notifyAll, toString, wait, wait, wait
 

Field Detail

objBytes

private byte[] objBytes

locBytes

private byte[] locBytes

hash

private int hash
See Also:
hashCode()

serialVersionUID

private static final long serialVersionUID
Indicate compatibility with 1.2 version of class.

See Also:
Constant Field Values
Constructor Detail

MarshalledObject

public MarshalledObject(Object obj)
                 throws IOException
Creates a new MarshalledObject that contains the serialized representation of the current state of the supplied object. The object is serialized with the semantics used for marshaling parameters for RMI calls.

Parameters:
obj - the object to be serialized (must be serializable)
Throws:
IOException - if an IOException occurs; an IOException may occur if obj is not serializable.
Since:
1.2
Method Detail

get

public Object get()
           throws IOException,
                  ClassNotFoundException
Returns a new copy of the contained marshalledobject. The internal representation is deserialized with the semantics used for unmarshaling paramters for RMI calls.

Returns:
a copy of the contained object
Throws:
IOException - if an IOException occurs while deserializing the object from its internal representation.
ClassNotFoundException - if a ClassNotFoundException occurs while deserializing the object from its internal representation. could not be found
Since:
1.2

hashCode

public int hashCode()
Return a hash code for this MarshalledObject.

Overrides:
hashCode in class Object
Returns:
a hash code
See Also:
Object.equals(java.lang.Object), Hashtable

equals

public boolean equals(Object obj)
Compares this MarshalledObject to another object. Returns true if and only if the argument refers to a MarshalledObject that contains exactly the same serialized representation of an object as this one does. The comparison ignores any class codebase annotation, meaning that two objects are equivalent if they have the same serialized representation except for the codebase of each class in the serialized representation.

Overrides:
equals in class Object
Parameters:
obj - the object to compare with this MarshalledObject
Returns:
true if the argument contains an equaivalent serialized object; false otherwise
Since:
1.2
See Also:
Object.hashCode(), Hashtable