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.1"

  7. * from ../../../../src/share/classes/org/omg/PortableInterceptor/Interceptors.idl

  8. * Monday, February 23, 2004 7:03:06 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><th id="rep_stat"><p align="left">reply_status</p></th>

  108.    * <td headers="ri rep_stat rec_req_ser_con">no </td> 

  109.    * <td headers="ri rep_stat rec_req">no </td> 

  110.    * <td headers="ri rep_stat send_rep">yes</td> 

  111.    * <td headers="ri rep_stat send_exc">yes</td> 

  112.    * <td headers="ri rep_stat send_oth">yes</td></tr>

  113.    *

  114.    * <tr><th id="for_ref"><p align="left">forward_reference</p></th>

  115.    * <td headers="ri for_ref rec_req_ser_con">no </td> 

  116.    * <td headers="ri for_ref rec_req">no </td> 

  117.    * <td headers="ri for_ref send_rep">no </td> 

  118.    * <td headers="ri for_ref send_exc">no </td> 

  119.    * <td headers="ri for_ref send_oth">yes<sub>2</sub>

  120.    *                                                            </td></tr>

  121.    *

  122.    * <tr><th id="get_slot"><p align="left">get_slot</p></th>

  123.    * <td headers="ri get_slot rec_req_ser_con">yes</td> 

  124.    * <td headers="ri get_slot rec_req">yes</td> 

  125.    * <td headers="ri get_slot send_rep">yes</td> 

  126.    * <td headers="ri get_slot send_exc">yes</td> 

  127.    * <td headers="ri get_slot send_oth">yes</td></tr>

  128.    *

  129.    * <tr><th id="g_r_s_c"><p align="left">get_request_service_context</p></th>

  130.    * <td headers="ri g_r_s_c rec_req_ser_con">yes</td> 

  131.    * <td headers="ri g_r_s_c rec_req">no </td> 

  132.    * <td headers="ri g_r_s_c send_rep">yes</td> 

  133.    * <td headers="ri g_r_s_c send_exc">yes</td> 

  134.    * <td headers="ri g_r_s_c send_oth">yes</td></tr>

  135.    *

  136.    * <tr><th id="g_rp_s_c"><p align="left">get_reply_service_context</p></th>

  137.    * <td headers="ri g_rp_s_c rec_req_ser_con">no </td> 

  138.    * <td headers="ri g_rp_s_c rec_req">no </td> 

  139.    * <td headers="ri g_rp_s_c send_rep">yes</td> 

  140.    * <td headers="ri g_rp_s_c send_exc">yes</td> 

  141.    * <td headers="ri g_rp_s_c send_oth">yes</td></tr>

  142.    *

  143.    * <tr>

  144.    *   <td id="sri" colspan=6><i>ServerRequestInfo-specific:</i></td>

  145.    * </tr>

  146.    *

  147.    * <tr><th id="send_ex"><p align="left">sending_exception</p></th>

  148.    *   <td headers="sri send_ex rec_req_ser_con">no </td> 

  149.    *   <td headers="sri send_ex rec_req">no </td> 

  150.    *   <td headers="sri send_ex send_rep">no </td> 

  151.    *   <td headers="sri send_ex send_exc">yes</td> 

  152.    *   <td headers="sri send_ex send_oth">no </td>

  153.    *   </tr>

  154.    *

  155.    * <tr><th id="oid"><p align="left">object_id</p></th>

  156.    *   <td headers="sri oid rec_req_ser_con">no </td> 

  157.    *   <td headers="sri oid rec_req">yes</td> 

  158.    *   <td headers="sri oid send_rep">yes</td> 

  159.    *   <td headers="sri oid send_exc">yes<sub>3</sub></td>

  160.    *   <td headers="sri oid send_oth">yes<sub>3</sub>

  161.    *   </td></tr>

  162.    *

  163.    * <tr><th id="aid"><p align="left">adapter_id</p></th>

  164.    * <td headers="sri aid rec_req_ser_con">no </td> 

  165.    * <td headers="sri aid rec_req">yes</td> 

  166.    * <td headers="sri aid send_rep">yes</td> 

  167.    * <td headers="sri aid send_exc">yes<sub>3</sub></td>

  168.    * <td headers="sri aid send_oth">yes<sub>3</sub>

  169.    * </td></tr>

  170.    *

  171.    * <tr><th id="tmdi"><p align="left">target_most_derived_interface</p></th>

  172.    * <td headers="sri tmdi rec_req_ser_con">no </td> 

  173.    * <td headers="sri tmdi rec_req">yes</td> 

  174.    * <td headers="sri tmdi send_rep">no<sub>4</sub></td>

  175.    * <td headers="sri tmdi send_exc">no<sub>4</sub>

  176.    * <td headers="sri tmdi send_oth">no<sub>4</sub>

  177.    * </td></tr>

  178.    *

  179.    * <tr><th id="gsp"><p align="left">get_server_policy</p></th>

  180.    * <td headers="sri gsp rec_req_ser_con">yes</td> 

  181.    * <td headers="sri gsp rec_req">yes</td> 

  182.    * <td headers="sri gsp send_rep">yes</td> 

  183.    * <td headers="sri gsp send_exc">yes</td> 

  184.    * <td headers="sri gsp send_oth">yes</td></tr>

  185.    *

  186.    *

  187.    *

  188.    * <tr><th id="set_slot"><p align="left">set_slot</p></th>

  189.    * <td headers="sri set_slot rec_req_ser_con">yes</td> 

  190.    * <td headers="sri set_slot rec_req">yes</td> 

  191.    * <td headers="sri set_slot send_rep">yes</td> 

  192.    * <td headers="sri set_slot send_exc">yes</td> 

  193.    * <td headers="sri set_slot send_oth">yes</td></tr>

  194.    *

  195.    * <tr><th id="target_is_a"><p align="left">target_is_a</p></th>

  196.    * <td headers="sri target_is_a rec_req_ser_con">no </td> 

  197.    * <td headers="sri target_is_a rec_req">yes</td> 

  198.    * <td headers="sri target_is_a send_rep">no<sub>4</sub></td>

  199.    * <td headers="sri target_is_a send_exc">no<sub>4</sub></td>

  200.    * <td headers="sri target_is_a send_oth">no<sub>4</sub>

  201.    * </td></tr>

  202.    *

  203.    * <tr><th id="arsc"><p align="left">add_reply_service_context</p></th>

  204.    * <td headers="sri arsc rec_req_ser_con">yes</td> 

  205.    * <td headers="sri arsc rec_req">yes</td> 

  206.    * <td headers="sri arsc send_rep">yes</td> 

  207.    * <td headers="sri arsc send_exc">yes</td> 

  208.    * <td headers="sri arsc send_oth">yes</td></tr>

  209.    * </tbody>

  210.    * </table>

  211.    *

  212.    * <ol>

  213.    *   <li>When <code>ServerRequestInfo</code> is passed to 

  214.    *       <code>receive_request</code>, there is an entry in the list for 

  215.    *       every argument, whether in, inout, or out. But only the in and 

  216.    *       inout arguments will be available.</li>

  217.    *   <li>If the <code>reply_status</code> attribute is not 

  218.    *       <code>LOCATION_FORWARD</code>, accessing this attribute will throw

  219.    *       <code>BAD_INV_ORDER</code> with a standard minor code of 14.</li>

  220.    *   <li>If the servant locator caused a location forward, or thrown an 

  221.    *       exception, this attribute/operation may not be available in this 

  222.    *       interception point. <code>NO_RESOURCES</code> with a standard minor 

  223.    *       code of 1 will be thrown if it is not available.</li>

  224.    *   <li>The operation is not available in this interception point because 

  225.    *       the necessary information requires access to the target object's 

  226.    *       servant, which may no longer be available to the ORB. For example, 

  227.    *       if the object's adapter is a POA that uses a 

  228.    *       <code>ServantLocator</code>, then the ORB invokes the interception 

  229.    *       point after it calls <code>ServantLocator.postinvoke()</code></li>.

  230.    * </ol>

  231.    *

  232.    * @see ServerRequestInterceptor

  233.    */

  234. public interface ServerRequestInfo extends ServerRequestInfoOperations, org.omg.PortableInterceptor.RequestInfo, org.omg.CORBA.portable.IDLEntity 

  235. {

  236. } // interface ServerRequestInfo