uTools-Manuals/docs/java/org/omg/PortableInterceptor/ServerRequestInfoOperations.html

349 lines
20 KiB
HTML
Raw Blame History

This file contains invisible Unicode characters

This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

<div class="header">
<div class="subTitle">
org.omg.PortableInterceptor
</div>
<h2 class="title" title="Interface ServerRequestInfoOperations">Interface ServerRequestInfoOperations</h2>
</div><div class="contentContainer">
<div class="description">
<ul class="blockList">
<li class="blockList">
<dl>
<dt>
All Superinterfaces:
</dt>
<dd>
<span><a href="../../../org/omg/PortableInterceptor/RequestInfoOperations.html" title="在org.omg.PortableInterceptor中的接口">RequestInfoOperations</a></span>
</dd>
</dl>
<dl>
<dt>
All Known Subinterfaces:
</dt>
<dd>
<span><a href="../../../org/omg/PortableInterceptor/ServerRequestInfo.html" title="在org.omg.PortableInterceptor中的接口">ServerRequestInfo</a></span>
</dd>
</dl>
<hr/> <br/> <pre>public interface <span class="typeNameLabel">ServerRequestInfoOperations</span>
extends <a href="../../../org/omg/PortableInterceptor/RequestInfoOperations.html" title="interface in org.omg.PortableInterceptor">RequestInfoOperations</a></pre>
<div class="block">
<span>请求信息,可由服务器端请求拦截器访问。</span>
<p> <span>对一些属性和操作<code>ServerRequestInfo</code>是不是在所有的拦截点有效。</span> <span>下表显示每个属性或操作的有效性。</span> <span>如果它无效,尝试访问它将导致<code>BAD_INV_ORDER</code>被抛出与14的标准次要代码。</span> </p>
<p></p>
<span>   receive_request_<br/>service_contexts receive_request send_reply send_exception send_other <i>Inherited from RequestInfo:</i> <p align="left">request_id</p> yes yes yes yes yes <p align="left">operation</p> yes yes yes yes yes <p align="left">arguments</p> no yes<sub>1</sub> yes no<sub>2</sub> no<sub>2</sub> <p align="left">exceptions</p> no yes yes yes yes <p align="left">contexts</p> no yes yes yes yes <p align="left">operation_context</p> no yes yes no no <p align="left">result</p> no no yes no no <p align="left">response_expected</p> yes yes yes yes yes <p align="left">sync_scope</p> yes yes yes yes yes <b>request_id</b> yes yes yes yes yes <b>operation</b> yes yes yes yes yes <b>arguments</b> no yes<sub>1 </sub> yes no<sub>2</sub> no<sub>2</sub> <b>exceptions</b> no yes yes yes yes <b>contexts</b> no yes yes yes yes <b>operation_context</b> no yes yes no no <b>result</b> no no yes no no <b>response_expected</b> yes yes yes yes yes <b>sync_scope</b> yes yes yes yes yes <b>reply_status</b> no no yes yes yes <b>forward_reference</b> no no no no yes<sub>2</sub> <b>get_slot</b> yes yes yes yes yes <b>get_request_service_context</b> yes no yes yes yes <b>get_reply_service_context</b> no no yes yes yes <i>ServerRequestInfo-specific:</i> <b>sending_exception</b> no no no yes no <b>object_id</b> no yes yes yes<sub>3</sub> yes<sub>3</sub> <b>adapter_id</b> no yes yes yes<sub>3</sub> yes<sub>3</sub> <b>server_id</b> no yes yes yes yes <b>orb_id</b> no yes yes yes yes <b>adapter_name</b> no yes yes yes yes <b>target_most_derived_interface</b> no yes no<sub>4</sub> no<sub>4</sub> no<sub>4</sub> <b>get_server_policy</b> yes yes yes yes yes <b>set_slot</b> yes yes yes yes yes <b>target_is_a</b> no yes no<sub>4</sub> no<sub>4</sub> no<sub>4</sub> <b>add_reply_service_context</b> yes yes yes yes yes </span>
<table border="1" summary="Shows the validity of each attribute or operation">
</table>
<ol>
<li> <span><code>ServerRequestInfo</code>传递给<code>receive_request</code>每个参数的列表中都有一个条目无论是在inout还是out中。</span> <span>但是只有in和inout参数才可用。</span> </li>
<li> <span>如果<code>reply_status</code>属性不是<code>LOCATION_FORWARD</code> ,访问此属性将抛出<code>BAD_INV_ORDER</code>与标准的次要代码14。</span> </li>
<li> <span>如果servant定位器导致位置向前或引发异常此属性/操作可能在此截取点中不可用。</span> <span><code>NO_RESOURCES</code>与标准的次要代码1将被抛出如果它不可用。</span> </li>
<li> <span>该拦截点不可用此操作因为必要的信息需要访问目标对象的仆人ORB可能不再可用。</span> <span>例如如果对象的适配器是使用一个POA <code>ServantLocator</code> 那么ORB将调用拦截点调用后<code>ServantLocator.postinvoke()</code></span> </li>
<span></span>
</ol>
</div>
<dl>
<dt>
<span class="seeLabel">另请参见:</span>
</dt>
<dd>
<span><a href="../../../org/omg/PortableInterceptor/ServerRequestInterceptor.html" title="在org.omg.PortableInterceptor中的接口"><code>ServerRequestInterceptor</code></a></span>
</dd>
</dl> </li>
</ul>
</div>
<div class="summary">
<ul class="blockList">
<li class="blockList">
<!-- ========== METHOD SUMMARY =========== -->
<ul class="blockList">
<li class="blockList"><a name="method.summary">
<!-- --> </a> <h3>方法摘要</h3>
<table border="0" cellpadding="3" cellspacing="0" class="memberSummary" summary="Method Summary table, listing methods, and an explanation">
<caption>
<span class="activeTableTab" id="t0"><span>所有方法</span><span class="tabEnd"> </span></span>
<span class="tableTab" id="t2"><span><a href="javascript:show(2);">接口方法</a></span><span class="tabEnd"> </span></span>
<span class="tableTab" id="t3"><span><a href="javascript:show(4);">抽象方法</a></span><span class="tabEnd"> </span></span>
</caption>
<tbody>
<tr>
<th class="colFirst" scope="col">Modifier and Type</th>
<th class="colLast" scope="col">Method and Description</th>
</tr>
<tr class="altColor" id="i0">
<td class="colFirst"><code>byte[]</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../org/omg/PortableInterceptor/ServerRequestInfoOperations.html#adapter_id--">adapter_id</a></span>()</code>
<div class="block">
返回对象适配器的不透明标识符。
</div> </td>
</tr>
<tr class="rowColor" id="i1">
<td class="colFirst"><code><a href="../../../java/lang/String.html" title="class in java.lang">String</a>[]</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../org/omg/PortableInterceptor/ServerRequestInfoOperations.html#adapter_name--">adapter_name</a></span>()</code>
<div class="block">
返回标识正在处理此请求的对象适配器实例的字符串序列。
</div> </td>
</tr>
<tr class="altColor" id="i2">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../org/omg/PortableInterceptor/ServerRequestInfoOperations.html#add_reply_service_context-org.omg.IOP.ServiceContext-boolean-">add_reply_service_context</a></span>(<a href="../../../org/omg/IOP/ServiceContext.html" title="class in org.omg.IOP">ServiceContext</a> service_context, boolean replace)</code>
<div class="block">
允许拦截器向请求添加服务上下文。
</div> </td>
</tr>
<tr class="rowColor" id="i3">
<td class="colFirst"><code><a href="../../../org/omg/CORBA/Policy.html" title="interface in org.omg.CORBA">Policy</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../org/omg/PortableInterceptor/ServerRequestInfoOperations.html#get_server_policy-int-">get_server_policy</a></span>(int type)</code>
<div class="block">
返回给定策略类型的此操作的有效策略。
</div> </td>
</tr>
<tr class="altColor" id="i4">
<td class="colFirst"><code>byte[]</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../org/omg/PortableInterceptor/ServerRequestInfoOperations.html#object_id--">object_id</a></span>()</code>
<div class="block">
返回描述
<code>object_id</code>调用目标的不透明的object_id。
</div> </td>
</tr>
<tr class="rowColor" id="i5">
<td class="colFirst"><code><a href="../../../java/lang/String.html" title="class in java.lang">String</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../org/omg/PortableInterceptor/ServerRequestInfoOperations.html#orb_id--">orb_id</a></span>()</code>
<div class="block">
返回用于创建ORB的ID。
</div> </td>
</tr>
<tr class="altColor" id="i6">
<td class="colFirst"><code><a href="../../../org/omg/CORBA/Any.html" title="class in org.omg.CORBA">Any</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../org/omg/PortableInterceptor/ServerRequestInfoOperations.html#sending_exception--">sending_exception</a></span>()</code>
<div class="block">
返回任何包含要返回给客户端的异常。
</div> </td>
</tr>
<tr class="rowColor" id="i7">
<td class="colFirst"><code><a href="../../../java/lang/String.html" title="class in java.lang">String</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../org/omg/PortableInterceptor/ServerRequestInfoOperations.html#server_id--">server_id</a></span>()</code>
<div class="block">
返回使用-ORBServerId参数在ORB :: init上指定的服务器ID。
</div> </td>
</tr>
<tr class="altColor" id="i8">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../org/omg/PortableInterceptor/ServerRequestInfoOperations.html#set_slot-int-org.omg.CORBA.Any-">set_slot</a></span>(int id, <a href="../../../org/omg/CORBA/Any.html" title="class in org.omg.CORBA">Any</a> data)</code>
<div class="block">
允许Interceptor在设置的槽
<code>PortableInterceptor.Current</code>是在请求的范围。
</div> </td>
</tr>
<tr class="rowColor" id="i9">
<td class="colFirst"><code>boolean</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../org/omg/PortableInterceptor/ServerRequestInfoOperations.html#target_is_a-java.lang.String-">target_is_a</a></span>(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> id)</code>
<div class="block">
如果servant是给定的存储库id则返回true否则返回false。
</div> </td>
</tr>
<tr class="altColor" id="i10">
<td class="colFirst"><code><a href="../../../java/lang/String.html" title="class in java.lang">String</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../org/omg/PortableInterceptor/ServerRequestInfoOperations.html#target_most_derived_interface--">target_most_derived_interface</a></span>()</code>
<div class="block">
返回servant最传导接口的存储库ID。
</div> </td>
</tr>
</tbody>
</table>
<ul class="blockList">
<li class="blockList"><a name="methods.inherited.from.class.org.omg.PortableInterceptor.RequestInfoOperations">
<!-- --> </a> <h3>Methods inherited from interface org.omg.PortableInterceptor.<a href="../../../org/omg/PortableInterceptor/RequestInfoOperations.html" title="interface in org.omg.PortableInterceptor">RequestInfoOperations</a></h3> <code><a href="../../../org/omg/PortableInterceptor/RequestInfoOperations.html#arguments--">arguments</a>, <a href="../../../org/omg/PortableInterceptor/RequestInfoOperations.html#contexts--">contexts</a>, <a href="../../../org/omg/PortableInterceptor/RequestInfoOperations.html#exceptions--">exceptions</a>, <a href="../../../org/omg/PortableInterceptor/RequestInfoOperations.html#forward_reference--">forward_reference</a>, <a href="../../../org/omg/PortableInterceptor/RequestInfoOperations.html#get_reply_service_context-int-">get_reply_service_context</a>, <a href="../../../org/omg/PortableInterceptor/RequestInfoOperations.html#get_request_service_context-int-">get_request_service_context</a>, <a href="../../../org/omg/PortableInterceptor/RequestInfoOperations.html#get_slot-int-">get_slot</a>, <a href="../../../org/omg/PortableInterceptor/RequestInfoOperations.html#operation_context--">operation_context</a>, <a href="../../../org/omg/PortableInterceptor/RequestInfoOperations.html#operation--">operation</a>, <a href="../../../org/omg/PortableInterceptor/RequestInfoOperations.html#reply_status--">reply_status</a>, <a href="../../../org/omg/PortableInterceptor/RequestInfoOperations.html#request_id--">request_id</a>, <a href="../../../org/omg/PortableInterceptor/RequestInfoOperations.html#response_expected--">response_expected</a>, <a href="../../../org/omg/PortableInterceptor/RequestInfoOperations.html#result--">result</a>, <a href="../../../org/omg/PortableInterceptor/RequestInfoOperations.html#sync_scope--">sync_scope</a></code></li>
</ul> </li>
</ul> </li>
</ul>
</div>
<div class="details">
<ul class="blockList">
<li class="blockList">
<!-- ============ METHOD DETAIL ========== -->
<ul class="blockList">
<li class="blockList"><a name="method.detail">
<!-- --> </a> <h3>方法详细信息</h3> <a name="sending_exception--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>sending_exception</h4> <pre><a href="../../../org/omg/CORBA/Any.html" title="class in org.omg.CORBA">Any</a> sending_exception()</pre>
<div class="block">
<span>返回任何包含要返回给客户端的异常。</span>
<p> <span>如果异常是不能插入任何用户异常(例如,未知或绑定不提供<code>TypeCode</code> ),那么该属性将包含系统异常<code>UNKNOWN</code> 其中标准的次要代码为1 。</span> </p>
</div>
<dl>
<dt>
<span class="seeLabel">另请参见:</span>
</dt>
<dd>
<a href="package-summary.html#unimpl"><code>PortableInterceptor</code> package comments for limitations / unimplemented features</a>
</dd>
</dl> </li>
</ul> <a name="object_id--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>object_id</h4> <pre>byte[] object_id()</pre>
<div class="block">
返回描述
<code>object_id</code>调用目标的不透明的object_id。
</div> </li>
</ul> <a name="adapter_id--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>adapter_id</h4> <pre>byte[] adapter_id()</pre>
<div class="block">
返回对象适配器的不透明标识符。
</div> </li>
</ul> <a name="server_id--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>server_id</h4> <pre><a href="../../../java/lang/String.html" title="class in java.lang">String</a> server_id()</pre>
<div class="block">
返回使用-ORBServerId参数在ORB :: init上指定的服务器ID。
</div> </li>
</ul> <a name="orb_id--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>orb_id</h4> <pre><a href="../../../java/lang/String.html" title="class in java.lang">String</a> orb_id()</pre>
<div class="block">
返回用于创建ORB的ID。
</div> </li>
</ul> <a name="adapter_name--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>adapter_name</h4> <pre><a href="../../../java/lang/String.html" title="class in java.lang">String</a>[] adapter_name()</pre>
<div class="block">
返回标识正在处理此请求的对象适配器实例的字符串序列。
</div> </li>
</ul> <a name="target_most_derived_interface--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>target_most_derived_interface</h4> <pre><a href="../../../java/lang/String.html" title="class in java.lang">String</a> target_most_derived_interface()</pre>
<div class="block">
返回servant最传导接口的存储库ID。
</div> </li>
</ul> <a name="get_server_policy-int-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>get_server_policy</h4> <pre><a href="../../../org/omg/CORBA/Policy.html" title="interface in org.omg.CORBA">Policy</a> get_server_policy(int type)</pre>
<div class="block">
<span>返回给定策略类型的此操作的有效策略。</span>
<span>返回的<code>CORBA.Policy</code>对象只能是通过<code>register_policy_factory</code>类型的策略。</span>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>type</code> -
<code>CORBA.PolicyType</code>要返回的策略的
<code>CORBA.PolicyType</code>
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
以给定的策略类型获得
<code>CORBA.Policy</code>
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code>INV_POLICY</code> - 抛出标准的次要代码为2如果给定类型的策略未通过
<code>register_policy_factory</code>
</dd>
<dt>
<span class="seeLabel">另请参见:</span>
</dt>
<dd>
<a href="../../../org/omg/PortableInterceptor/ORBInitInfoOperations.html#register_policy_factory-int-org.omg.PortableInterceptor.PolicyFactory-"><code>ORBInitInfoOperations.register_policy_factory(int, org.omg.PortableInterceptor.PolicyFactory)</code></a>
</dd>
</dl> </li>
</ul> <a name="set_slot-int-org.omg.CORBA.Any-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>set_slot</h4> <pre>void set_slot(int id,
<a href="../../../org/omg/CORBA/Any.html" title="class in org.omg.CORBA">Any</a> data)
throws <a href="../../../org/omg/PortableInterceptor/InvalidSlot.html" title="class in org.omg.PortableInterceptor">InvalidSlot</a></pre>
<div class="block">
<span>允许Interceptor在设置的槽<code>PortableInterceptor.Current</code>是在请求的范围。</span>
<span>如果该插槽中已经存在数据,它将被覆盖。</span>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>id</code> - 插槽的ID。
</dd>
<dd>
<code>data</code> - 以任何形式存储在该插槽中的数据。
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../../org/omg/PortableInterceptor/InvalidSlot.html" title="class in org.omg.PortableInterceptor">InvalidSlot</a></code> - 如果ID未定义分配的插槽则抛出。
</dd>
<dt>
<span class="seeLabel">另请参见:</span>
</dt>
<dd>
<span><a href="../../../org/omg/PortableInterceptor/Current.html" title="在org.omg.PortableInterceptor中的接口"><code>Current</code></a></span>
</dd>
</dl> </li>
</ul> <a name="target_is_a-java.lang.String-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>target_is_a</h4> <pre>boolean target_is_a(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> id)</pre>
<div class="block">
如果servant是给定的存储库id则返回true否则返回false。
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>id</code> - 调用者想知道仆人是否是这个存储库ID。
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
仆人是给定的RepositoryId吗
</dd>
</dl> </li>
</ul> <a name="add_reply_service_context-org.omg.IOP.ServiceContext-boolean-">
<!-- --> </a>
<ul class="blockListLast">
<li class="blockList"> <h4>add_reply_service_context</h4> <pre>void add_reply_service_context(<a href="../../../org/omg/IOP/ServiceContext.html" title="class in org.omg.IOP">ServiceContext</a> service_context,
boolean replace)</pre>
<div class="block">
<span>允许拦截器向请求添加服务上下文。</span>
<p> <span>没有声明服务上下文的顺序。</span> <span>他们可能会或不会按照添加的顺序出现。</span> </p>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>service_context</code> -
<code>IOP.ServiceContext</code>添加到回复。
</dd>
<dd>
<span><code>replace</code> - 表示当具有给定ID的服务上下文已存在时此操作的行为。</span>
<span>如果是false那么<code>BAD_INV_ORDER</code>与标准的次要代码15被抛出。</span>
<span>如果为true则现有服务上下文将被新的服务上下文替换。</span>
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code>BAD_INV_ORDER</code> - 抛出标准的次要代码为15如果replace为false并且服务上下文已经存在与给定的ID。
</dd>
</dl> </li>
</ul> </li>
</ul> </li>
</ul>
</div>
</div>