J-Integra® Espresso Programming Documentation (API)

POA.servant_to_reference Method

This operation requires the RETAIN policy and either the UNIQUE_ID or IMPLICIT_ACTIVATION policies:

  1. If the POA has both the RETAIN and the UNIQUE_ID policy and the specified servant is active, an object reference associated with the activate servant is returned

  2. If the POA has both the RETAIN and the IMPLICIT_ACTIVATION policy and either the POA has the MULTIPLE_ID policy or the specified servant is not active, the servant is activated using a POA-generated Object Id and the Interface Id associated with the servant, and a corresponding object reference is returned.
  3. If the operation was invoked in the context of executing a request on the specified servant, the reference associated with the current invocation is returned.
  4. Otherwise, the ServantNotActive exception is raised.

CORBA.Object servant_to_reference(
 PortableServer.Servant servant
);

Parameters

servant
Servant for which the object reference needs to be obtained.

Return Value

Object reference associated with the servant.

Remarks

none

Exceptions

Exception TypeCondition
POAPackage.WrongPolicy An error occurs if the operation is not invoked in the context of executing a request on the specified servant and the required policies are not present.
POAPackage.ServantNotActive An error occurs if the above specified policies and rules are not met.

See Also

POA Interface | POA Members | Ics Namespace