blob: 920b0155f1cf331a337b72b7b79fc0345a54f98d (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
|
// -*- C++ -*-
//=============================================================================
/**
* @file Object_Ref_Table.h
*
* $Id$
*
* @author Ossama Othman <ossama@uci.edu>
*/
//=============================================================================
#ifndef TAO_OBJECT_REF_TABLE_H
#define TAO_OBJECT_REF_TABLE_H
#include /**/ "ace/pre.h"
#include "ace/CORBA_macros.h"
#if !defined (ACE_LACKS_PRAGMA_ONCE)
# pragma once
#endif /* ACE_LACKS_PRAGMA_ONCE */
#include "tao/CORBA_String.h"
#include "tao/Object.h"
#include /**/ "tao/TAO_Export.h"
#include "tao/orbconf.h"
#include "ace/Array_Map.h"
TAO_BEGIN_VERSIONED_NAMESPACE_DECL
namespace CORBA
{
class Environment;
}
/**
* @class TAO_Object_Ref_Table
*
* @brief 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.
*/
class TAO_Export TAO_Object_Ref_Table
{
public:
typedef ACE_Array_Map<CORBA::String_var,
CORBA::Object_var,
TAO::String_Var_Equal_To> Table;
typedef Table::iterator iterator;
/// Constructor
TAO_Object_Ref_Table (void);
/**
* Register an object reference with the table, and map the given
* ID to it.
* @retval 0 Success
* @retval -1 Duplicate id if @c rebind is false
*/
int register_initial_reference (const char * id,
CORBA::Object_ptr obj,
bool rebind = false);
/// Return the object reference associated with the given ID.
/// A duplicate is returned.
CORBA::Object_ptr resolve_initial_reference (const char * id);
/// Explicitly destroy the contents of the object reference table.
void destroy (void);
/**
* @name Forward Iterators
*/
//@{
iterator begin (void);
iterator end (void);
//@}
/// Return the current size of the underlying table.
size_t current_size (void) const;
private:
/**
* @name The canonical ACE_Map methods
*/
//@{
int bind (const char *orb_id, CORBA::Object_ptr obj);
CORBA::Object_ptr find (const char *orb_id); // Returns a duplicate.
int unbind (const char *orb_id);
//@}
private:
// Disallow copying and assignment.
TAO_Object_Ref_Table (const TAO_Object_Ref_Table &);
void operator= (const TAO_Object_Ref_Table &);
private:
/// The implementation.
Table table_;
/// Table synchronization lock.
TAO_SYNCH_MUTEX lock_;
};
TAO_END_VERSIONED_NAMESPACE_DECL
#ifdef __ACE_INLINE__
# include "tao/Object_Ref_Table.inl"
#endif /* __ACE_INLINE__ */
#include /**/ "ace/post.h"
#endif /* TAO_OBJECT_REF_TABLE_H */
|
