BoilerPlate: Reusable CORBA

ServantFactory_Simple Class Reference

#include <ServantFactory_Simple.h>

Inheritance diagram for ServantFactory_Simple:

List of all members.

---

Detailed Description

This servant factory is used to instance the simple POA model.

The simple model is a multithreaded poa, active object map, and servants that is activated for the life of the process.

• LifespanPolicy PERSISTENT
• ServantRetentionPolicy RETAIN
• RequestProcessingPolicy USE_ACTIVE_OBJECT_MAP_ONLY
• ImplicitActivationPolicy NO_IMPLICIT_ACTIVATION
• IdAssignmentPolicy USER_ID. Can be overridden using ctor parameter
• Threading Policy ORB_CONTROL_MODEL. Can be overridden using ctor parameter

Public Member Functions
	ServantFactory_Simple (std::string the_name)
	ServantFactory_Simple (std::string the_name, bool isSingleThreaded, bool useSystemId)
	ServantFactory_Simple (const char *the_name)
	ServantFactory_Simple (const char *the_name, bool isSingleThreaded, bool useSystemId)
virtual	~ServantFactory_Simple ()
	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_servants (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_Simple::ServantFactory_Simple (  std::string  the_name  )

ctor Parameters: the_name  This POAs name Note: Thread Policy defaults to ORB_CTRL_MODEL IdAssignmentPolicy defaults to USER_ID

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

ctor Parameters: the_name  This POAs name as std::string isSingleThreaded  If TRUE then this POA uses SINGLE_THREAD_MODEL useSystemId  If TRUE this POA uses SYSTEM_ID Default is USER_ID

ServantFactory_Simple::ServantFactory_Simple (  const char *  the_name  )  [explicit]

ctor Parameters: the_name  This POAs name Note: Thread Policy defaults to ORB_CTRL_MODEL IdAssignmentPolicy defaults to USER_ID

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

ctor Parameters: the_name  This POAs name as a const char* isSingleThreaded  If TRUE then this POA uses SINGLE_THREAD_MODEL useSystemId  If TRUE this POA uses SYSTEM_ID Default is USER_ID

virtual ServantFactory_Simple::~ServantFactory_Simple (   )  [virtual]

dtor

---

Member Function Documentation

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

Initiates the creation sequence. Called to create the POA and provision the Servants Parameters: orb  poa  Exceptions: ServantFactory::ServantBuildException  Precondition: the appropriate ORB and parent POA are initialized Implements ServantFactory.

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

Initiate the sequence that provisions servants The Servants that are provisioned by this factory are built when this operation is called. An implmentation of a Simple Servant Factory must implement this operation and provision the POA's servants in it. Parameters: orb  The ORB to use when instancing Servants poa  The POA to use when instancing and activating Servants Exceptions: ServantFactory::ServantBuildException  Precondition: The approprate ORB and parent POA have been initialized Postcondition: The POA local to this Factory and the ServantLocator have been properly instantiated 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_Simple.h

---