POAManagerOperations


1   package org.omg.PortableServer;
2   
3   
4   /**
5   * org/omg/PortableServer/POAManagerOperations.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       * Each POA object has an associated POAManager object. 
14       * A POA manager may be associated with one or more 
15       * POA objects. A POA manager encapsulates the processing 
16       * state of the POAs it is associated with.
17       */
18  public interface POAManagerOperations 
19  {
20  
21    /**
22       * This operation changes the state of the POA manager 
23       * to active, causing associated POAs to start processing
24       * requests.
25       * @exception AdapterInactive is raised if the operation is
26       *            invoked on the POAManager in inactive state.
27       */
28    void activate () throws org.omg.PortableServer.POAManagerPackage.AdapterInactive  ;
29  
30    /**
31       * This operation changes the state of the POA manager 
32       * to holding, causing associated POAs to queue incoming
33       * requests.
34       * @param wait_for_completion if FALSE, the operation 
35       *            returns immediately after changing state.  
36       *            If TRUE, it waits for all active requests 
37       *            to complete. 
38       * @exception AdapterInactive is raised if the operation is
39       *            invoked on the POAManager in inactive state.
40       */
41    void hold_requests (boolean wait_for_completion) throws org.omg.PortableServer.POAManagerPackage.AdapterInactive  ;
42  
43    /**
44       * This operation changes the state of the POA manager 
45       * to discarding. This causes associated POAs to discard
46       * incoming requests.
47       * @param wait_for_completion if FALSE, the operation 
48       *            returns immediately after changing state.  
49       *            If TRUE, it waits for all active requests 
50       *            to complete. 
51       * @exception AdapterInactive is raised if the operation is
52       *            invoked on the POAManager in inactive state.
53       */
54    void discard_requests (boolean wait_for_completion) throws org.omg.PortableServer.POAManagerPackage.AdapterInactive  ;
55  
56    /**
57       * This operation changes the state of the POA manager 
58       * to inactive, causing associated POAs to reject the
59       * requests that have not begun executing as well as
60       * as any new requests.
61       * @param etherealize_objects a flag to indicate whether
62       *        to invoke the etherealize operation of the
63       *        associated servant manager for all active 
64       *        objects.
65       * @param wait_for_completion if FALSE, the operation 
66       *            returns immediately after changing state.  
67       *            If TRUE, it waits for all active requests 
68       *            to complete. 
69       * @exception AdapterInactive is raised if the operation is
70       *            invoked on the POAManager in inactive state.
71       */
72    void deactivate (boolean etherealize_objects, boolean wait_for_completion) throws org.omg.PortableServer.POAManagerPackage.AdapterInactive  ;
73  
74    /**
75       * This operation returns the state of the POA manager.
76       */
77    org.omg.PortableServer.POAManagerPackage.State   get_state ();
78  } // interface POAManagerOperations
79
A to Z: JavaDoc & Examples Daily Java News & Articles Open Source Projects Open Source Codes Free Computer Books Remove Frame
Popular Tags