Por favor, lembre-se que esta tradução da especificação é resultado de um projeto da comunidade java.net( https://jdk5-api-pt-br.dev.java.net/). A versão oficial da especificação é a versão na língua inglesa que pode ser encontrada em http://java.sun.com/j2se/1.5.0/docs/api/. Em caso de divergências, a versão predominante da especificação é a original em inglês.

Please note that this translation of the specification is the result of a java.net community project ( https://jdk5-api-pt-br.dev.java.net/ ). The official version of the specification is the US English language version which can be found at http://java.sun.com/j2se/1.5.0/docs/api/. In case of disputes, the authoritative version of the specification is the original, English document.

org.omg.PortableServer
Interface POAManagerOperations

All Known Subinterfaces:

POAManager

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.

Method Summary

void	activate() This operation changes the state of the POA manager to active, causing associated POAs to start processing requests.
void	deactivate(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.
void	discard_requests(boolean wait_for_completion) This operation changes the state of the POA manager to discarding.
State	get_state() This operation returns the state of the POA manager.
void	hold_requests(boolean wait_for_completion) This operation changes the state of the POA manager to holding, causing associated POAs to queue incoming requests.

Method Detail

activate

void activate()
              throws AdapterInactive

This operation changes the state of the POA manager to active, causing associated POAs to start processing requests.

Throws:

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

hold_requests

void hold_requests(boolean wait_for_completion)
                   throws AdapterInactive

This operation changes the state of the POA manager to holding, causing associated POAs to queue incoming requests.

Parameters:

wait_for_completion - if FALSE, the operation returns immediately after changing state. If TRUE, it waits for all active requests to complete.

Throws:

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

discard_requests

void discard_requests(boolean wait_for_completion)
                      throws AdapterInactive

This operation changes the state of the POA manager to discarding. This causes associated POAs to discard incoming requests.

Parameters:

wait_for_completion - if FALSE, the operation returns immediately after changing state. If TRUE, it waits for all active requests to complete.

Throws:

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

deactivate

void deactivate(boolean etherealize_objects,
                boolean wait_for_completion)
                throws AdapterInactive

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.

Parameters:

etherealize_objects - a flag to indicate whether to invoke the etherealize operation of the associated servant manager for all active objects.

wait_for_completion - if FALSE, the operation returns immediately after changing state. If TRUE, it waits for all active requests to complete.

Throws:

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

get_state

State get_state()

This operation returns the state of the POA manager.