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
|
// -*- IDL -*- $Id$
// This file contains the interface definitions for "Portable"
// Interceptor support.
// **********************************************************
// Notice that the Portable Interceptor specification
// is still under discussion in OMG and both the IDL
// and the implementation details in TAO will eventually
// change to conform with the PI spec in the future.
//
// @@ Now that a working draft of the Portable Interceptors
// is available, we will provide a compliant implementation
// shortly.
//
// Please see the annotation marked with "@@" in this file
// for hints on transitting from the temporary
// implementation to new APIs.
//
// See $TAO_ROOT/docs/interceptors.html for more info.
// **********************************************************
// Author (currently): Nanbor Wang <nanbor@cs.wustl.edu>
// @@ I will no longer be the author of this IDL file. ;-)
#include <corba.pidl>
#include <IOP.pidl>
#pragma prefix "TAO"
// The prefix should be changed to "omg.org" once the spec. gets
// finallized.
// @@ The prefix will be changed to "omg.org".
module PortableInterceptor
{
interface Cookie
{
// Cookie's are used to pass information among interceptors
// within a invocation or an upcall.
//
// @@ Cookie will no longer be available.
string myname ();
};
typedef sequence<Cookie> Cookies;
// Collections of Cookie's become Cookies'es.
//
// @@ Cookies will no longer be available.
interface Interceptor
{
// Base interface for Interceptors.
//
// @@ This interface will not change.
readonly attribute string name;
};
interface ServerRequestInterceptor : Interceptor
{
// Server side request interceptor definition.
//
// @@ The name of the interface will not change.
void preinvoke (in unsigned long request_id,
in boolean response_expected,
in CORBA::Object objref,
in string operation_name,
inout IOP::ServiceContextList sc,
inout NVList arguments,
inout Cookies ck);
// Interception pointer before invoking the servant method.
// Currently, we don't pass NVList into the interceptor because
// I haven't figured out how to best optimize this stuff.
// In the future, NVList will contain all in and inout arguments
// of the operation.
//
// @@ This operation will map to either
// <receive_request_service_contexts> or <receive_request> of
// the standard APIs. If you are not sure, use
// <receive_request>.
//
// void receive_request_service_contexts (in ServerRequestInfo ri) raises (ForwardRequest);
// void receive_request (in ServerRequestInfo ri) raises (ForwardRequest);
//
// @@ Note that all arguments will be accessed thru
// <PortableInterceptor::ServerRequestInfo> interface.
void postinvoke (in unsigned long request_id,
in boolean response_expected,
in CORBA::Object objref,
in string operation_name,
inout IOP::ServiceContextList sc,
inout NVList arguments,
inout Cookies ck);
// Interception pointer after invoking the servant method.
// Currently, we don't pass NVList into the interceptor because
// I haven't figured out how to best optimize this stuff.
// In the future, NVList will contain all out, inout arguments
// and the return value of the operation.
//
// @@ This operation will map to <send_reply>.
// It is not clear whether oneway call will invoke <send_other>
// operation or not.
//
// void send_reply (in ServerRequestInfo ri);
// void send_other (in ServerRequestInfo ri) raises (ForwardRequest);
//
// @@ Note that all arguments will be accessed thru
// <PortableInterceptor::ServerRequestInfo> interface.
void exception_occurred (in unsigned long request_id,
in boolean response_expected,
in CORBA::Object objref,
in string operation_name,
inout Cookies ck);
// Exception interception point.
//
// @@ This method will map to <send_exception> method.
//
// void send_exception (in ServerRequestInfo ri) raises (ForwardRequest);
//
// @@ Note that all arguments will be accessed thru
// <PortableInterceptor::ServerRequestInfo> interface.
};
interface ClientRequestInterceptor : Interceptor
{
// Client side interceptor.
//
// @@ The name of the interface will not change.
void preinvoke (in unsigned long request_id,
in boolean response_expected,
in CORBA::Object objref,
in string operation_name,
inout IOP::ServiceContextList sc,
inout NVList arguments,
inout Cookies ck);
// Before remote invocation.
// Currently, we don't pass NVList into the interceptor because
// I haven't figured out how to best optimize this stuff.
// In the future, NVList will contain all in and inout arguments
// of the operation.
//
// @@ This operation will map to <send_request> of the standard
// APIs.
//
// void send_request (in ClientRequestInfo) raises (ForwardRequest);
//
// @@ Note that all arguments will be accessed thru
// <PortableInterceptor::ClientRequestInfo> interface.
void postinvoke (in unsigned long request_id,
in boolean response_expected,
in CORBA::Object objref,
in string operation_name,
inout IOP::ServiceContextList sc,
inout NVList arguments,
inout Cookies ck);
// After returned from remote invocation.
// Currently, we don't pass NVList into the interceptor because
// I haven't figured out how to best optimize this stuff.
// In the future, NVList will contain all out, inout arguments
// and the return value of the operation.
//
// @@ This operation will map to either <receive_reply> or
// <receive_other> in the standard APIs depending on whether the
// operation is oneway or not.
//
// void receive_reply (in ClientRequestInfo ri);
// void receive_other (in ClientRequestInfo ri);
//
// @@ Note that all arguments will be accessed thru
// <PortableInterceptor::ClientRequestInfo> interface.
void exception_occurred (in unsigned long request_id,
in boolean response_expected,
in CORBA::Object objref,
in string operation_name,
inout Cookies ck);
// Exception occurred.
//
// @@ This method will map to <receive_exception> method as:
//
// void receive_exception (in ClientRequestInfo ri) raises (ForwardRequest);
//
// @@ Note that all arguments will be accessed thru
// <PortableInterceptor::ClientRequestInfo> interface.
};
};
#pragma prefix ""
|
