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
|
// **********************************************************************
//
// Copyright (c) 2003-2006 ZeroC, Inc. All rights reserved.
//
// This copy of Ice is licensed to you under the terms described in the
// ICE_LICENSE file included in this distribution.
//
// **********************************************************************
#ifndef ICE_CURRENT_ICE
#define ICE_CURRENT_ICE
#include <Ice/ObjectAdapterF.ice>
#include <Ice/ConnectionF.ice>
#include <Ice/Identity.ice>
module Ice
{
/**
*
* A request context. [Context] is used to transmit metadata about a
* request from the server to the client, such as Quality-of-Service
* (QoS) parameters. Each operation on the client has a [Context] as
* its implicit final parameter.
*
**/
dictionary<string, string> Context;
/**
*
* The [OperationMode] determines the skeleton signature (for C++), as
* well as the retry behavior of the Ice run time for an operation
* invocation in case of a (potentially) recoverable error.
*
**/
//
// Note: The order of definitions here *must* match the order of
// definitions for ::Slice::Operation::Mode in include/Slice/Parser.h!
//
enum OperationMode
{
/**
* Ordinary operations have [Normal] mode. These operations
* modify object state; invoking such an operation twice in a row
* has different semantics than invoking it once. The Ice run time
* guarantees that it will not violate at-most-once semantics for
* [Normal] operations.
*/
Normal,
/**
* Operations that use the Slice [nonmutating] keyword must not
* modify object state. For C++, nonmutating operations generate
* [const] member functions in the skeleton. In addition, the Ice
* run time will attempt to transparently recover from certain
* run-time errors by re-issuing a failed request and propagate
* the failure to the application only if the second attempt
* fails.
*/
\Nonmutating,
/**
* Operations that use the Slice [idempotent] keyword can modify
* object state, but invoking an operation twice in a row must
* result in the same object state as invoking it once. For
* example, <literal>x = 1</literal> is an idempotent statement,
* whereas <literal>x += 1</literal> is not. For idempotent
* operations, the Ice run-time uses the same retry behavior
* as for nonmutating operations in case of a potentially
* recoverable error.
*/
\Idempotent
};
/**
*
* Information about the current method invocation for servers. Each
* operation on the server has a [Current] as its implicit final
* parameter. [Current] is mostly used for &Ice; services. Most
* applications ignore this parameter.
*
**/
local struct Current
{
/**
*
* The object adapter.
*
**/
ObjectAdapter adapter;
/**
*
* Information about the connection over which the current method
* invocation was received. If the invocation is direct due to
* collocation optimization, this value is set to null.
*
**/
Connection con;
/**
*
* The &Ice; object identity.
*
**/
Identity id;
/**
*
* The facet.
*
***/
string facet;
/**
*
* The operation name.
*
**/
string operation;
/**
*
* The mode of the operation.
*
**/
OperationMode mode;
/**
*
* The request context, as received from the client.
*
**/
Context ctx;
};
};
#endif
|
