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
|
// -*- C++ -*-
//=============================================================================
/**
* @file IIOP_Profile.h
*
* $Id$
*
* IIOP profile specific processing.
*
* @author Fred Kuhns <fredk@cs.wustl.edu>
*/
//=============================================================================
#ifndef TAO_IIOP_PROFILE_H
#define TAO_IIOP_PROFILE_H
#include /**/ "ace/pre.h"
#include "tao/orbconf.h"
#if !defined (ACE_LACKS_PRAGMA_ONCE)
# pragma once
#endif /* ACE_LACKS_PRAGMA_ONCE */
#if defined (TAO_HAS_IIOP) && (TAO_HAS_IIOP != 0)
#include "tao/Profile.h"
#include "tao/IIOP_Endpoint.h"
TAO_BEGIN_VERSIONED_NAMESPACE_DECL
// TAO IIOP_Profile concrete Profile definitions
/**
* @class TAO_IIOP_Profile
*
* @brief This class defines the protocol specific attributes required
* for locating ORBs over a TCP/IP network.
*
* This class defines the IIOP profile as specified in the CORBA
* specification.
*/
class TAO_Export TAO_IIOP_Profile : public TAO_Profile
{
public:
//@@ TAO_PROFILE_SPL_PUBLIC_METHODS_COPY_HOOK_START
static const char object_key_delimiter_;
/// Return the char string prefix.
static const char *prefix (void);
/// Profile constructor, same as above except the object_key has
/// already been marshaled.
TAO_IIOP_Profile (const ACE_INET_Addr &addr,
const TAO::ObjectKey &object_key,
const TAO_GIOP_Message_Version &version,
TAO_ORB_Core *orb_core);
/// Profile constructor, this is the most efficient since it
/// doesn't require any address resolution processing.
TAO_IIOP_Profile (const char *host,
CORBA::UShort port,
const TAO::ObjectKey &object_key,
const ACE_INET_Addr &addr,
const TAO_GIOP_Message_Version &version,
TAO_ORB_Core *orb_core);
/// Profile constructor, default.
TAO_IIOP_Profile (TAO_ORB_Core *orb_core);
/**
* Add @a endp to this profile's list of endpoints (it is inserted
* next to the head of the list). This profiles takes ownership of
* @a endp.
*/
void add_endpoint (TAO_IIOP_Endpoint *endp);
/**
* Remove @a endp from this profile's list of endpoints and free the
* @a endp memory.
* This method assumes @a endp is in this profile's endpoint list.
*/
void remove_endpoint (TAO_IIOP_Endpoint *endp);
virtual void remove_generic_endpoint (TAO_Endpoint *ep);
/// Add an endpoint when the specific endpoint type is unknown
virtual void add_generic_endpoint (TAO_Endpoint *ep);
//@@ TAO_PROFILE_SPL_PUBLIC_METHODS_COPY_HOOK_END
/// The object key delimiter that IIOP uses or expects.
virtual char object_key_delimiter (void) const;
/// Template methods. Please see Profile.h for documentation.
virtual char * to_string (ACE_ENV_SINGLE_ARG_DECL);
/// Encode endpoints for RT profiles, using a single TAO_TAG_ENDPOINT
/// component.
virtual int encode_endpoints (void);
/// Encode alternate endpoints for non-RT profiles, using multiple
/// TAG_ALTERNATE_IIOP_ADDRESS components, one endpoint per component
virtual int encode_alternate_endpoints (void);
virtual TAO_Endpoint *endpoint (void);
virtual CORBA::ULong endpoint_count (void) const;
virtual CORBA::ULong hash (CORBA::ULong max
ACE_ENV_ARG_DECL);
protected:
/// Destructor is to be called only through <_decr_refcnt>.
~TAO_IIOP_Profile (void);
/**
* Helper method for encode_endpoints to deal with RT requests.
*
* Encodes this profile's endpoints into a tagged component.
* This is done only if RTCORBA is enabled, since currently this is
* the only case when we have more than one endpoint per profile.
* Returns 0 on success and -1 on failure.
*
* Endpoints are transmitted using TAO-proprietory tagged component.
* Component tag is TAO_TAG_ENDPOINTS and component data is an
* encapsulation of a sequence of structs, each representing a
* single endpoint. Data format is specified in iiop_endpoins.pidl.
*/
//@@ TAO_PROFILE_SPL_PROTECTED_METHODS_COPY_HOOK_START
int encode_endpoints_for_rt (void);
//@@ TAO_PROFILE_SPL_PROTECTED_METHODS_COPY_HOOK_END
/// Template methods. Please see Profile.h for the documentation.
virtual int decode_profile (TAO_InputCDR &cdr);
virtual int decode_endpoints (void);
virtual void parse_string_i (const char *string
ACE_ENV_ARG_DECL);
virtual void create_profile_body (TAO_OutputCDR &cdr) const;
virtual CORBA::Boolean do_is_equivalent (const TAO_Profile *other_profile);
protected:
/**
* Head of this profile's list of endpoints. This endpoint is not
* dynamically allocated because a profile always contains at least
* one endpoint.
*
* Currently, a profile contains more than one endpoint, i.e.,
* list contains more than just the head, only for two cases
* (1) when RTCORBA is enabled and
* (2) the ORB is initialized with -ORBPreferredInterfaces option.
* However, in the near future, this will be used in for mode as
* well, e.g., to support TAG_ALTERNATE_IIOP_ADDRESS feature.
*
* This is probably as good a place to discuss how the list of
* endpoints is used for #2. If the ORB is configured to use
* preferred interfaces for invocation, TAO creates an endpoint per
* preferred interface. To be clear, every tuple
* <destination:target> will have an endpoint. What TAO essentially
* does is that creates it multiple endpoints so that the invocation
* code path can use existing iterating techniques to try one
* preferred interface after another (if the first did not work). If
* the ORB is configured with -ORBEnforcePreferredInterface set to
* false in addition to the ORBPreferredInterfaces option , TAO
* creates another endpoint with the preferred bit set to null, so
* that the invocation code can fall back to a TCP stack returned
* local address.
* Addressing info of the default endpoint, i.e., head of the list,
* is transmitted using standard IIOP ProfileBody components. See
* <encode_endpoints> method documentation above for how the rest of
* the endpoint list is transmitted.
*/
//@@ TAO_PROFILE_SPL_PRIVATE_DATA_COPY_HOOK_START
TAO_IIOP_Endpoint endpoint_;
/// Number of endpoints in the list headed by <endpoint_>.
CORBA::ULong count_;
//@@ TAO_PROFILE_SPL_PRIVATE_DATA_COPY_HOOK_END
};
TAO_END_VERSIONED_NAMESPACE_DECL
#endif /* TAO_HAS_IIOP && TAO_HAS_IIOP != 0 */
#include /**/ "ace/post.h"
#endif /* TAO_IIOP_PROFILE_H */
|
