uTools-Manuals/docs/java/org/omg/PortableServer/ServantLocatorOperations.html

<div class="header">
<div class="subTitle">
     org.omg.PortableServer 
   </div>
<h2 class="title" title="Interface ServantLocatorOperations">Interface ServantLocatorOperations</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/PortableServer/ServantManagerOperations.html" title="org.omg.PortableServer中的接口">ServantManagerOperations</a></span>
</dd>
</dl>
<dl>
<dt>
         All Known Subinterfaces: 
       </dt>
<dd>
<span><a href="../../../org/omg/PortableServer/ServantLocator.html" title="org.omg.PortableServer中的接口">ServantLocator</a></span>
</dd>
</dl>
<dl>
<dt>
        所有已知实现类：
       </dt>
<dd>
<span><a href="../../../org/omg/PortableServer/_ServantLocatorStub.html" title="org.omg.PortableServer中的类">_ServantLocatorStub</a> ， <a href="../../../org/omg/PortableServer/ServantLocatorPOA.html" title="org.omg.PortableServer中的类">ServantLocatorPOA</a></span>
</dd>
</dl>
<hr/> <br/> <pre>public interface <span class="typeNameLabel">ServantLocatorOperations</span>
extends <a href="../../../org/omg/PortableServer/ServantManagerOperations.html" title="interface in org.omg.PortableServer">ServantManagerOperations</a></pre>
<div class="block">
<span>当POA具有NON_RETAIN策略时，它使用ServantLocator的servant管理器。</span>
<span>因为POA知道这位仆人经理返回的仆人只能用于一个请求，它可以为仆人经理的业务提供额外的信息，仆人经理的一对操作可能会合作做一些不同于ServantActivator的事情。</span>
<span>当POA使用ServantLocator接口时，在对preinvoke返回的servant进行操作调用后，POA将在servant管理器上调用postinvoke，传递ObjectId值和Servant值作为参数（等等）。</span>
<span>此功能可用于强制与POA关联的对象的所有请求都由仆人管理器进行调解。</span>
</div> </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/PortableServer/ServantLocatorOperations.html#postinvoke-byte:A-org.omg.PortableServer.POA-java.lang.String-java.lang.Object-org.omg.PortableServer.Servant-">postinvoke</a></span>(byte[] oid, <a href="../../../org/omg/PortableServer/POA.html" title="interface in org.omg.PortableServer">POA</a> adapter, <a href="../../../java/lang/String.html" title="class in java.lang">String</a> operation, <a href="../../../java/lang/Object.html" title="class in java.lang">Object</a> the_cookie, <a href="../../../org/omg/PortableServer/Servant.html" title="class in org.omg.PortableServer">Servant</a> the_servant)</code>
<div class="block">
              在服务器完成请求时调用此操作。 
            </div> </td>
</tr>
<tr class="rowColor" id="i1">
<td class="colFirst"><code><a href="../../../org/omg/PortableServer/Servant.html" title="class in org.omg.PortableServer">Servant</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../org/omg/PortableServer/ServantLocatorOperations.html#preinvoke-byte:A-org.omg.PortableServer.POA-java.lang.String-org.omg.PortableServer.ServantLocatorPackage.CookieHolder-">preinvoke</a></span>(byte[] oid, <a href="../../../org/omg/PortableServer/POA.html" title="interface in org.omg.PortableServer">POA</a> adapter, <a href="../../../java/lang/String.html" title="class in java.lang">String</a> operation, <a href="../../../org/omg/PortableServer/ServantLocatorPackage/CookieHolder.html" title="class in org.omg.PortableServer.ServantLocatorPackage">CookieHolder</a> the_cookie)</code>
<div class="block">
              此操作用于获取将用于处理引起preinvoke调用的请求的servant。 
            </div> </td>
</tr>
</tbody>
</table> </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="preinvoke-byte:A-org.omg.PortableServer.POA-java.lang.String-org.omg.PortableServer.ServantLocatorPackage.CookieHolder-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>preinvoke</h4> <pre><a href="../../../org/omg/PortableServer/Servant.html" title="class in org.omg.PortableServer">Servant</a> preinvoke(byte[] oid,
                  <a href="../../../org/omg/PortableServer/POA.html" title="interface in org.omg.PortableServer">POA</a> adapter,
                  <a href="../../../java/lang/String.html" title="class in java.lang">String</a> operation,
                  <a href="../../../org/omg/PortableServer/ServantLocatorPackage/CookieHolder.html" title="class in org.omg.PortableServer.ServantLocatorPackage">CookieHolder</a> the_cookie)
           throws <a href="../../../org/omg/PortableServer/ForwardRequest.html" title="class in org.omg.PortableServer">ForwardRequest</a></pre>
<div class="block">
            此操作用于获取将用于处理引起preinvoke调用的请求的servant。 
          </div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>oid</code> - 与请求的对象相关 
            <code>oid</code>的对象标识。 
           </dd>
<dd>
<code>adapter</code> - 对象被激活的POA的引用。 
           </dd>
<dd>
<code>operation</code> - 操作名。 
           </dd>
<dd>
<code>the_cookie</code> - 一个不 
            <code>the_cookie</code>的值，可以由servant管理器在postinvoke期间使用。 
           </dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
             仆人用于处理传入请求。 
           </dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../../org/omg/PortableServer/ForwardRequest.html" title="class in org.omg.PortableServer">ForwardRequest</a></code> - 向ORB指示它负责将当前请求和后续请求传递给异常的forward_reference成员中表示的对象。 
           </dd>
</dl> </li>
</ul> <a name="postinvoke-byte:A-org.omg.PortableServer.POA-java.lang.String-java.lang.Object-org.omg.PortableServer.Servant-">
<!-- --> </a>
<ul class="blockListLast">
<li class="blockList"> <h4>postinvoke</h4> <pre>void postinvoke(byte[] oid,
                <a href="../../../org/omg/PortableServer/POA.html" title="interface in org.omg.PortableServer">POA</a> adapter,
                <a href="../../../java/lang/String.html" title="class in java.lang">String</a> operation,
                <a href="../../../java/lang/Object.html" title="class in java.lang">Object</a> the_cookie,
                <a href="../../../org/omg/PortableServer/Servant.html" title="class in org.omg.PortableServer">Servant</a> the_servant)</pre>
<div class="block">
            在服务器完成请求时调用此操作。 
          </div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>oid</code> - 与作出请求的对象 
            <code>oid</code>的对象ID。 
           </dd>
<dd>
<code>adapter</code> - 对象活动的POA的引用。 
           </dd>
<dd>
<code>the_cookie</code> - 包含由preinvoke设置的数据的不透明值。 
           </dd>
<dd>
<code>the_servant</code> - 与对象相关联的servant的引用。 
           </dd>
</dl> </li>
</ul> </li>
</ul> </li>
</ul>
</div>
</div>