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

348 lines
19 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 ClientRequestInfoOperations">Interface ClientRequestInfoOperations</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/ClientRequestInfo.html" title="在org.omg.PortableInterceptor中的接口">ClientRequestInfo</a></span>
</dd>
</dl>
<hr/> <br/> <pre>public interface <span class="typeNameLabel">ClientRequestInfoOperations</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>ClientRequestInfo</code>是不是在所有的拦截点有效。</span> <span>下表显示每个属性或操作的有效性。</span> <span>如果它无效,尝试访问它将导致<code>BAD_INV_ORDER</code>被抛出标准的次要代码14。</span> </p>
<p></p>
<span>   send_request send_poll receive_reply receive_exception receive_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> yes<sub>1</sub> no yes no no <p align="left">exceptions</p> yes no yes yes yes <p align="left">contexts</p> yes no yes yes yes <p align="left">operation_context</p> yes no yes yes yes <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 no yes yes yes <p align="left">reply_status</p> no no yes yes yes <p align="left">forward_reference</p> no no no no yes<sub>2</sub> <p align="left">get_slot</p> yes yes yes yes yes <p align="left">get_request_service_context</p> yes no yes yes yes <p align="left">get_reply_service_context</p> no no yes yes yes <i>ClientRequestInfo-specific:</i> <p align="left">target</p> yes yes yes yes yes <p align="left">effective_target</p> yes yes yes yes yes <p align="left">effective_profile</p> yes yes yes yes yes <p align="left">received_exception</p> no no no yes no <p align="left">received_exception_id</p> no no no yes no <p align="left">get_effective_component</p> yes no yes yes yes <p align="left">get_effective_components</p> yes no yes yes yes <p align="left">get_request_policy</p> yes no yes yes yes <p align="left">add_request_service_context</p> yes no no no no </span>
<table border="1" summary="Shows the validity of each attribute or operation">
</table>
<ol>
<li> <span><code>ClientRequestInfo</code>传递给<code>send_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>
</ol>
</div>
<dl>
<dt>
<span class="seeLabel">另请参见:</span>
</dt>
<dd>
<span><a href="../../../org/omg/PortableInterceptor/ClientRequestInterceptor.html" title="在org.omg.PortableInterceptor中的接口"><code>ClientRequestInterceptor</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>void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../org/omg/PortableInterceptor/ClientRequestInfoOperations.html#add_request_service_context-org.omg.IOP.ServiceContext-boolean-">add_request_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="i1">
<td class="colFirst"><code><a href="../../../org/omg/IOP/TaggedProfile.html" title="class in org.omg.IOP">TaggedProfile</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../org/omg/PortableInterceptor/ClientRequestInfoOperations.html#effective_profile--">effective_profile</a></span>()</code>
<div class="block">
返回将用于发送请求的配置文件。
</div> </td>
</tr>
<tr class="altColor" id="i2">
<td class="colFirst"><code><a href="../../../org/omg/CORBA/Object.html" title="interface in org.omg.CORBA">Object</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../org/omg/PortableInterceptor/ClientRequestInfoOperations.html#effective_target--">effective_target</a></span>()</code>
<div class="block">
返回将调用操作的实际对象。
</div> </td>
</tr>
<tr class="rowColor" id="i3">
<td class="colFirst"><code><a href="../../../org/omg/IOP/TaggedComponent.html" title="class in org.omg.IOP">TaggedComponent</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../org/omg/PortableInterceptor/ClientRequestInfoOperations.html#get_effective_component-int-">get_effective_component</a></span>(int id)</code>
<div class="block">
从为此请求选择的配置文件中返回具有给定ID的
<code>IOP.TaggedComponent</code>
</div> </td>
</tr>
<tr class="altColor" id="i4">
<td class="colFirst"><code><a href="../../../org/omg/IOP/TaggedComponent.html" title="class in org.omg.IOP">TaggedComponent</a>[]</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../org/omg/PortableInterceptor/ClientRequestInfoOperations.html#get_effective_components-int-">get_effective_components</a></span>(int id)</code>
<div class="block">
从为该请求选择的配置文件中返回具有给定ID的所有标记组件的数组。
</div> </td>
</tr>
<tr class="rowColor" id="i5">
<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/ClientRequestInfoOperations.html#get_request_policy-int-">get_request_policy</a></span>(int type)</code>
<div class="block">
返回此操作生效的给定策略。
</div> </td>
</tr>
<tr class="altColor" id="i6">
<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/ClientRequestInfoOperations.html#received_exception_id--">received_exception_id</a></span>()</code>
<div class="block">
返回要返回给客户端的异常的存储库ID。
</div> </td>
</tr>
<tr class="rowColor" id="i7">
<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/ClientRequestInfoOperations.html#received_exception--">received_exception</a></span>()</code>
<div class="block">
返回任何包含要返回给客户端的异常。
</div> </td>
</tr>
<tr class="altColor" id="i8">
<td class="colFirst"><code><a href="../../../org/omg/CORBA/Object.html" title="interface in org.omg.CORBA">Object</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../org/omg/PortableInterceptor/ClientRequestInfoOperations.html#target--">target</a></span>()</code>
<div class="block">
返回客户端调用以执行操作的对象。
</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="target--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>target</h4> <pre><a href="../../../org/omg/CORBA/Object.html" title="interface in org.omg.CORBA">Object</a> target()</pre>
<div class="block">
返回客户端调用以执行操作的对象。
</div>
<dl>
<dt>
<span class="seeLabel">另请参见:</span>
</dt>
<dd>
<a href="../../../org/omg/PortableInterceptor/ClientRequestInfoOperations.html#effective_target--"><code>effective_target()</code></a>
</dd>
</dl> </li>
</ul> <a name="effective_target--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>effective_target</h4> <pre><a href="../../../org/omg/CORBA/Object.html" title="interface in org.omg.CORBA">Object</a> effective_target()</pre>
<div class="block">
<span>返回将调用操作的实际对象。</span>
<span>如果<code>reply_status</code><code>LOCATION_FORWARD</code> ,则在随后的请求中, <code>effective_target</code>将包含转发的IOR而目标将保持不变。</span>
</div>
<dl>
<dt>
<span class="seeLabel">另请参见:</span>
</dt>
<dd>
<a href="../../../org/omg/PortableInterceptor/ClientRequestInfoOperations.html#target--"><code>target()</code></a>
</dd>
</dl> </li>
</ul> <a name="effective_profile--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>effective_profile</h4> <pre><a href="../../../org/omg/IOP/TaggedProfile.html" title="class in org.omg.IOP">TaggedProfile</a> effective_profile()</pre>
<div class="block">
<span>返回将用于发送请求的配置文件。</span>
<span>如果此操作的对象发生了位置转发,并且该对象的配置文件相应地更改,则此配置文件将是位于配置文件。</span>
</div> </li>
</ul> <a name="received_exception--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>received_exception</h4> <pre><a href="../../../org/omg/CORBA/Any.html" title="class in org.omg.CORBA">Any</a> received_exception()</pre>
<div class="block">
<span>返回任何包含要返回给客户端的异常。</span>
<p> <span>如果异常是用户异常,不能插入任何(例如,未知或绑定不提供<code>TypeCode</code> ),则该属性将包含系统异常<code>UNKNOWN</code> 其标准次要代码为1。然而异常的存储库id处于可用<code>received_exception_id</code>属性。</span> </p>
</div>
<dl>
<dt>
<span class="seeLabel">另请参见:</span>
</dt>
<dd>
<a href="../../../org/omg/PortableInterceptor/ClientRequestInfoOperations.html#received_exception_id--"><code>received_exception_id()</code></a>
</dd>
</dl> </li>
</ul> <a name="received_exception_id--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>received_exception_id</h4> <pre><a href="../../../java/lang/String.html" title="class in java.lang">String</a> received_exception_id()</pre>
<div class="block">
返回要返回给客户端的异常的存储库ID。
</div>
<dl>
<dt>
<span class="seeLabel">另请参见:</span>
</dt>
<dd>
<a href="../../../org/omg/PortableInterceptor/ClientRequestInfoOperations.html#received_exception--"><code>received_exception()</code></a>
<a href="package-summary.html#unimpl"><code>PortableInterceptor</code> package comments for limitations / unimplemented features</a>
</dd>
</dl> </li>
</ul> <a name="get_effective_component-int-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>get_effective_component</h4> <pre><a href="../../../org/omg/IOP/TaggedComponent.html" title="class in org.omg.IOP">TaggedComponent</a> get_effective_component(int id)</pre>
<div class="block">
<span>从为此请求选择的配置文件中返回具有给定ID的<code>IOP.TaggedComponent</code></span>
<p> <span>如果给定的组件ID有多个组件则该操作将返回哪个组件未定义。</span> <span>如果给定组件ID有多个组件则应调用<code>get_effective_components</code></span> </p>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>id</code> - 要返回的组件的组件ID。
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
用给定的
<code>IOP.TaggedComponent</code>获得的IOP.TaggedComponent。
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code>BAD_PARAM</code> - 抛出标准的次要代码为28如果给定的组件ID没有组件。
</dd>
<dt>
<span class="seeLabel">另请参见:</span>
</dt>
<dd>
<a href="../../../org/omg/PortableInterceptor/ClientRequestInfoOperations.html#get_effective_components-int-"><code>get_effective_components(int)</code></a>
</dd>
</dl> </li>
</ul> <a name="get_effective_components-int-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>get_effective_components</h4> <pre><a href="../../../org/omg/IOP/TaggedComponent.html" title="class in org.omg.IOP">TaggedComponent</a>[] get_effective_components(int id)</pre>
<div class="block">
从为该请求选择的配置文件中返回具有给定ID的所有标记组件的数组。
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>id</code> - 要返回的组件的组件ID。
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
一组
<code>TaggedComponent</code>对象,每个对象包含给定的标识符。
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code>BAD_PARAM</code> - 抛出标准的次要代码为28如果给定的组件ID不存在组件。
</dd>
<dt>
<span class="seeLabel">另请参见:</span>
</dt>
<dd>
<a href="../../../org/omg/PortableInterceptor/ClientRequestInfoOperations.html#get_effective_component-int-"><code>get_effective_component(int)</code></a>
</dd>
</dl> </li>
</ul> <a name="get_request_policy-int-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>get_request_policy</h4> <pre><a href="../../../org/omg/CORBA/Policy.html" title="interface in org.omg.CORBA">Policy</a> get_request_policy(int type)</pre>
<div class="block">
返回此操作生效的给定策略。
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>type</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> - 抛出标准的次要代码为1如果策略类型无效因为此ORB不支持指定的类型或者因为该类型的策略对象不与此对象关联
</dd>
<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="add_request_service_context-org.omg.IOP.ServiceContext-boolean-">
<!-- --> </a>
<ul class="blockListLast">
<li class="blockList"> <h4>add_request_service_context</h4> <pre>void add_request_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>
</dl> </li>
</ul> </li>
</ul> </li>
</ul>
</div>
</div>