KickJava   Java API By Example, From Geeks To Geeks.

Java > Open Source Codes > org > omg > PortableServer > ServantActivatorOperations


1 package org.omg.PortableServer;
2
3
4 /**
5 * org/omg/PortableServer/ServantActivatorOperations.java .
6 * Generated by the IDL-to-Java compiler (portable), version "3.2"
7 * from ../../../../src/share/classes/org/omg/PortableServer/poa.idl
8 * Saturday, February 9, 2008 9:40:03 AM GMT
9 */

10
11
12 /**
13      * When the POA has the RETAIN policy it uses servant
14      * managers that are ServantActivators.
15      */

16 public interface ServantActivatorOperations extends org.omg.PortableServer.ServantManagerOperations JavaDoc
17 {
18
19   /**
20      * This operation is invoked by the POA whenever the
21      * POA receives a request for an object that is not
22      * currently active, assuming the POA has the
23      * USE_SERVANT_MANAGER and RETAIN policies.
24      * @param oid object Id associated with the object on
25      * the request was made.
26      * @param adapter object reference for the POA in which
27      * the object is being activated.
28      * @return Servant corresponding to oid is created or
29      * located by the user supplied servant manager.
30      * @exception ForwardRequest to indicate to the ORB
31      * that it is responsible for delivering
32      * the current request and subsequent
33      * requests to the object denoted in the
34      * forward_reference member of the exception.
35      */

36   org.omg.PortableServer.Servant JavaDoc incarnate (byte[] oid, org.omg.PortableServer.POA JavaDoc adapter) throws org.omg.PortableServer.ForwardRequest JavaDoc;
37
38   /**
39      * This operation is invoked whenever a servant for
40      * an object is deactivated, assuming the POA has
41      * the USE_SERVANT_MANAGER and RETAIN policies.
42      * @param oid object Id associated with the object
43      * being deactivated.
44      * @param adapter object reference for the POA in which
45      * the object was active.
46      * @param serv contains reference to the servant
47      * associated with the object being deactivated.
48      * @param cleanup_in_progress if TRUE indicates that
49      * destroy or deactivate is called with
50      * etherealize_objects param of TRUE. FALSE
51      * indicates that etherealize was called due to
52      * other reasons.
53      * @param remaining_activations indicates whether the
54      * Servant Manager can destroy a servant. If
55      * set to TRUE, the Servant Manager should wait
56      * until all invocations in progress have
57      * completed.
58      */

59   void etherealize (byte[] oid, org.omg.PortableServer.POA JavaDoc adapter, org.omg.PortableServer.Servant JavaDoc serv, boolean cleanup_in_progress, boolean remaining_activations);
60 } // interface ServantActivatorOperations
61
Popular Tags