Class POAManagerImpl

java.lang.Object

org.omg.CORBA.LocalObject

com.sun.corba.ee.impl.oa.poa.POAManagerImpl

All Implemented Interfaces:

Serializable, Object, IDLEntity, POAManager, POAManagerOperations

@ManagedObject
@Description("A POAManager which controls invocations of its POAs")
public class POAManagerImpl
extends LocalObject
implements POAManager

POAManagerImpl is the implementation of the POAManager interface. Its public methods are activate(), hold_requests(), discard_requests() and deactivate().

See Also:

• Serialized Form

Method Summary

Modifier and Type	Method	Description
void	activate()	activate Spec: pages 3-14 thru 3-18
void	deactivate(boolean etherealize_objects, boolean wait_for_completion)	deactivate Spec: pages 3-14 thru 3-18 Note: INACTIVE is a permanent state.
void	discard_requests(boolean wait_for_completion)	discard_requests Spec: pages 3-14 thru 3-18
String	displayState()
boolean	equals(Object obj)
State	get_state()	Added according to the spec CORBA V2.3; this returns the state of the POAManager
int	getManagerId()
short	getORTState()
int	hashCode()
void	hold_requests(boolean wait_for_completion)	hold_requests Spec: pages 3-14 thru 3-18
void	implicitActivation()	Activate the POAManager if no explicit state change has ever been previously invoked.
int	numberOfInvocations()
int	numberOfWaiters()
String	toString()

Methods inherited from class LocalObject

_create_request, _create_request, _duplicate, _get_domain_managers, _get_interface, _get_interface_def, _get_policy, _hash, _invoke, _is_a, _is_equivalent, _is_local, _non_existent, _orb, _release, _releaseReply, _request, _request, _servant_postinvoke, _servant_preinvoke, _set_policy_override, validate_connection

Methods inherited from class Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface Object

_create_request, _create_request, _duplicate, _get_domain_managers, _get_interface_def, _get_policy, _hash, _is_a, _is_equivalent, _non_existent, _release, _request, _set_policy_override

Method Details

hashCode

public int hashCode()

Overrides:

hashCode in class Object

equals

public boolean equals(Object obj)

Overrides:

equals in class Object

toString

public String toString()

Overrides:

toString in class Object

numberOfInvocations

@ManagedAttribute
@Description("Number of active invocations executing in this POAManager")
public int numberOfInvocations()

numberOfWaiters

@ManagedAttribute
@Description("Number of threads waiting for invocations to complete in this POAManager")
public int numberOfWaiters()

displayState

@ManagedAttribute
@Description("The current state of this POAManager")
public String displayState()

getManagerId

@ManagedAttribute
@NameValue
@Description("The ID of this POAManager")
public int getManagerId()

getORTState

@ManagedAttribute
@Description("The ObjectReferenceTemplate state of this POAManager")
public short getORTState()

activate

@ManagedOperation
@Description("Make this POAManager active, so it can handle new requests")
public void activate()
              throws AdapterInactive

activate Spec: pages 3-14 thru 3-18

Specified by:

activate in interface POAManagerOperations

Throws:

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

hold_requests

@ManagedOperation
@Description("Hold all requests to this POAManager")
public void hold_requests(boolean wait_for_completion)
                   throws AdapterInactive

hold_requests Spec: pages 3-14 thru 3-18

Specified by:

hold_requests in interface POAManagerOperations

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

@ManagedOperation
@ParameterNames("waitForCompletion")
@Description("Make this POAManager discard all incoming requests")
public void discard_requests(boolean wait_for_completion)
                      throws AdapterInactive

discard_requests Spec: pages 3-14 thru 3-18

Specified by:

discard_requests in interface POAManagerOperations

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

public void deactivate(boolean etherealize_objects,
 boolean wait_for_completion)
                throws AdapterInactive

deactivate Spec: pages 3-14 thru 3-18 Note: INACTIVE is a permanent state.

Specified by:

deactivate in interface POAManagerOperations

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

public State get_state()

Added according to the spec CORBA V2.3; this returns the state of the POAManager

Specified by:

get_state in interface POAManagerOperations

Returns:

the state of the manager

implicitActivation

public void implicitActivation()

Activate the POAManager if no explicit state change has ever been previously invoked.