com.iona.corbautil
Class PoaUtilityOrbixImpl

java.lang.Object
  |
  +--com.iona.corbautil.PoaUtility
        |
        +--com.iona.corbautil.PoaUtilityPortableImpl
              |
              +--com.iona.corbautil.PoaUtilityOrbixImpl

public class PoaUtilityOrbixImpl
extends PoaUtilityPortableImpl

Orbix-specific class that simplifies the construction of POA hierarchies. An instance of this class is created by calling PoaUtility.init(), subject to system properties having appropriate values.


Field Summary
 
Fields inherited from class com.iona.corbautil.PoaUtilityPortableImpl
m_orb
 
Fields inherited from class com.iona.corbautil.PoaUtility
FIXED_PORTS_NO_IMR, FIXED_PORTS_WITH_IMR, RANDOM_PORTS_NO_IMR, RANDOM_PORTS_WITH_IMR
 
Constructor Summary
PoaUtilityOrbixImpl(org.omg.CORBA.ORB orb, int deployModel)
          This constructor is not intended to be called by "normal" user code.
 
Method Summary
 com.iona.corbautil.LabelledOrbixWorkQueue createAutoWorkQueue(java.lang.String label, int max_size, int initial_thread_count, int high_water_mark, int low_water_mark)
          Create a labelled Orbix-proprietary work queue.
 com.iona.corbautil.LabelledOrbixWorkQueue createManualWorkQueue(java.lang.String label, int max_size)
          Create a labelled Orbix-proprietary work queue.
 org.omg.PortableServer.POA createPoa(java.lang.String poaName, org.omg.PortableServer.POA parentPoa, com.iona.corbautil.LabelledPOAManager labelledMgr, java.lang.String policiesStr, com.iona.corbautil.LabelledOrbixWorkQueue labelledWq)
          Create a POA.
protected  org.omg.CORBA.Policy createPolicy(java.lang.String name, java.lang.String policiesStr)
          Create a Policy object from the stringified name
protected  org.omg.CORBA.Policy[] createPolicyList(java.lang.String poaMgrLabel, java.lang.String policiesStr)
          Create an array of Policy objects from the stringified list
 
Methods inherited from class com.iona.corbautil.PoaUtilityPortableImpl
createPoa, createPoaManager, deployModel, firstPoaMgr, firstPoaMgr, orb, root
 
Methods inherited from class com.iona.corbautil.PoaUtility
init, stringToDeploymentModel
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

PoaUtilityOrbixImpl

public PoaUtilityOrbixImpl(org.omg.CORBA.ORB orb,
                           int deployModel)
                    throws PoaUtilityException
This constructor is not intended to be called by "normal" user code. Instead, it is called by PoaUtility.init(), subject to system properties.

Parameters:
orb - The ORB.
Method Detail

createPoa

public org.omg.PortableServer.POA createPoa(java.lang.String poaName,
                                            org.omg.PortableServer.POA parentPoa,
                                            com.iona.corbautil.LabelledPOAManager labelledMgr,
                                            java.lang.String policiesStr,
                                            com.iona.corbautil.LabelledOrbixWorkQueue labelledWq)
                                     throws PoaUtilityException
Create a POA.

Parameters:
poaName - Name of the POA being created
parentPoa - The parent POA
labelledMgr - The (labelled) POA Manager (previously created by calling createPoaManager()
policiesStr - A string that lists the policies to be used for the POA, for example, "persistent + user_id + retain". Individual policies are spelt just as in the CORBA specification, except that they are in lowercase. Any combination of spaces, commas and/or plus-signs can be used as separators between policy names.
Returns:
The newly created POA.
PoaUtilityException

createAutoWorkQueue

public com.iona.corbautil.LabelledOrbixWorkQueue createAutoWorkQueue(java.lang.String label,
                                                                     int max_size,
                                                                     int initial_thread_count,
                                                                     int high_water_mark,
                                                                     int low_water_mark)
                                                              throws PoaUtilityException
Create a labelled Orbix-proprietary work queue.

Parameters:
label - The label that is to be associated with the newly created work queue.
max_size - See Orbix documentation for details.
initial_thread_count - See Orbix documentation for details.
high_water_mark - See Orbix documentation for details.
low_water_mark - See Orbix documentation for details.
Returns:
The newly created automatic work queue.
PoaUtilityException

createManualWorkQueue

public com.iona.corbautil.LabelledOrbixWorkQueue createManualWorkQueue(java.lang.String label,
                                                                       int max_size)
                                                                throws PoaUtilityException
Create a labelled Orbix-proprietary work queue.

Parameters:
label - The label that is to be associated with the newly created work queue.
max_size - See Orbix documentation for details.
Returns:
The newly created manual work queue.
PoaUtilityException

createPolicyList

protected org.omg.CORBA.Policy[] createPolicyList(java.lang.String poaMgrLabel,
                                                  java.lang.String policiesStr)
                                           throws PoaUtilityException
Create an array of Policy objects from the stringified list

Overrides:
createPolicyList in class PoaUtilityPortableImpl
Parameters:
poaMgrLabel - The label of the POA Manager that will control the POA created with these policy values.
policiesStr - A stringified list of policy names, for example "persistent + user_id + retain". The name of an individual policy is just like the spelling used in the CORBA specification execept that it is in lower-case. Any combination of spaces, command and/or plus-signs can be used as separators between the policy names.
Returns:
The created array of Policy objects.
PoaUtilityException

createPolicy

protected org.omg.CORBA.Policy createPolicy(java.lang.String name,
                                            java.lang.String policiesStr)
                                     throws PoaUtilityException
Create a Policy object from the stringified name

Overrides:
createPolicy in class PoaUtilityPortableImpl
Parameters:
name - The name of a policy, for example, "persistent", "user_id" or "retain". The name of an individual policy is identical to the spelling used in the CORBA specification execept that it is in lower-case.
policiesStr - The full stringified list of policy names from which the specified name has been extacted. This parameter is used only for formating a useful Exception message if an error occurs.
Returns:
The created Policy object.
PoaUtilityException