package org.omg.PortableServer;


/**
* org/omg/PortableServer/ServantActivatorOperations.java .
* Generated by the IDL-to-Java compiler (portable), version "3.2"
* from /var/lib/jenkins/jobs/openjdk/jobs/openjdk10/workspace/jdk-updates_jdk10u/src/java.corba/share/classes/org/omg/PortableServer/poa.idl
* Sunday, February 14, 2021 at 5:20:33 PM Coordinated Universal Time
*/


When the POA has the RETAIN policy it uses servant managers that are ServantActivators.
/** * When the POA has the RETAIN policy it uses servant * managers that are ServantActivators. */
public interface ServantActivatorOperations extends org.omg.PortableServer.ServantManagerOperations {
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.
Params:
  • 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.
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.
Returns:Servant corresponding to oid is created or located by the user supplied servant manager.
/** * 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. * @param oid object Id associated with the object on * the request was made. * @param adapter object reference for the POA in which * the object is being activated. * @return Servant corresponding to oid is created or * located by the user supplied servant manager. * @exception 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. */
org.omg.PortableServer.Servant incarnate (byte[] oid, org.omg.PortableServer.POA adapter) throws org.omg.PortableServer.ForwardRequest;
This operation is invoked whenever a servant for an object is deactivated, assuming the POA has the USE_SERVANT_MANAGER and RETAIN policies.
Params:
  • 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.
/** * This operation is invoked whenever a servant for * an object is deactivated, assuming the POA has * the USE_SERVANT_MANAGER and RETAIN policies. * @param oid object Id associated with the object * being deactivated. * @param adapter object reference for the POA in which * the object was active. * @param serv contains reference to the servant * associated with the object being deactivated. * @param 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. * @param 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. */
void etherealize (byte[] oid, org.omg.PortableServer.POA adapter, org.omg.PortableServer.Servant serv, boolean cleanup_in_progress, boolean remaining_activations); } // interface ServantActivatorOperations