Package org.omg.PortableServer

Class ServantLocatorHolder

java.lang.Object

org.omg.PortableServer.ServantLocatorHolder

All Implemented Interfaces:

Streamable

public final class ServantLocatorHolder
extends Object
implements Streamable

When the POA has the NON_RETAIN policy it uses servant managers that are ServantLocators. Because the POA knows that the servant returned by this servant manager will be used only for a single request, it can supply extra information to the servant manager's operations and the servant manager's pair of operations may be able to cooperate to do something different than a ServantActivator. When the POA uses the ServantLocator interface, immediately after performing the operation invocation on the servant returned by preinvoke, the POA will invoke postinvoke on the servant manager, passing the ObjectId value and the Servant value as parameters (among others). This feature may be used to force every request for objects associated with a POA to be mediated by the servant manager.

Field Summary

Fields

Modifier and Type	Field	Description
ServantLocator	value

Constructor Summary

Constructors

Constructor	Description
ServantLocatorHolder()
ServantLocatorHolder(ServantLocator initialValue)

Method Summary

Modifier and Type	Method	Description
void	_read(InputStream i)	Reads data from istream and initalizes the value field of the Holder with the unmarshalled data.
TypeCode	_type()	Retrieves the TypeCode object corresponding to the value in the value field of the Holder.
void	_write(OutputStream o)	Marshals to ostream the value in the value field of the Holder.

Methods inherited from class java.lang.Object

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

Field Details

value

public ServantLocator value

Constructor Details

ServantLocatorHolder

public ServantLocatorHolder()

ServantLocatorHolder

public ServantLocatorHolder(ServantLocator initialValue)

Method Details

_read

public void _read(InputStream i)

Description copied from interface: Streamable

Reads data from istream and initalizes the value field of the Holder with the unmarshalled data.

Specified by:

_read in interface Streamable

Parameters:

i - the InputStream that represents the CDR data from the wire.

_write

public void _write(OutputStream o)

Description copied from interface: Streamable

Marshals to ostream the value in the value field of the Holder.

Specified by:

_write in interface Streamable

Parameters:

o - the CDR OutputStream

_type

public TypeCode _type()

Description copied from interface: Streamable

Retrieves the TypeCode object corresponding to the value in the value field of the Holder.

Specified by:

_type in interface Streamable

Returns:

the TypeCode object for the value held in the holder