org.omg.PortableServer
Interface POAManagerFactoryOperations

All Known Subinterfaces:

POAManagerFactory

public interface POAManagerFactoryOperations

POAManagers can be created implicitly, by passing a nil POAManager reference to the create_POA operation, or can be created explicitly using a POAManagerFactory. Explicit creation of a POAManager permits application control of the POAManager's identity, whereas implicit creation results in creation of a unique identity by the ORB run time. Explicit creation of a POAManager also permits the application to assign policies to the new POAManager.

Method Summary

POAManager	create_POAManager(java.lang.String id, Policy[] policies) This operation creates a new POAManager with the given id.
POAManager	find(java.lang.String id) The find operation return the POAManager with the specified id.
POAManager[]	list() The list operation returns all POAManagers (whether created implicitly or explicitly) that currently exist within the ORB.

Method Detail

find

POAManager find(java.lang.String id)

The find operation return the POAManager with the specified id. If no such POAManager exists, find returns a nil reference.

list

POAManager[] list()

The list operation returns all POAManagers (whether created implicitly or explicitly) that currently exist within the ORB.

create_POAManager

POAManager create_POAManager(java.lang.String id,
                             Policy[] policies)
                             throws ManagerAlreadyExists,
                                    PolicyError

This operation creates a new POAManager with the given id. If a POAManager with the given id exists already within the ORB, the operation raises ManagerAlreadyExists. (Note that placing a POAManager into the inactive state does not necessarily result in destruction of the POAManager because destruction of a POAManager only occurs once the last of its POAs has been destroyed. create_POAManager succeeds in creation of a new POAManager with the same identity as a previous POAManager only once the previous POAManager's POAs are destroyed.) The policies parameter permits an arbitrary number of policies to be passed; these policies can be used by an ORB implementation to influence the POAManager's behavior in some way; for example, an ORB may choose to use this mechanism to pass configuration information to the factory. The policies passed to create_POAManager are deep-copied during creation; modification of a policy sequence after creation has therefore no effect on already existing POAManagers. If one or more of the policies are invalid, create_POAManager raises CORBA::PolicyError. The newly created POAManager is in the Holding state.

Throws:

ManagerAlreadyExists

PolicyError