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. * Wednesday, September 15, 2004 10:28:46 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> </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