BoilerPlate: Reusable CORBA

ServantFactory_Activator Class Reference

#include <ServantFactory_Activator.h>

Inheritance diagram for ServantFactory_Activator:

List of all members.

---

Detailed Description

Foundation for a POA with a ServantActivator.

Contains the semantics required for building a POA that uses a ServantActivator. Subclass this class when you want to implement a ServantActivator

Public Member Functions
	ServantFactory_Activator (std::string the_name)
	ServantFactory_Activator (std::string the_name, bool isSingleThreaded, bool useSystemId)
	ServantFactory_Activator (const char *the_name)
	ServantFactory_Activator (const char *the_name, bool isSingleThreaded, bool useSystemId)
virtual	~ServantFactory_Activator ()
	dtor
virtual void	build (CORBA::ORB_ptr orb, PortableServer::POA_ptr poa) throw (ServantFactory::ServantBuildException)
PortableServer::POA_ptr	local_poa_nc ()
virtual const std::string	poa_name_string () const
virtual const char *	poa_name () const
void	setNsServantIdMap (ConfMap &_n)
Protected Member Functions
virtual void	build_activator (CORBA::ORB_ptr orb, PortableServer::POA_ptr poa)=0 throw (ServantFactory::ServantBuildException)
void	local_poa (PortableServer::POA_ptr poa)
const PortableServer::POA_ptr	parent_poa_nc ()
void	parent_poa (PortableServer::POA_ptr poa)
const CORBA::ORB_ptr	local_orb_nc ()
void	local_orb (CORBA::ORB_ptr orb)
Protected Attributes
ConfMap	nsServantIdMap

---

Constructor & Destructor Documentation

ServantFactory_Activator::ServantFactory_Activator (  std::string  the_name  )

ctor Parameters: the_name  to use as the POA name Note: ThreadPolicy defaults to ORB_CTRL_MODEL IdAssignmentPolicy defaults to USER_ID

ServantFactory_Activator::ServantFactory_Activator (  std::string  the_name, bool  isSingleThreaded, bool  useSystemId )

CTOR Parameters: the_name  to use as the POA name isSingleThreaded  if TRUE, this POA will be single threaded. Default is ORB_CTRL_MODEL useSystemId  if TRUE, this POA will have an IdAssignment Policy of SYSTEM_ID. Default is USER_ID.

ServantFactory_Activator::ServantFactory_Activator (  const char *  the_name  )

ctor Parameters: the_name  of this POA as const char* Note: ThreadPolicy defaults to ORB_CTRL_MODEL IdAssignmentPolicy defaults to USER_ID

ServantFactory_Activator::ServantFactory_Activator (  const char *  the_name, bool  isSingleThreaded, bool  useSystemId )

ctor Parameters: the_name  of this POA as const char* isSingleThreaded  if TRUE, this POA will be single threaded. Default is ORB_CTRL_MODEL useSystemId  if TRUE, this POA will have an IdAssignment Policy of SYSTEM_ID. Default is USER_ID.

virtual ServantFactory_Activator::~ServantFactory_Activator (   )  [virtual]

dtor

---

Member Function Documentation

virtual void ServantFactory_Activator::build (  CORBA::ORB_ptr  orb, PortableServer::POA_ptr  poa )  throw (ServantFactory::ServantBuildException) [virtual]

Initiate the build process The caller initiates creation of the POA and provisioning the ServantActivator. Called by OrbInit Parameters: orb  - A _ptr to the system ORB. Copy it into a _var if you need to keep a copy in your subclass poa  - A _ptr to the this factory's parent POA Exceptions: ServantFactory::ServantBuildException  Precondition: The approprate ORB and parent POA have been initialized Postcondition: The POA local to this Factory and the ServantActivator have been properly instantiated and registered. Implements ServantFactory.

virtual void ServantFactory_Activator::build_activator (  CORBA::ORB_ptr  orb, PortableServer::POA_ptr  poa )  throw (ServantFactory::ServantBuildException) [protected, pure virtual]

Responsible for instantiating the Activator Responsibility is delegated to this operation to instance and registering the Activator. This operation is called by ::build operation. Note: Your ServantFactory subclass must implement this operation. Parameters: orb  - This Activator's ORB poa  - This Activator's POA Exceptions: BuildException  Precondition: The local POA has been appropriately instanced and configured Postcondition: The Activator has been instanced and registered

void ServantFactory::local_orb (  CORBA::ORB_ptr  orb  )  [protected, inherited]

Set this Factory's orb Parameters: orb  - This Factory's reference to the system ORB Postcondition: _orb = _duplicate(orb)

const CORBA::ORB_ptr ServantFactory::local_orb_nc (   )  [protected, inherited]

Access the factory's ORB Operation does not return a copy; the caller should not deallocate Returns: _orb as ORB_ptr (DO NOT DEALLOCATE)

void ServantFactory::local_poa (  PortableServer::POA_ptr  poa  )  [protected, inherited]

Set the local POA instance Parameters: poa  as POA_ptr Postcondition: _poa = _duplicate(poa)

PortableServer::POA_ptr ServantFactory::local_poa_nc (   )  [inherited]

Obtain a reference to the POA local to this factory. Non-copying version; caller should NOT deallocate Returns: local_poa as POA_ptr (DO NOT DEALLOCATE)

void ServantFactory::parent_poa (  PortableServer::POA_ptr  poa  )  [protected, inherited]

Set this Factory's parent POA Parameters: poa  -- A _ptr to this Factory's parent POA

const PortableServer::POA_ptr ServantFactory::parent_poa_nc (   )  [protected, inherited]

Access the POA that is the parent of the local POA Operation does not return a copy; the caller should not deallocate Returns: parent_poa as POA_ptr (DO NOT DEALLOCATE)

virtual const char* ServantFactory::poa_name (   )  const [inline, virtual, inherited]

Obtain the name of the local POA Returns the name of the POA local to this factory Returns: name as const char* Note: The caller is responsible for the memory

virtual const std::string ServantFactory::poa_name_string (   )  const [inline, virtual, inherited]

Obtain the name of the local POA Returns the name of the POA local to this factory Returns: name as std::string

void ServantFactory::setNsServantIdMap (  ConfMap &  _n  )  [inherited]

Set the configuration map Parameters: _n  - The configuration map

---

Member Data Documentation

ConfMap ServantFactory::nsServantIdMap [protected, inherited]

Author: gg Date: March, 04 The nsServantIdMap is used to store command line variables and values in an association array. All command line arguments prefixed with -BP will be put into the map.

---

The documentation for this class was generated from the following file:

• ServantFactory_Activator.h

---