compact2, compact3
java.rmi
Class MarshalledObject<T>
- java.lang.Object
-
- java.rmi.MarshalledObject<T>
-
- Type Parameters:
-
T- the type of the object contained in thisMarshalledObject
- All Implemented Interfaces:
- Serializable
public final class MarshalledObject<T> extends Object implements Serializable
AMarshalledObjectcontains a byte stream with the serialized representation of an object given to its constructor. Thegetmethod 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
MarshalledObjectis represented by a serialized instance of its stub.
When copy of the object is retrieved (via the
getmethod), 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.MarshalledObjectfacilitates passing objects in RMI calls that are not automatically deserialized immediately by the remote peer.- Since:
- 1.2
- See Also:
- Serialized Form
-
-
Constructor Summary
Constructors Constructor and Description MarshalledObject(T obj)Creates a newMarshalledObjectthat contains the serialized representation of the current state of the supplied object.
-
Method Summary
All Methods Instance Methods Concrete Methods Modifier and Type Method and Description booleanequals(Object obj)Compares thisMarshalledObjectto another object.Tget()Returns a new copy of the contained marshalledobject.inthashCode()Return a hash code for thisMarshalledObject.
-
-
-
Constructor Detail
MarshalledObject
public MarshalledObject(T obj) throws IOException
Creates a newMarshalledObjectthat 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 anIOExceptionoccurs; anIOExceptionmay occur ifobjis not serializable. - Since:
- 1.2
-
Method Detail
get
public T get() throws IOException, ClassNotFoundException
Returns a new copy of the contained marshalledobject. The internal representation is deserialized with the semantics used for unmarshaling parameters for RMI calls.- Returns:
- a copy of the contained object
- Throws:
-
IOException- if anIOExceptionoccurs while deserializing the object from its internal representation. -
ClassNotFoundException- if aClassNotFoundExceptionoccurs while deserializing the object from its internal representation. could not be found - Since:
- 1.2
hashCode
public int hashCode()
Return a hash code for thisMarshalledObject.- Overrides:
-
hashCodein classObject - Returns:
- a hash code
- See Also:
-
Object.equals(java.lang.Object),System.identityHashCode(java.lang.Object)
equals
public boolean equals(Object obj)
Compares thisMarshalledObjectto another object. Returns true if and only if the argument refers to aMarshalledObjectthat 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:
-
equalsin classObject - Parameters:
-
obj- the object to compare with thisMarshalledObject - Returns:
-
trueif the argument contains an equivalent serialized object;falseotherwise - Since:
- 1.2
- See Also:
-
Object.hashCode(),HashMap
-
Submit a bug or feature
For further API reference and developer documentation, see Java SE Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.
Copyright © 1993, 2022, Oracle and/or its affiliates. All rights reserved. Use is subject to license terms. Also see the documentation redistribution policy.
