org.apache.river.api.io

Class AtomicMarshalledInstance

java.lang.Object

net.jini.io.MarshalledInstance

org.apache.river.api.io.AtomicMarshalledInstance

All Implemented Interfaces:

Serializable

public final class AtomicMarshalledInstance
extends MarshalledInstance

Implementation of MarshalledInstance that performs input validation during un-marshaling. Note that this implementation doesn't replace the stored object instance if it's an instance of ProxyAccessor, but will replace any ProxyAccessor references it contains.

Author:

peter

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor and Description
AtomicMarshalledInstance(MarshalledObject mo) Creates a new MarshalledInstance from an existing MarshalledObject.
AtomicMarshalledInstance(Object obj) Creates a new MarshalledInstance that contains the marshalled representation of the current state of the supplied object.
AtomicMarshalledInstance(Object obj, Collection context) Creates a new AtomicMarshalledInstance that contains the marshalled representation of the current state of the supplied object.

Method Summary

Modifier and Type	Method and Description
protected MarshalFactory	getMarshalFactory() Sub classes implement this method to use alternative Serialization frameworks to unmarshall data.

Methods inherited from class net.jini.io.MarshalledInstance

convertToMarshalledObject, equals, fullyEquals, get, get, hashCode, isNull

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

AtomicMarshalledInstance

public AtomicMarshalledInstance(MarshalledObject mo)

Creates a new MarshalledInstance from an existing MarshalledObject. An object equivalent to the object contained in the passed MarshalledObject will be contained in the new AtomicMarshalledInstance.

The object contained in the passed MarshalledObject will not be unmarshalled as part of this call.

Note that an AtomicMarshalledInstance, converted to a MarshalledObject can be deserialized, without support for using atomic input validation. A MarshalledObject converted to an AtomicMarshalledObject can only be deserialized if it was originally created as an AtomicMarshalledInstance. This functionality only exists for backward compatibility reasons.

Parameters:

mo - The MarshalledObject that contains the object the new MarshalledInstance should contain

Throws:

NullPointerException - if mo is null

AtomicMarshalledInstance

public AtomicMarshalledInstance(Object obj)
                         throws IOException

Creates a new MarshalledInstance that contains the marshalled representation of the current state of the supplied object. The object is serialized with the semantics defined by AtomicMarshalOutputStream. The output stream used to marshal the object implements ObjectStreamContext and returns an empty collection from its getObjectStreamContext method.

Parameters:

obj - The Object to be contained in the new MarshalledInstance

Throws:

IOException - if the object cannot be serialized

AtomicMarshalledInstance

public AtomicMarshalledInstance(Object obj,
                                Collection context)
                         throws IOException

Creates a new AtomicMarshalledInstance that contains the marshalled representation of the current state of the supplied object. The object is serialized with the semantics defined by AtomicMarshalOutputStream. The output stream used to marshal the object implements ObjectStreamContext and returns the given collection from its getObjectStreamContext method.

Parameters:

obj - The Object to be contained in the new AtomicMarshalledInstance

context - the collection of context information objects

Throws:

IOException - if the object cannot be serialized

NullPointerException - if context is null

Method Detail

getMarshalFactory

protected final MarshalFactory getMarshalFactory()

Description copied from class: MarshalledInstance

Sub classes implement this method to use alternative Serialization frameworks to unmarshall data.

Overrides:

getMarshalFactory in class MarshalledInstance

Returns:

a new MarshalFactory instance.