blob: 30eca509c82ce081c6391b46edcb9a5613ed0535 (
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
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
|
// -*- C++ -*-
//=============================================================================
/**
* @file ORB_Table.h
*
* $Id$
*
* @author Ossama Othman <ossama@uci.edu>
* @author Carlos O'Ryan <coryan@uci.edu>
*/
//=============================================================================
#ifndef TAO_ORB_TABLE_H
#define TAO_ORB_TABLE_H
#include /**/ "ace/pre.h"
#include "tao/TAO_Export.h"
#if !defined (ACE_LACKS_PRAGMA_ONCE)
# pragma once
#endif /* ACE_LACKS_PRAGMA_ONCE */
#include "tao/orbconf.h"
#include "ace/Hash_Map_Manager_T.h"
#include "ace/Thread_Mutex.h"
#include "ace/Null_Mutex.h"
// Forward declarations.
class TAO_ORB_Core;
namespace TAO
{
/**
* @class ORB_Table
*
* @brief 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!
*/
class TAO_Export ORB_Table
{
public:
/// Constructor
/**
* @note See the note in the class description for an explanation
* of why this constructor is not protected.
*/
ORB_Table (void);
/// destructor
~ORB_Table (void);
typedef ACE_Hash_Map_Manager_Ex<const char *, TAO_ORB_Core *, ACE_Hash<const char *>, ACE_Equal_To<const char *>, ACE_Null_Mutex> Table;
typedef Table::iterator Iterator;
/// The canonical ACE_Map methods.
//@{
Iterator begin (void);
Iterator end (void);
int bind (const char *orb_id, TAO_ORB_Core *orb_core);
/**
* @note The caller must decrease the reference count on the
* returned ORB_Core, i.e. the callers "owns" it.
*/
TAO_ORB_Core* find (const char *orb_id);
int unbind (const char *orb_id);
//@}
TAO_ORB_Core * const * get_orbs (size_t& num_orbs);
/// Obtain the first ORB for the @c ORB_Core_instance()
/// implementation.
TAO_ORB_Core * first_orb (void);
/// Return a unique instance
static ORB_Table * instance (void);
/// Set the ORB related to the orb_id as the default ORB and not the
/// ORB that is first binded.
void set_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 not_default (char const * orb_id);
/// Accessor to the underlying table_
Table * table (void);
private:
// Prevent copying
ORB_Table (const ORB_Table &);
void operator= (const ORB_Table &);
/// Update our list of orbs
void update_orbs (void);
private:
/// Lock used to synchronize access to the internal state.
TAO_SYNCH_MUTEX lock_;
/// Variable to check if the first ORB decides not to be the
/// default.
bool first_orb_not_default_;
/// The underlying table.
Table table_;
/// The first ORB created by the user
TAO_ORB_Core * first_orb_;
/// List of orbs for get_orbs call
TAO_ORB_Core ** orbs_;
/// Number of ORBs in the table.
size_t num_orbs_;
};
}
#if defined (__ACE_INLINE__)
# include "tao/ORB_Table.inl"
#endif /* __ACE_INLINE__ */
#include /**/ "ace/post.h"
#endif /* TAO_ORB_TABLE_H */
|
