1. package org.omg.PortableServer;
  2. /**
  3. * org/omg/PortableServer/POAManagerOperations.java .
  4. * Generated by the IDL-to-Java compiler (portable), version "3.1"
  5. * from ../../../../src/share/classes/org/omg/PortableServer/poa.idl
  6. * Monday, February 23, 2004 7:03:02 AM GMT
  7. */
  8. /**
  9. * Each POA object has an associated POAManager object.
  10. * A POA manager may be associated with one or more
  11. * POA objects. A POA manager encapsulates the processing
  12. * state of the POAs it is associated with.
  13. */
  14. public interface POAManagerOperations
  15. {
  16. /**
  17. * This operation changes the state of the POA manager
  18. * to active, causing associated POAs to start processing
  19. * requests.
  20. * @exception AdapterInactive is raised if the operation is
  21. * invoked on the POAManager in inactive state.
  22. */
  23. void activate () throws org.omg.PortableServer.POAManagerPackage.AdapterInactive;
  24. /**
  25. * This operation changes the state of the POA manager
  26. * to holding, causing associated POAs to queue incoming
  27. * requests.
  28. * @param wait_for_completion if FALSE, the operation
  29. * returns immediately after changing state.
  30. * If TRUE, it waits for all active requests
  31. * to complete.
  32. * @exception AdapterInactive is raised if the operation is
  33. * invoked on the POAManager in inactive state.
  34. */
  35. void hold_requests (boolean wait_for_completion) throws org.omg.PortableServer.POAManagerPackage.AdapterInactive;
  36. /**
  37. * This operation changes the state of the POA manager
  38. * to discarding. This causes associated POAs to discard
  39. * incoming requests.
  40. * @param wait_for_completion if FALSE, the operation
  41. * returns immediately after changing state.
  42. * If TRUE, it waits for all active requests
  43. * to complete.
  44. * @exception AdapterInactive is raised if the operation is
  45. * invoked on the POAManager in inactive state.
  46. */
  47. void discard_requests (boolean wait_for_completion) throws org.omg.PortableServer.POAManagerPackage.AdapterInactive;
  48. /**
  49. * This operation changes the state of the POA manager
  50. * to inactive, causing associated POAs to reject the
  51. * requests that have not begun executing as well as
  52. * as any new requests.
  53. * @param etherealize_objects a flag to indicate whether
  54. * to invoke the etherealize operation of the
  55. * associated servant manager for all active
  56. * objects.
  57. * @param wait_for_completion if FALSE, the operation
  58. * returns immediately after changing state.
  59. * If TRUE, it waits for all active requests
  60. * to complete.
  61. * @exception AdapterInactive is raised if the operation is
  62. * invoked on the POAManager in inactive state.
  63. */
  64. void deactivate (boolean etherealize_objects, boolean wait_for_completion) throws org.omg.PortableServer.POAManagerPackage.AdapterInactive;
  65. /**
  66. * This operation returns the state of the POA manager.
  67. */
  68. org.omg.PortableServer.POAManagerPackage.State get_state ();
  69. } // interface POAManagerOperations