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
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
|
/* -*- C++ -*- */
// ========================================================================
// $Id$
//
// = LIBRARY
// orbsvcs
//
// = FILENAME
// Admin.h
//
// = AUTHOR
// Marina Spivak <marina@cs.wustl.edu>
// Seth Widoff <sbw1@cs.wustl.edu>
// Irfan Pyarali <irfan@cs.wustl.edu>
//
// ========================================================================
#ifndef TAO_ADMIN_H
#define TAO_ADMIN_H
#include "CosTradingS.h"
#include "Offer_Id_Iterator.h"
template <class TRADER>
class TAO_Admin : public POA_CosTrading::Admin
//
// = TITLE
// This class implements CosTrading::Admin IDL interface.
//
// = DESCRIPTION (FROM SPEC)
//
// The admin interface enables the values of the trader attributes to
// be read and written. All attributes are defined as readonly in
// either SupportAttributes, ImportAttributes, LinkAttributes, or
// Admin. To set the trader "attribute" to a new value,
// set_<attribute_name> operations are defined in Admin. Each of these
// set operations returns the previous value of the attribute as its
// function value. If the admin interface operation
// set_support_proxy_offers is invoked with a value set to FALSE in a
// trader which supports the proxy interface, the
// set_support_proxy_offer value does not affect the function of
// operations in the proxy interface. However, in this case, it does
// have the effect of making any proxy offers exported via the proxy
// interface for that trader unavailable to satisfy queries on that
// trader's lookup interface.
{
public:
TAO_Admin (TRADER &trader);
~TAO_Admin (void);
// = Importing Parameters (used by the Lookup Interface)
virtual CORBA::ULong set_def_search_card (CORBA::ULong value,
CORBA::Environment &env)
TAO_THROW_SPEC (CORBA::SystemException);
virtual CORBA::ULong set_max_search_card (CORBA::ULong value,
CORBA::Environment &env)
TAO_THROW_SPEC (CORBA::SystemException);
// search card is the cardinality of the offers searched for
// constraint compliance.
virtual CORBA::ULong set_def_search_card (CORBA::ULong value,
CORBA::Environment &env)
TAO_THROW_SPEC (CORBA::SystemException);
virtual CORBA::ULong set_max_search_card (CORBA::ULong value,
CORBA::Environment &env)
TAO_THROW_SPEC (CORBA::SystemException);
// match card is the cardinality of offers found compliant with the
// constraints.
virtual CORBA::ULong set_def_return_card (CORBA::ULong value,
CORBA::Environment &env)
TAO_THROW_SPEC (CORBA::SystemException);
virtual CORBA::ULong set_max_return_card (CORBA::ULong value,
CORBA::Environment &env)
TAO_THROW_SPEC (CORBA::SystemException);
// return card is the cardinality of the offers returned from
// Lookup.
virtual CORBA::ULong set_max_list (CORBA::ULong value,
CORBA::Environment &env)
TAO_THROW_SPEC (CORBA::SystemException);
virtual CORBA::Boolean
set_supports_modifiable_properties (CORBA::Boolean value,
CORBA::Environment &env)
TAO_THROW_SPEC (CORBA::SystemException);
virtual CORBA::Boolean
set_supports_dynamic_properties (CORBA::Boolean value,
CORBA::Environment &env)
TAO_THROW_SPEC (CORBA::SystemException);
virtual CORBA::Boolean
set_supports_proxy_offers (CORBA::Boolean value,
CORBA::Environment &env)
TAO_THROW_SPEC (CORBA::SystemException);
// Types of offers available for consideration. Ween out those
// offers with modifiable properties
// = Link Interface parameters
virtual CORBA::ULong set_def_hop_count (CORBA::ULong value,
CORBA::Environment &env)
TAO_THROW_SPEC (CORBA::SystemException);
virtual CORBA::ULong set_max_hop_count (CORBA::ULong value,
CORBA::Environment &env)
TAO_THROW_SPEC (CORBA::SystemException);
virtual CosTrading::FollowOption
set_def_follow_policy (CosTrading::FollowOption policy,
CORBA::Environment &env)
TAO_THROW_SPEC (CORBA::SystemException);
virtual CosTrading::FollowOption
set_max_follow_policy (CosTrading::FollowOption policy,
CORBA::Environment &env)
TAO_THROW_SPEC (CORBA::SystemException);
virtual CosTrading::FollowOption
set_max_link_follow_policy (CosTrading::FollowOption policy,
CORBA::Environment &env)
TAO_THROW_SPEC (CORBA::SystemException);
// = Set Type Repository
virtual CosTrading::TypeRepository_ptr
set_type_repos(CosTrading::TypeRepository_ptr repository);
virtual CosTrading::Admin::OctetSeq*
request_id_stem (CORBA::Environment& env)
TAO_THROW_SPEC (CORBA::SystemException);
virtual CosTrading::Admin::OctetSeq*
set_request_id_stem (const CosTrading::Admin::OctetSeq& stem,
CORBA::Environment& env)
TAO_THROW_SPEC (CORBA::SystemException);
virtual void list_offers (CORBA::ULong how_many,
CosTrading::OfferIdSeq_out ids,
CosTrading::OfferIdIterator_out id_itr,
CORBA::Environment& env)
TAO_THROW_SPEC (CORBA::SystemException,
CosTrading::NotImplemented);
// BEGIN SPEC
// The list_offers operation allows the administrator of a trader to
// perform housekeeping by obtaining a handle on each of the offers
// within a trader (e.g., for garbage collection etc.). Only the
// identifiers of ordinary offers are returned, identifiers of proxy
// offers are not returned via this operation. If the trader does
// not support the Register interface, the NotImplemented exception
// is raised. The returned identifiers are passed back in one of two
// ways (or a combination of both). ° The "ids" return result
// conveys a list of offer identifiers and the "id_itr" is a
// reference to an interface at which additional offer identities
// can be obtained. ° The "how_many" parameter states how many
// identifiers are to be returned via the "ids" result; any
// remaining are available via the iterator interface. If the
// "how_many" exceeds the number of offers held in the trader, then
// the "id_itr" is nil.
// END SPEC
virtual void list_proxies (CORBA::ULong how_many,
CosTrading::OfferIdSeq*& ids,
CosTrading::OfferIdIterator_ptr& id_itr,
CORBA::Environment& env)
TAO_THROW_SPEC (CORBA::SystemException,
CosTrading::NotImplemented);
virtual CosTrading::Lookup_ptr lookup_if (CORBA::Environment& env)
TAO_THROW_SPEC (CORBA::SystemException);
// Returns an object reference to the Lookup interface of the trader.
// Returns nil if the trader does not support Lookup interface.
virtual CosTrading::Register_ptr register_if (CORBA::Environment& env)
TAO_THROW_SPEC (CORBA::SystemException);
// Returns object reference for the Register interface of the trader.
// Returns nil if the trader does not support Register interface.
virtual CosTrading::Link_ptr link_if (CORBA::Environment& env)
TAO_THROW_SPEC (CORBA::SystemException);
// Returns object reference for the Link interface of the trader.
// Returns nil if the trader does not support Link interface.
virtual CosTrading::Proxy_ptr proxy_if (CORBA::Environment& env)
TAO_THROW_SPEC (CORBA::SystemException);
// Returns object reference to the Proxy interface of the trader.
// Returns nil if the trader does not support Proxy interface.
virtual CosTrading::Admin_ptr admin_if (CORBA::Environment& env)
TAO_THROW_SPEC (CORBA::SystemException);
// Returns object reference for the Admin interface of the trader.
// Returns nil if the trader does not support Admin interface.
// = CosTrading::ImportAttributes methods.
virtual CORBA::ULong def_search_card (CORBA::Environment& env)
TAO_THROW_SPEC (CORBA::SystemException);
virtual CORBA::ULong max_search_card (CORBA::Environment& env)
TAO_THROW_SPEC (CORBA::SystemException);
virtual CORBA::ULong def_match_card (CORBA::Environment& env)
TAO_THROW_SPEC (CORBA::SystemException);
virtual CORBA::ULong max_match_card (CORBA::Environment& env)
TAO_THROW_SPEC (CORBA::SystemException);
virtual CORBA::ULong def_return_card (CORBA::Environment& env)
TAO_THROW_SPEC (CORBA::SystemException);
virtual CORBA::ULong max_return_card (CORBA::Environment& env)
TAO_THROW_SPEC (CORBA::SystemException);
virtual CORBA::ULong max_list (CORBA::Environment& env)
TAO_THROW_SPEC (CORBA::SystemException);
virtual CORBA::ULong def_hop_count (CORBA::Environment& env)
TAO_THROW_SPEC (CORBA::SystemException);
virtual CORBA::ULong max_hop_count (CORBA::Environment& env)
TAO_THROW_SPEC (CORBA::SystemException);
virtual CosTrading::FollowOption def_follow_policy (CORBA::Environment& env)
TAO_THROW_SPEC (CORBA::SystemException);
virtual CosTrading::FollowOption max_follow_policy (CORBA::Environment& env)
TAO_THROW_SPEC (CORBA::SystemException);
// = CosTrading::SupportAttributes methods.
virtual CORBA::Boolean supports_modifiable_properties (CORBA::Environment& env)
TAO_THROW_SPEC (CORBA::SystemException);
virtual CORBA::Boolean supports_dynamic_properties (CORBA::Environment& env)
TAO_THROW_SPEC (CORBA::SystemException);
virtual CORBA::Boolean supports_proxy_offers (CORBA::Environment& env)
TAO_THROW_SPEC (CORBA::SystemException);
virtual CosTrading::TypeRepository_ptr type_repos (CORBA::Environment& env)
TAO_THROW_SPEC (CORBA::SystemException);
// = CosTrading::LinkAttributes methods
virtual CosTrading::FollowOption max_link_follow_policy (CORBA::Environment &env)
TAO_THROW_SPEC (CORBA::SystemException);
static const char* NAME;
private:
TRADER &trader_;
};
#if defined (ACE_TEMPLATES_REQUIRE_SOURCE)
#include "Admin.cpp"
#endif /* ACE_TEMPLATES_REQUIRE_SOURCE */
#endif /* TAO_ADMIN_H */
|
