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
|
// This may look like C, but it's really -*- C++ -*-
// $Id$:
// ========================================================================
//
// = LIBRARY
// TAO
//
// = FILENAME
// PortableInterceptor.h
//
// = DESCRIPTION
// This file contains two helper classes to simplify the support of
// interceptors in tao_idl generated code. All the helper classes
// implementations are in PortableInterceptor.i file.
//
// A series of TAO_INTERCEPTOR* macros are also defined in the file.
// These macros allows us to disable/enable support of interceptors
// easily.
//
//
// = AUTHOR
// Nanbor Wang <nanbor@cs.wustl.edu>
// Kirthika Parameswaran <kirthika@cs.wustl.edu>
// Ossama Othman <ossama@uci.edu>
//
// ========================================================================
#ifndef TAO_PORTABLE_INTERCEPTOR_H
#define TAO_PORTABLE_INTERCEPTOR_H
#include "ace/pre.h"
#include "tao/corbafwd.h"
#if !defined (ACE_LACKS_PRAGMA_ONCE)
# pragma once
#endif /* ACE_LACKS_PRAGMA_ONCE */
#if (TAO_HAS_INTERCEPTORS == 1)
# define TAO_INTERCEPTOR(X) X
# define TAO_INTERCEPTOR_CHECK ACE_TRY_CHECK
# define TAO_INTERCEPTOR_CHECK_RETURN(X) ACE_TRY_CHECK
# define TAO_INTERCEPTOR_THROW(X) ACE_TRY_THROW(X)
# define TAO_INTERCEPTOR_THROW_RETURN(X,Y) ACE_TRY_THROW(X)
#else
# define TAO_INTERCEPTOR(X)
# define TAO_INTERCEPTOR_CHECK ACE_CHECK
# define TAO_INTERCEPTOR_CHECK_RETURN(X) ACE_CHECK_RETURN (X)
# define TAO_INTERCEPTOR_THROW(X) ACE_THROW(X)
# define TAO_INTERCEPTOR_THROW_RETURN(X,Y) ACE_THROW_RETURN(X,Y)
#endif /* TAO_HAS_INTERCEPTORS */
#if (TAO_HAS_INTERCEPTORS == 1)
#include "tao/PortableInterceptorC.h"
#include "tao/Interceptor_List.h"
class TAO_Export TAO_ClientRequestInterceptor_Adapter
{
// = TITLE
// TAO_ClientRequestInterceptor_Adapter
//
// = DESCRIPTION
// A convenient helper class to invoke registered client request
// interceptor(s) in tao_idl generated code.
public:
TAO_ClientRequestInterceptor_Adapter (
TAO_ClientRequestInterceptor_List::TYPE &interceptors);
~TAO_ClientRequestInterceptor_Adapter (void);
/**
* @name PortableInterceptor Client Side Interception Points
*
* Each of these methods corresponds to a client side interception
* point. There are no "intermediate" interception points on the
* client side, only "starting" and "ending" interception points.
*
* @todo
* The "send_poll()" and "receive_other()" PortableInterceptor
* interception points are missing.
*/
//@{
/// This method implements one of the "starting" client side
/// interception points.
void send_request (PortableInterceptor::ClientRequestInfo_ptr ri,
CORBA::Environment &);
/// This method implements one of the "ending" client side
/// interception point.
void receive_reply (PortableInterceptor::ClientRequestInfo_ptr ri,
CORBA::Environment &);
/// This method implements one of the "ending" client side
/// interception point.
void receive_exception (PortableInterceptor::ClientRequestInfo_ptr ri,
CORBA::Environment &);
//@}
private:
/// Reference to the list of registered interceptors.
TAO_ClientRequestInterceptor_List::TYPE &interceptors_;
/// Cache the length of the interceptor list so that we don't have
/// to compute it at each stage of the current interception.
size_t len_;
/// The number of interceptors "pushed" onto the logical flow
/// stack. This is used when unwinding the flow stack.
size_t stack_size_;
/// Flag that denotes if an ending interception point has been
/// called.
int ending_intercept_called_;
};
class TAO_Export TAO_ServerRequestInterceptor_Adapter
{
// = TITLE
// TAO_ServerRequestInterceptor_Adapter
//
// = DESCRIPTION
// A convenient helper class to invoke registered server request
// interceptor(s) in tao_idl generated code.
public:
TAO_ServerRequestInterceptor_Adapter (
TAO_ServerRequestInterceptor_List::TYPE &interceptors);
~TAO_ServerRequestInterceptor_Adapter (void);
/**
* @name PortableInterceptor Client Side Interception Points
*
* Each of these methods corresponds to a client side interception
* point.
*
* @todo
* The "receive_request_service_contexts()" and "send_other()"
* PortableInterceptor interception points are missing.
*/
//@{
/**
* This method implements the "starting" server side interception
* point.
*
* @todo
* The "starting" server side interception point should actually be
* receive_request_service_contexts(). However, that interception
* point hasn't been implemented yet.
*/
void receive_request (PortableInterceptor::ServerRequestInfo_ptr ri,
CORBA::Environment &);
/// This method implements one of the "ending" server side
/// interception points.
void send_reply (PortableInterceptor::ServerRequestInfo_ptr ri,
CORBA::Environment &);
/// This method implements one of the "ending" server side
/// interception points.
void send_exception (PortableInterceptor::ServerRequestInfo_ptr ri,
CORBA::Environment &);
//@}
private:
/// Reference to the list of registered interceptors.
TAO_ServerRequestInterceptor_List::TYPE &interceptors_;
/// Cache the length of the interceptor list so that we don't have
/// to compute it at each stage of the current interception.
size_t len_;
/// The number of interceptors "pushed" onto the logical flow
/// stack. This is used when unwinding the flow stack.
size_t stack_size_;
/// Flag that denotes if an ending interception point has been
/// called.
int ending_intercept_called_;
};
#if defined (__ACE_INLINE__)
#include "tao/PortableInterceptor.i"
#endif /* defined INLINE */
#endif /* TAO_HAS_INTERCEPTORS */
#include "ace/post.h"
#endif /* TAO_PORTABLE_INTERCEPTOR_H */
|
