blob: 2381e1b7f430416beaddf62c807b68cd7bd1f4a7 (
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 "tao/orbconf.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 "ace/Array_Map.h"
TAO_BEGIN_VERSIONED_NAMESPACE_DECL
/**
* @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);
/**
* Unregister an object reference with the table
*/
CORBA::Object_ptr unregister_initial_reference (const char * id);
/// 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_i (const char *orb_id, CORBA::Object_ptr obj);
CORBA::Object_ptr find_i (const char *orb_id); // Returns a duplicate.
int unbind_i (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 */
|
