org.omg.PortableServer
Class _ServantActivatorStub

java.lang.Object   
  org.omg.CORBA.portable.ObjectImpl   
      org.omg.PortableServer._ServantActivatorStub

All Implemented Interfaces:

Serializable , Object , IDLEntity , ServantActivator , ServantActivatorOperations , ServantManager , ServantManagerOperations

public class _ServantActivatorStub
extends ObjectImpl   
implements ServantActivator   

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

See Also:

Serialized Form

Field Summary

static Class

_opsClass

Constructor Summary

_ServantActivatorStub ()

Method Summary

String []	_ids () Retrieves a string array containing the repository identifiers supported by this ObjectImpl object.
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.CORBA.portable.ObjectImpl

_create_request , _create_request , _duplicate , _get_delegate , _get_domain_managers , _get_interface_def , _get_policy , _hash , _invoke , _is_a , _is_equivalent , _is_local , _non_existent , _orb , _release , _releaseReply , _request , _request , _servant_postinvoke , _servant_preinvoke , _set_delegate , _set_policy_override , equals , hashCode , toString

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.omg.CORBA.Object

_create_request , _create_request , _duplicate , _get_domain_managers , _get_interface_def , _get_policy , _hash , _is_a , _is_equivalent , _non_existent , _release , _request , _set_policy_override

Field Detail

_opsClass

public static final Class    _opsClass

Constructor Detail

_ServantActivatorStub

public _ServantActivatorStub()

Method Detail

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.

Specified by:

incarnate in interface ServantActivatorOperations

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.

Specified by:

etherealize in interface ServantActivatorOperations

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.

_ids

public String   [] _ids()

Description copied from class: ObjectImpl

Retrieves a string array containing the repository identifiers supported by this ObjectImpl object. For example, for a stub, this method returns information about all the interfaces supported by the stub.

Specified by:

_ids in class ObjectImpl

Returns:

the array of all repository identifiers supported by this ObjectImpl instance