org.omg.PortableServer

Class ServantActivatorPOATie

java.lang.Object

org.omg.PortableServer.Servant

org.omg.PortableServer.ServantActivatorPOA

org.omg.PortableServer.ServantActivatorPOATie

All Implemented Interfaces:

InvokeHandler, ServantActivatorOperations, ServantManagerOperations

public class ServantActivatorPOATie
extends ServantActivatorPOA

When the POA has the RETAIN policy it uses servant managers that are ServantActivators.

Constructor Summary

Constructors

Constructor and Description
ServantActivatorPOATie(ServantActivatorOperations delegate)
ServantActivatorPOATie(ServantActivatorOperations delegate, POA poa)

Method Summary

Modifier and Type	Method and Description
POA	_default_POA() Returns the root POA from the ORB instance associated with the servant.
ServantActivatorOperations	_delegate()
void	_delegate(ServantActivatorOperations delegate)
void	etherealize(byte[] oid, POA adapter, Servant serv, boolean cleanup_in_progress, boolean remaining_activations) This operation is invoked whenever a servant for an object is deactivated, assuming the POA has the USE_SERVANT_MANAGER and RETAIN policies.
Servant	incarnate(byte[] oid, POA adapter) This operation is invoked by the POA whenever the POA receives a request for an object that is not currently active, assuming the POA has the USE_SERVANT_MANAGER and RETAIN policies.

Methods inherited from class org.omg.PortableServer.ServantActivatorPOA

_all_interfaces, _invoke, _this, _this

Methods inherited from class org.omg.PortableServer.Servant

_get_delegate, _get_interface_def, _is_a, _non_existent, _object_id, _orb, _poa, _set_delegate, _this_object, _this_object

Methods inherited from class java.lang.Object

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

Constructor Detail

ServantActivatorPOATie

public ServantActivatorPOATie(ServantActivatorOperations delegate)

ServantActivatorPOATie

public ServantActivatorPOATie(ServantActivatorOperations delegate,
                              POA poa)

Method Detail

_delegate

public ServantActivatorOperations _delegate()

_delegate

public void _delegate(ServantActivatorOperations delegate)

_default_POA

public POA _default_POA()

Description copied from class: Servant

Returns the root POA from the ORB instance associated with the servant. Subclasses may override this method to return a different POA.

Overrides:

_default_POA in class Servant

Returns:

default_POA the POA associated with the Servant.

incarnate

public Servant incarnate(byte[] oid,
                         POA adapter)
                  throws ForwardRequest

This operation is invoked by the POA whenever the POA receives a request for an object that is not currently active, assuming the POA has the USE_SERVANT_MANAGER and RETAIN policies.

Parameters:

oid - object Id associated with the object on the request was made.

adapter - object reference for the POA in which the object is being activated.

Returns:

Servant corresponding to oid is created or located by the user supplied servant manager.

Throws:

ForwardRequest - to indicate to the ORB that it is responsible for delivering the current request and subsequent requests to the object denoted in the forward_reference member of the exception.

etherealize

public void etherealize(byte[] oid,
                        POA adapter,
                        Servant serv,
                        boolean cleanup_in_progress,
                        boolean remaining_activations)

This operation is invoked whenever a servant for an object is deactivated, assuming the POA has the USE_SERVANT_MANAGER and RETAIN policies.

Parameters:

oid - object Id associated with the object being deactivated.

adapter - object reference for the POA in which the object was active.

serv - contains reference to the servant associated with the object being deactivated.

cleanup_in_progress - if TRUE indicates that destroy or deactivate is called with etherealize_objects param of TRUE. FALSE indicates that etherealize was called due to other reasons.

remaining_activations - indicates whether the Servant Manager can destroy a servant. If set to TRUE, the Servant Manager should wait until all invocations in progress have completed.