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
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
|
//==========================================================================
/**
* @file nsgroup_svc.h
*
* @author Phillip LaBanca <labancap@ociweb.com>
*/
//==========================================================================
#ifndef i_nsgroup_svc_h
#define i_nsgroup_svc_h
#include "orbsvcs/FT_NamingManagerC.h"
#include /**/ "orbsvcs/Naming/FaultTolerant/ftnaming_intf_export.h"
TAO_BEGIN_VERSIONED_NAMESPACE_DECL
/**
* @class NS_group_svc
*
* @brief Encapsulate the NS group operations in a class.
*
*
*/
class TAO_FtNaming_Intf_Export NS_group_svc
{
public:
/**
* Constructor
*/
NS_group_svc (bool quiet = false);
/**
* The naming service shall provide a command line utility for creating
* object groups.
*
* @param group group name
* @param policy round
*
* @return 0 on success, -1 on failure, -2 on bad argument.
*/
int group_create (const ACE_TCHAR* group, const ACE_TCHAR* policy);
/**
* The naming service shall provide a command line utility for binding an
* object group to a path in the naming service.
*
* @param group group name
* @param path stringified name in the naming service
*
* @return 0 on success, -1 on failure, -2 on bad argument.
*/
int group_bind (const ACE_TCHAR* group, const ACE_TCHAR* path);
/**
* @param group group name
* @param path stringified name in the naming service
*
* @return 0 on success, -1 on failure, -2 on bad argument.
*/
int group_unbind (const ACE_TCHAR* path);
/**
* The naming service shall provide a command line utility to display all
* defined object groups within the naming service.
*
* @return 0 on success, -1 on failure, -2 on bad argument.
*/
int group_list (void);
/**
* The naming service shall provide a command line utility to modify the load
* balancing strategy for a specified object group.
*
* @param group group name
* @param policy round
*
* @return 0 on success, -1 on failure, -2 on bad argument.
*/
int group_modify (const ACE_TCHAR* group, const ACE_TCHAR* policy);
/**
* The naming service shall provide a command line utility to remove a
* specified object group from the naming service.
*
* @param group group name
*
* @return 0 on success, -1 on failure, -2 on bad argument.
*/
int group_remove (const ACE_TCHAR* group);
/**
* The naming service shall provide a command line utility for adding object
* references to an object group.
*
* @param group group name
* @param location member location string
* @param ior member stringified ior
*
* @return 0 on success, -1 on failure, -2 on bad argument.
*/
int member_add (const ACE_TCHAR* group,
const ACE_TCHAR* location,
const ACE_TCHAR* ior);
/**
* The naming service shall provide a command line utility for displaying all
* members (object references) for a specified object group.
*
* @param group group name
*
* @return 0 on success, -1 on failure, -2 on bad argument.
*/
int member_list (const ACE_TCHAR* group);
/**
* The naming service shall provide a command line utility for removing
* object references from an object group.
*
* @param group group name
* @param location member location string
*
* @return 0 on success, -1 on failure, -2 on bad argument.
*/
int member_remove (const ACE_TCHAR* group, const ACE_TCHAR* location);
/**
* The naming service shall provide a command line utility to display an
* object reference from a specified object group.
*
* @param group group name
* @param location member location string
*
* @return zero for success; nonzero for failure.
*/
int member_show (const ACE_TCHAR* group, const ACE_TCHAR* location);
/**
* @param group group name
*
* @return true if the specified object group name is found
*/
bool group_exist (const ACE_TCHAR* group_name);
/**
* @return 0 on success, -1 on failure.
*/
int set_orb( CORBA::ORB_ptr value);
/**
* @return 0 on success, -1 on failure.
*/
int set_naming_manager( FT_Naming::NamingManager_ptr value);
/**
* @return 0 on success, -1 on failure.
*/
int set_name_context( CosNaming::NamingContextExt_ptr value);
private:
/**
* determine strategy based on policy string
*
* @param const ACE_TCHAR *policy ["round"]
* @param FT_Naming::LoadBalancingStrategyValue& value
* @return true on success, false on failure.
*/
bool determine_policy_string (
const ACE_TCHAR *policy,
FT_Naming::LoadBalancingStrategyValue& value);
/**
* @return 0 on success, -1 on failure.
*/
int display_load_policy_group (
FT_Naming::LoadBalancingStrategyValue strategy,
const ACE_TCHAR *display_label);
private:
FT_Naming::NamingManager_var naming_manager_;
CosNaming::NamingContextExt_var name_service_;
CORBA::ORB_var orb_;
bool quiet_;
};
TAO_END_VERSIONED_NAMESPACE_DECL
#endif
|
