Overview

Package

Class

Use

Tree

Deprecated

Index

Help

Java Platform 1.2
Beta 4

PREV CLASS NEXT CLASS

FRAMES NO FRAMES

SUMMARY: INNER | FIELD | CONSTR | METHOD

DETAIL: FIELD | CONSTR | METHOD

Class java.rmi.MarshalledObject

java.lang.Object
  |
  +--java.rmi.MarshalledObject

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:

• classes are annotated with a codebase URL from where the class can be loaded (if available), and
• any remote object in the MarshalledObject is represented by a serialized instance of its stub.

When a copy of the object are retrieved (via the get method, if the class is not available locally, it will be loaded from the annotated URL. MarshalledObject facilitates passing objects in RMI calls that are not automatically deserialized immediately by the remote peer.

See Also:

Serialized Form

Constructor Summary

MarshalledObject(Object obj)
Create a new MarshalledObject that contains the serialized representation of the current state of the supplied object.

Method Summary

boolean	equals(Object obj) Compare this MarshalledObject to another object.
Object	get() Return a new copy of the contained object.
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

Constructor Detail

MarshalledObject

public MarshalledObject(Object obj)
                 throws IOException

Create 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)

Method Detail

get

public Object get()
           throws IOException,
                  ClassNotFoundException

Return a new copy of the contained object. The internal representation is deserialized with the semantics used for unmarshaling paramters for RMI calls.

Returns:

a copy of the contained object

hashCode

public int hashCode()

Return a hash code for this MarshalledObject.

Returns:

a hash code

Overrides:

hashCode in class Object

equals

public boolean equals(Object obj)

Compare this MarshalledObject to another object. Return 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 the class's 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.

Parameters:

obj - the object to compare this MarshalledObject against

Returns:

true if the argument contains an equaivalent serialized object

Overrides:

equals in class Object