com.sun.sgs.impl.util
Class WrappedSerializable<T>

java.lang.Object
  com.sun.sgs.impl.util.WrappedSerializable<T>

Type Parameters:

T - type of object wrapped

All Implemented Interfaces:

Serializable

public final class WrappedSerializable<T>
extends Object
implements Serializable

A wrapper for an object that is serializable, but may or may not be a ManagedObject. An instance of this serializable wrapper contains a managed reference to the object specified during construction as follows:

• If the object implements ManagedObject, the WrappedSerializable instance contains a ManagedReference directly to that object.
• Otherwise, if the object implements Serializable but does not implement ManagedObject, the WrappedSerializable instance wraps the object in a ManagedObject and contains a reference to the wrapper.

When an instance of WrappedSerializable is no longer in use, the remove method should be invoked on the instance so that if a wrapper was created for the object, the wrapper can be removed.

See Also:

Serialized Form

Constructor Summary

WrappedSerializable(T object)
Constructs an instance of this class with the specified object.

Method Summary

T	get() Returns the object in this wrapper.
void	remove() Marks this instance as removed, and if this instance contains a ManagedObject wrapper to the object specified during construction, then removes the wrapper as well.

Methods inherited from class java.lang.Object

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

Constructor Detail

WrappedSerializable

public WrappedSerializable(T object)

Constructs an instance of this class with the specified object. The specified object must implement Serializable and may or may not be a ManagedObject.

Parameters:

object - an object

Throws:

IllegalArgumentException - if the specified object does not implement Serializable

Method Detail

get

public T get()

Returns the object in this wrapper.

Returns:

T the object in this wrapper

Throws:

IllegalStateException - if remove has been invoked on this instance

remove

public void remove()

Marks this instance as removed, and if this instance contains a ManagedObject wrapper to the object specified during construction, then removes the wrapper as well.

Throws:

IllegalStateException - if remove has been invoked on this instance