FileDocCategorySizeDatePackage
POAManagerOperations.javaAPI DocJava SE 6 API3114Tue Jun 10 01:33:18 BST 2008org.omg.PortableServer

POAManagerOperations

public interface POAManagerOperations
Each POA object has an associated POAManager object. A POA manager may be associated with one or more POA objects. A POA manager encapsulates the processing state of the POAs it is associated with.

Fields Summary
Constructors Summary
Methods Summary
public voidactivate()
This operation changes the state of the POA manager to active, causing associated POAs to start processing requests.

exception
AdapterInactive is raised if the operation is invoked on the POAManager in inactive state.

public voiddeactivate(boolean etherealize_objects, boolean wait_for_completion)
This operation changes the state of the POA manager to inactive, causing associated POAs to reject the requests that have not begun executing as well as as any new requests.

param
etherealize_objects a flag to indicate whether to invoke the etherealize operation of the associated servant manager for all active objects.
param
wait_for_completion if FALSE, the operation returns immediately after changing state. If TRUE, it waits for all active requests to complete.
exception
AdapterInactive is raised if the operation is invoked on the POAManager in inactive state.

public voiddiscard_requests(boolean wait_for_completion)
This operation changes the state of the POA manager to discarding. This causes associated POAs to discard incoming requests.

param
wait_for_completion if FALSE, the operation returns immediately after changing state. If TRUE, it waits for all active requests to complete.
exception
AdapterInactive is raised if the operation is invoked on the POAManager in inactive state.

public org.omg.PortableServer.POAManagerPackage.Stateget_state()
This operation returns the state of the POA manager.

public voidhold_requests(boolean wait_for_completion)
This operation changes the state of the POA manager to holding, causing associated POAs to queue incoming requests.

param
wait_for_completion if FALSE, the operation returns immediately after changing state. If TRUE, it waits for all active requests to complete.
exception
AdapterInactive is raised if the operation is invoked on the POAManager in inactive state.