TAO  2.3.3
Public Types | Public Member Functions | Private Member Functions | Private Attributes | List of all members
TAO_Object_Ref_Table Class Reference

Keep a table de-stringified object references registered with the ORB. More...

#include <Object_Ref_Table.h>

Collaboration diagram for TAO_Object_Ref_Table:
Collaboration graph
[legend]

Public Types

typedef ACE_Array_Map< CORBA::String_var, CORBA::Object_var, TAO::String_Var_Equal_ToTable
 
typedef Table::iterator iterator
 

Public Member Functions

 TAO_Object_Ref_Table (void)
 Constructor. More...
 
int register_initial_reference (const char *id, CORBA::Object_ptr obj, bool rebind=false)
 
CORBA::Object_ptr unregister_initial_reference (const char *id)
 
CORBA::Object_ptr resolve_initial_reference (const char *id)
 
void destroy (void)
 Explicitly destroy the contents of the object reference table. More...
 
size_t current_size (void) const
 Return the current size of the underlying table. More...
 
Forward Iterators
iterator begin (void)
 
iterator end (void)
 

Private Member Functions

 TAO_Object_Ref_Table (const TAO_Object_Ref_Table &)
 
void operator= (const TAO_Object_Ref_Table &)
 
The canonical ACE_Map methods
int bind_i (const char *orb_id, CORBA::Object_ptr obj)
 
CORBA::Object_ptr find_i (const char *orb_id)
 
int unbind_i (const char *orb_id)
 

Private Attributes

Table table_
 The implementation. More...
 
TAO_SYNCH_MUTEX lock_
 Table synchronization lock. More...
 

Detailed Description

Keep a table de-stringified object references registered with the ORB.

The class is necessary to allow local objects to be accessible via the resolve_initial_references() mechanism. Since local object references cannot be stringified, they cannot be placed into the initial reference map that maps object key/name to stringified object reference. Hence, another table is needed.

Note
The stringified reference table is still needed since it is sometimes necessary to delay de-stringification of an IOR until it is needed. For example, "corbaname" may return different results on each use.

Member Typedef Documentation

Constructor & Destructor Documentation

TAO_Object_Ref_Table::TAO_Object_Ref_Table ( void  )

Constructor.

TAO_Object_Ref_Table::TAO_Object_Ref_Table ( const TAO_Object_Ref_Table )
private

Member Function Documentation

TAO_Object_Ref_Table::iterator TAO_Object_Ref_Table::begin ( void  )
int TAO_Object_Ref_Table::bind_i ( const char *  orb_id,
CORBA::Object_ptr  obj 
)
private
size_t TAO_Object_Ref_Table::current_size ( void  ) const

Return the current size of the underlying table.

void TAO_Object_Ref_Table::destroy ( void  )

Explicitly destroy the contents of the object reference table.

TAO_Object_Ref_Table::iterator TAO_Object_Ref_Table::end ( void  )
CORBA::Object_ptr TAO_Object_Ref_Table::find_i ( const char *  orb_id)
private
void TAO_Object_Ref_Table::operator= ( const TAO_Object_Ref_Table )
private
int TAO_Object_Ref_Table::register_initial_reference ( const char *  id,
CORBA::Object_ptr  obj,
bool  rebind = false 
)

Register an object reference with the table, and map the given ID to it.

Return values
0Success
-1Duplicate id if rebind is false
CORBA::Object_ptr TAO_Object_Ref_Table::resolve_initial_reference ( const char *  id)

Return the object reference associated with the given ID. A duplicate is returned.

int TAO_Object_Ref_Table::unbind_i ( const char *  orb_id)
private
CORBA::Object_ptr TAO_Object_Ref_Table::unregister_initial_reference ( const char *  id)

Unregister an object reference with the table

Member Data Documentation

TAO_SYNCH_MUTEX TAO_Object_Ref_Table::lock_
private

Table synchronization lock.

Table TAO_Object_Ref_Table::table_
private

The implementation.


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