TAO::ORB_Table Class Reference

Keep a table with all the ORBs in the system. More...

#include <ORB_Table.h>

Collaboration diagram for TAO::ORB_Table:

[legend]List of all members.

Public Types
typedef ACE_Array_Map< CORBA::String_var, ORB_Core_Ref_Counter, TAO::String_Var_Equal_To >	Table
typedef Table::key_type	key_type
typedef Table::data_type	data_type
typedef Table::value_type	value_type
typedef Table::size_type	size_type
typedef Table::iterator	iterator
Public Member Functions
	ORB_Table (void)
	Constructor.
TAO_ORB_Core *const *	get_orbs (size_t &num_orbs)
TAO_ORB_Core *	first_orb (void)
void	set_default (char const *orb_id)
void	not_default (char const *orb_id)
Table *	table (void)
	Accessor to the underlying table_.
iterator	begin (void)
iterator	end (void)
int	bind (const char *orb_id, TAO_ORB_Core *orb_core)
TAO_ORB_Core *	find (const char *orb_id)
int	unbind (const char *orb_id)
Static Public Member Functions
ORB_Table *	instance (void)
	Return a unique instance.
Private Member Functions
	ORB_Table (const ORB_Table &)
void	operator= (const ORB_Table &)
TAO_ORB_Core *	find_i (char const *orb_id)
void	update_orbs (void)
	Update our list of orbs.
Private Attributes
TAO_SYNCH_MUTEX	lock_
	Lock used to synchronize access to the internal state.
bool	first_orb_not_default_
Table	table_
	The underlying table.
TAO_ORB_Core *	first_orb_
	The first ORB created by the user.
TAO_ORB_Core **	orbs_
	List of orbs for get_orbs call.
size_t	num_orbs_
	Number of ORBs in the table.

---

Detailed Description

Keep a table with all the ORBs in the system.

CORBA::ORB_init() is supposed to return the same ORB if the user specifies the same ORBid, either in the ORB_init() parameter or in the -ORBid option. This class is used to implement that feature. It is also useful when trying to determine if an object reference is collocated or not.

Note:

This class should be instantiated via its instance() method. Normally this would be enforced by making the constructor protected but that forces a friend declaration containing a template type (TAO_Singleton) with a static member to be introduced. In turn, this potentially introduces problems in MS Windows DLL environments due to the occurance of multiple singleton instances. There should only be one!

---

Member Typedef Documentation

typedef Table::data_type TAO::ORB_Table::data_type

typedef Table::iterator TAO::ORB_Table::iterator

typedef Table::key_type TAO::ORB_Table::key_type

typedef Table::size_type TAO::ORB_Table::size_type

typedef ACE_Array_Map<CORBA::String_var, ORB_Core_Ref_Counter, TAO::String_Var_Equal_To> TAO::ORB_Table::Table

typedef Table::value_type TAO::ORB_Table::value_type

---

Constructor & Destructor Documentation

TAO::ORB_Table::ORB_Table (  void   )

Constructor. Note: See the note in the class description for an explanation of why this constructor is not protected.

TAO::ORB_Table::ORB_Table (  const ORB_Table &   )  [private]

---

Member Function Documentation

ACE_INLINE TAO::ORB_Table::iterator TAO::ORB_Table::begin (  void   )

int TAO::ORB_Table::bind (  const char *  orb_id, TAO_ORB_Core *  orb_core )

ACE_INLINE TAO::ORB_Table::iterator TAO::ORB_Table::end (  void   )

TAO_ORB_Core * TAO::ORB_Table::find (  const char *  orb_id  )

Note: The caller must decrease the reference count on the returned ORB_Core, i.e. the callers "owns" it.

TAO_ORB_Core* TAO::ORB_Table::find_i (  char const *  orb_id  )  [private]

Return TAO_ORB_Core corresponding to ORB with given orb_id. (underlying unlocked implementation).

ACE_INLINE TAO_ORB_Core * TAO::ORB_Table::first_orb (  void   )

Obtain the first ORB for the ORB_Core_instance() implementation.

ACE_INLINE TAO_ORB_Core *const * TAO::ORB_Table::get_orbs (  size_t &  num_orbs  )

TAO::ORB_Table * TAO::ORB_Table::instance (  void   )  [static]

Return a unique instance.

void TAO::ORB_Table::not_default (  char const *  orb_id  )

Method the ORB invokes to specify that it doesnt want to be the default ORB if there are more than one ORB registered.

void TAO::ORB_Table::operator= (  const ORB_Table &   )  [private]

void TAO::ORB_Table::set_default (  char const *  orb_id  )

Set the ORB related to the orb_id as the default ORB and not the ORB that is first binded.

ACE_INLINE TAO::ORB_Table::Table * TAO::ORB_Table::table (  void   )

Accessor to the underlying table_.

int TAO::ORB_Table::unbind (  const char *  orb_id  )

void TAO::ORB_Table::update_orbs (  void   )  [private]

Update our list of orbs. Todo: Where the implementation for ORB_Table::update_orbs?

---

Member Data Documentation

TAO_ORB_Core* TAO::ORB_Table::first_orb_ [private]

The first ORB created by the user.

bool TAO::ORB_Table::first_orb_not_default_ [private]

Variable to check if the first ORB decides not to be the default.

TAO_SYNCH_MUTEX TAO::ORB_Table::lock_ [private]

Lock used to synchronize access to the internal state.

size_t TAO::ORB_Table::num_orbs_ [private]

Number of ORBs in the table.

TAO_ORB_Core** TAO::ORB_Table::orbs_ [private]

List of orbs for get_orbs call. Todo: ORB_Table::orbs_ appears to be unused. Remove it?

Table TAO::ORB_Table::table_ [private]

The underlying table.

---

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

• ORB_Table.h
• ORB_Table.cpp
• ORB_Table.inl

---