ServerRequestInfo


1   package org.omg.PortableInterceptor;
2   
3   
4   /**
5   * org/omg/PortableInterceptor/ServerRequestInfo.java .
6   * Generated by the IDL-to-Java compiler (portable), version "3.2"
7   * from ../../../../src/share/classes/org/omg/PortableInterceptor/Interceptors.idl
8   * Saturday, February 9, 2008 9:40:08 AM GMT
9   */
10  
11  
12  /**
13     * Request Information, accessible to server-side request interceptors.
14     * <p>
15     * Some attributes and operations on <code>ServerRequestInfo</code> are not 
16     * valid at all interception points.  The following table shows the validity 
17     * of each attribute or operation.  If it is not valid, attempting to access 
18     * it will result in a <code>BAD_INV_ORDER</code> being thrown with a 
19     * standard minor code of 14.
20     * <p>
21     *
22     *
23     * <table border=1 summary="Shows the validity of each attribute or operation">
24     *   <thead>
25     *     <tr>
26     *       <th>&nbsp;</th>
27     *       <th id="rec_req_ser_con" valign="bottom">receive_request_<br>service_contexts</th>
28     *       <th id="rec_req"  valign="bottom">receive_request</th>
29     *       <th id="send_rep" valign="bottom">send_reply</th>
30     *       <th id="send_exc" valign="bottom">send_exception</th>
31     *       <th id="send_oth" valign="bottom">send_other</th>
32     *     </tr>
33     *   </thead>
34     *  <tbody>
35     *
36     *
37     * <tr>
38     *   <td id="ri" colspan=6><i>Inherited from RequestInfo:</i></td>
39     * </tr>
40     *
41     * <tr><th id="req_id"><p align="left">request_id</p></th>
42     * <td headers="ri req_id rec_req_ser_con">yes</td> 
43     * <td headers="ri req_id rec_req">yes</td> 
44     * <td headers="ri req_id send_rep">yes</td> 
45     * <td headers="ri req_id send_exc">yes</td> 
46     * <td headers="ri req_id send_oth">yes</td></tr>
47     *
48     * <tr><th id="op"><p align="left">operation</p></th>
49     * <td headers="ri op rec_req_ser_con">yes</td> 
50     * <td headers="ri op rec_req">yes</td> 
51     * <td headers="ri op send_rep">yes</td> 
52     * <td headers="ri op send_exc">yes</td> 
53     * <td headers="ri op send_oth">yes</td></tr>
54     *
55     * <tr><th id="args"><p align="left">arguments</p></th>
56     * <td headers="ri args rec_req_ser_con">no </td> 
57     * <td headers="ri args rec_req">yes<sub>1</sub></td>
58     * <td headers="ri args send_rep">yes</td> 
59     * <td headers="ri args send_exc">no<sub>2</sub></td>
60     * <td headers="ri args send_oth">no<sub>2</sub>
61     * </td></tr>
62     *
63     * <tr><th id="exps"><p align="left">exceptions</p></th>
64     * <td headers="ri exps rec_req_ser_con">no </td> 
65     * <td headers="ri exps rec_req">yes</td> 
66     * <td headers="ri exps send_rep">yes</td> 
67     * <td headers="ri exps send_exc">yes</td> 
68     * <td headers="ri exps send_oth">yes</td></tr>
69     *
70     * <tr><th id="contexts"><p align="left">contexts</p></th>
71     * <td headers="ri contexts rec_req_ser_con">no </td> 
72     * <td headers="ri contexts rec_req">yes</td> 
73     * <td headers="ri contexts send_rep">yes</td> 
74     * <td headers="ri contexts send_exc">yes</td> 
75     * <td headers="ri contexts send_oth">yes</td></tr>
76     *
77     * <tr><th id="op_con"><p align="left">operation_context</p></th>
78     * <td headers="ri op_con rec_req_ser_con">no </td> 
79     * <td headers="ri op_con rec_req">yes</td> 
80     * <td headers="ri op_con send_rep">yes</td> 
81     * <td headers="ri op_con send_exc">no </td> 
82     * <td headers="ri op_con send_oth">no </td>
83     * </tr>
84     * 
85     * <tr><th id="result"><p align="left">result</p></th>
86     * <td headers="ri result rec_req_ser_con">no </td> 
87     * <td headers="ri result rec_req">no </td> 
88     * <td headers="ri result send_rep">yes</td> 
89     * <td headers="ri result send_exc">no </td> 
90     * <td headers="ri result send_oth">no </td>
91     * </tr>
92     *
93     * <tr><th id="res_ex"><p align="left">response_expected</p></th>
94     * <td headers="ri res_ex rec_req_ser_con">yes</td> 
95     * <td headers="ri res_ex rec_req">yes</td> 
96     * <td headers="ri res_ex send_rep">yes</td> 
97     * <td headers="ri res_ex send_exc">yes</td> 
98     * <td headers="ri res_ex send_oth">yes</td></tr>
99     *
100    * <tr><th id="syn_scp"><p align="left">sync_scope</p></th>
101    * <td headers="ri syn_scp rec_req_ser_con">yes</td> 
102    * <td headers="ri syn_scp rec_req">yes</td> 
103    * <td headers="ri syn_scp send_rep">yes</td> 
104    * <td headers="ri syn_scp send_exc">yes</td> 
105    * <td headers="ri syn_scp send_oth">yes</td></tr>
106    * 
107    *    <tr><td><b>request_id</b></td>
108    *    <td>yes</td> <td>yes</td> <td>yes</td> <td>yes</td> <td>yes</td></tr>
109    * 
110    *    <tr><td><b>operation</b></td>
111    *    <td>yes</td> <td>yes</td> <td>yes</td> <td>yes</td> <td>yes</td></tr>
112    * 
113    *    <tr><td><b>arguments</b></td>
114    *    <td>no </td> <td>yes<sub>1</sub</td> 
115    *                              <td>yes</td> <td>no<sub>2</sub></td> 
116    *                                                        <td>no<sub>2</sub>
117    *                                                        </td></tr>
118    * 
119    *    <tr><td><b>exceptions</b></td>
120    *    <td>no </td> <td>yes</td> <td>yes</td> <td>yes</td> <td>yes</td></tr>
121    * 
122    *    <tr><td><b>contexts</b></td>
123    *    <td>no </td> <td>yes</td> <td>yes</td> <td>yes</td> <td>yes</td></tr>
124    * 
125    *    <tr><td><b>operation_context</b></td>
126    *    <td>no </td> <td>yes</td> <td>yes</td> <td>no </td> <td>no </td></tr>
127    * 
128    *    <tr><td><b>result</b></td>
129    *    <td>no </td> <td>no </td> <td>yes</td> <td>no </td> <td>no </td></tr>
130    * 
131    *    <tr><td><b>response_expected</b></td>
132    *    <td>yes</td> <td>yes</td> <td>yes</td> <td>yes</td> <td>yes</td></tr>
133    * 
134    *    <tr><td><b>sync_scope</b></td>
135    *    <td>yes</td> <td>yes</td> <td>yes</td> <td>yes</td> <td>yes</td></tr>
136    * 
137    *    <tr><td><b>reply_status</b></td>
138    *    <td>no </td> <td>no </td> <td>yes</td> <td>yes</td> <td>yes</td></tr>
139    * 
140    *    <tr><td><b>forward_reference</b></td>
141    *    <td>no </td> <td>no </td> <td>no </td> <td>no </td> <td>yes<sub>2</sub>
142    *                                </td></tr>
143    * 
144    *    <tr><td><b>get_slot</b></td>
145    *    <td>yes</td> <td>yes</td> <td>yes</td> <td>yes</td> <td>yes</td></tr>
146    * 
147    *    <tr><td><b>get_request_service_context</b></td>
148    *    <td>yes</td> <td>no </td> <td>yes</td> <td>yes</td> <td>yes</td></tr>
149    * 
150    *    <tr><td><b>get_reply_service_context</b></td>
151    *    <td>no </td> <td>no </td> <td>yes</td> <td>yes</td> <td>yes</td></tr>
152    * 
153    *    <tr>
154    *      <td colspan=6><i>ServerRequestInfo-specific:</i></td>
155    *    </tr>
156    * 
157    *    <tr><td><b>sending_exception</b></td>
158    *    <td>no </td> <td>no </td> <td>no </td> <td>yes</td> <td>no </td></tr>
159    * 
160    *    <tr><td><b>object_id</b></td>
161    *    <td>no </td> <td>yes</td> <td>yes</td> <td>yes<sub>3</sub></td> 
162    *                               <td>yes<sub>3</sub>
163    *                                        </td></tr>
164    * 
165    *    <tr><td><b>adapter_id</b></td>
166    *    <td>no </td> <td>yes</td> <td>yes</td> <td>yes<sub>3</sub></td> 
167    *                               <td>yes<sub>3</sub>
168    *                                </td></tr>
169    * 
170    *    <tr><td><b>server_id</b></td>
171    *    <td>no </td> <td>yes</td> <td>yes</td> <td>yes</td> <td>yes</td></tr>
172    *
173    *    <tr><td><b>orb_id</b></td>
174    *    <td>no </td> <td>yes</td> <td>yes</td> <td>yes</td> <td>yes</td></tr>
175    *
176    *    <tr><td><b>adapter_name</b></td>
177    *    <td>no </td> <td>yes</td> <td>yes</td> <td>yes</td> <td>yes</td></tr>
178    *
179    *    <tr><td><b>target_most_derived_interface</b></td>
180    *    <td>no </td> <td>yes</td> <td>no<sub>4</sub></td> 
181    *                      <td>no<sub>4</sub></td> 
182    *                               <td>no<sub>4</sub>
183    *                                   </td></tr>
184    * 
185    *    <tr><td><b>get_server_policy</b></td>
186    *    <td>yes</td> <td>yes</td> <td>yes</td> <td>yes</td> <td>yes</td></tr>
187    * 
188    *    <tr><td><b>set_slot</b></td>
189    *    <td>yes</td> <td>yes</td> <td>yes</td> <td>yes</td> <td>yes</td></tr>
190    * 
191    *    <tr><td><b>target_is_a</b></td>
192    *    <td>no </td> <td>yes</td> <td>no<sub>4</sub></td> 
193    *                      <td>no<sub>4</sub></td> 
194    *                               <td>no<sub>4</sub>
195    *                                   </td></tr>
196    * 
197    *    <tr><td><b>add_reply_service_context</b></td>
198    *    <td>yes</td> <td>yes</td> <td>yes</td> <td>yes</td> <td>yes</td></tr>
199    *   </tbody>
200    * </table>
201    *
202    * <ol>
203    *   <li>When <code>ServerRequestInfo</code> is passed to 
204    *       <code>receive_request</code>, there is an entry in the list for 
205    *       every argument, whether in, inout, or out. But only the in and 
206    *       inout arguments will be available.</li>
207    *   <li>If the <code>reply_status</code> attribute is not 
208    *       <code>LOCATION_FORWARD</code>, accessing this attribute will throw
209    *       <code>BAD_INV_ORDER</code> with a standard minor code of 14.</li>
210    *   <li>If the servant locator caused a location forward, or thrown an 
211    *       exception, this attribute/operation may not be available in this 
212    *       interception point. <code>NO_RESOURCES</code> with a standard minor 
213    *       code of 1 will be thrown if it is not available.</li>
214    *   <li>The operation is not available in this interception point because 
215    *       the necessary information requires access to the target object's 
216    *       servant, which may no longer be available to the ORB. For example, 
217    *       if the object's adapter is a POA that uses a 
218    *       <code>ServantLocator</code>, then the ORB invokes the interception 
219    *       point after it calls <code>ServantLocator.postinvoke()</code></li>.
220    * </ol>
221    *
222    * @see ServerRequestInterceptor
223    */
224 public interface ServerRequestInfo extends ServerRequestInfoOperations  , org.omg.PortableInterceptor.RequestInfo  , org.omg.CORBA.portable.IDLEntity   
225 {
226 } // interface ServerRequestInfo
227
A to Z: JavaDoc & Examples Daily Java News & Articles Open Source Projects Open Source Codes Free Computer Books Remove Frame
Popular Tags