blob: 7f217584581947efedb3ff450babaff83948a8f8 (
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
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
|
// This may look like C, but it's really -*- C++ -*-
//=============================================================================
/**
* @file operation_details.h
*
* $Id$
*
* @author Bala Natarajan <bala@cs.wustl.edu>
*/
//=============================================================================
#ifndef TAO_OPERATION_DETAILS_H
#define TAO_OPERATION_DETAILS_H
#include /**/ "ace/pre.h"
#include "Exception.h"
#if !defined (ACE_LACKS_PRAGMA_ONCE)
# pragma once
#endif /* ACE_LACKS_PRAGMA_ONCE */
#include "Service_Context.h"
#include "target_specification.h"
/// Forward declarations
namespace Dynamic
{
class ParameterList;
class ExceptionList;
}
namespace TAO
{
class Argument;
struct Exception_Data;
}
/**
* @class TAO_Operation_Details
*
* @brief Class with operation details
*
* This class stores some of the "operation" details that would be
* required by the invocation classes. This class is in its
* infancy now but I expect this one to grow as we come with
* different varieties of use cases.
*
* @todo Put this in namespace TAO.
*/
class TAO_Export TAO_Operation_Details
{
public:
/// Constructor
TAO_Operation_Details (const char *name,
CORBA::ULong len,
CORBA::Boolean argument_flag,
TAO::Argument **args = 0,
CORBA::ULong num_args = 0,
TAO::Exception_Data *ex_data = 0,
CORBA::Long ex_count = 0);
/// Operation name
const char* opname (void) const;
/// Length of the operation name
CORBA::ULong opname_len (void) const;
/// Return the flag that indicates whether the operation has any
/// arguments
CORBA::Boolean argument_flag (void) const;
/// Set the response flags
void response_flags (CORBA::Octet flags);
/// Get the response flags
CORBA::Octet response_flags (void);
CORBA::Octet response_flags (void) const;
/// Accessors for the service context list
IOP::ServiceContextList &request_service_info (void);
const IOP::ServiceContextList &request_service_info (void) const;
IOP::ServiceContextList &reply_service_info (void);
const IOP::ServiceContextList &reply_service_info (void) const;
/// Access the TAO_Service_Context
TAO_Service_Context &request_service_context (void);
const TAO_Service_Context &request_service_context (void) const;
TAO_Service_Context &reply_service_context (void);
const TAO_Service_Context &reply_service_context (void) const;
/// Reset the contents of the service context lists that we
/// hold.
void reset_request_service_info (void);
void reset_reply_service_info (void);
///Cache the request id.
void request_id (CORBA::ULong id);
/// Modify request id's for a BiDirectional setup
void modify_request_id (int originator);
/// Return the request ID associated with the operation
CORBA::ULong request_id (void) const;
/// Accessor method for the addressing mode
TAO_Target_Specification::TAO_Target_Address addressing_mode (void);
TAO_Target_Specification::TAO_Target_Address addressing_mode (void) const;
/// Set method for the addressing mode
void addressing_mode (CORBA::Short addr);
/// Creates and returns a CORBA::Exception object whose repository
/// id \a ex matches the exception list that this operation
/// specified.
/**
* This step is important to decode the exception that the client
* got from the server. If the exception received from the server
* is not found in the list of exceptions specified by the operation
* this call would raise an UNKNOWN exception.
*/
CORBA::Exception *corba_exception (const char *ex
ACE_ENV_ARG_DECL)
ACE_THROW_SPEC ((CORBA::SystemException));
/**
* @name Helper methods used by the Invocation classes.
*/
//@{
/// Marshals the list of <this->arg_> into the \a cdr.
bool marshal_args (TAO_OutputCDR &cdr);
/// Demarshals the list of <this->arg_> into the \a cdr.
bool demarshal_args (TAO_InputCDR &cdr);
/**
* The following methods are used by client interceptors to extract
* the list of parameters passed by the operation, exceptions
* declared for the operation, and the result when available.
*/
bool parameter_list (Dynamic::ParameterList &);
bool exception_list (Dynamic::ExceptionList &);
bool result (CORBA::Any *);
//@}
/// Accessors for the argumet list
TAO::Argument **args (void);
CORBA::ULong args_num (void) const ;
private:
/// Name of the operation being invoked.
const char *opname_;
/// Precalculated length of opname_.
CORBA::ULong opname_len_;
/// Request ID of this operation.
CORBA::ULong request_id_;
/**
* Flag that indicates whether the operation has any arguments. If
* there are any arguments the flag will have a value of 1, 0
* otherwise.
*/
CORBA::Boolean argument_flag_;
/// Response flags
CORBA::Octet response_flags_;
/// The ServiceContextList sent to the server side. Only valid
/// when sending a request.
TAO_Service_Context request_service_info_;
/// The ServiceContextList received from the server side. Only
/// valid when sending a request.
TAO_Service_Context reply_service_info_;
/// Addressing mode for this request.
TAO_Target_Specification::TAO_Target_Address addressing_mode_;
TAO::Argument **args_;
CORBA::ULong num_args_;
/// The type of exceptions that the operations can throw.
TAO::Exception_Data *ex_data_;
/// Count of the exceptions that operations can throw.
CORBA::ULong ex_count_;
};
#if defined (__ACE_INLINE__)
# include "operation_details.i"
#endif /* __ACE_INLINE__ */
#include /**/ "ace/post.h"
#endif /* TAO_OPERATION_DETAILS_H */
|
