1038 lines
54 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.PortableServer
</div>
<h2 class="title" title="Interface POAOperations">Interface POAOperations</h2>
</div><div class="contentContainer">
<div class="description">
<ul class="blockList">
<li class="blockList">
<dl>
<dt>
All Known Subinterfaces:
</dt>
<dd>
<span><a href="../../../org/omg/PortableServer/POA.html" title="org.omg.PortableServer中的接口">POA</a></span>
</dd>
</dl>
<hr/> <br/> <pre>public interface <span class="typeNameLabel">POAOperations</span></pre>
<div class="block">
<span>POA对象管理对象集合的实现。</span>
<span>POA支持对象标识的对象的名称空间。</span>
<span>POA还为POA提供了名称空间。</span>
<span>POA被创建为现有POA的子代其形成从根POA开始的层次结构。</span>
<span>POA对象不能导出到其他进程也可以使用ORB :: object_to_string进行外部化。</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/POAOperations.html#activate_object_with_id-byte:A-org.omg.PortableServer.Servant-">activate_object_with_id</a></span>(byte[] id, <a href="../../../org/omg/PortableServer/Servant.html" title="class in org.omg.PortableServer">Servant</a> p_servant)</code>
<div class="block">
此操作将在“活动对象映射”中输入指定的对象标识和指定服务器之间的关联。
</div> </td>
</tr>
<tr class="rowColor" id="i1">
<td class="colFirst"><code>byte[]</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../org/omg/PortableServer/POAOperations.html#activate_object-org.omg.PortableServer.Servant-">activate_object</a></span>(<a href="../../../org/omg/PortableServer/Servant.html" title="class in org.omg.PortableServer">Servant</a> p_servant)</code>
<div class="block">
此操作生成对象标识,并在活动对象映射中输入对象标识和指定的仆人。
</div> </td>
</tr>
<tr class="altColor" id="i2">
<td class="colFirst"><code><a href="../../../org/omg/PortableServer/IdAssignmentPolicy.html" title="interface in org.omg.PortableServer">IdAssignmentPolicy</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../org/omg/PortableServer/POAOperations.html#create_id_assignment_policy-org.omg.PortableServer.IdAssignmentPolicyValue-">create_id_assignment_policy</a></span>(<a href="../../../org/omg/PortableServer/IdAssignmentPolicyValue.html" title="class in org.omg.PortableServer">IdAssignmentPolicyValue</a> value)</code>
<div class="block">
这些操作都返回具有指定值的策略对象的引用。
</div> </td>
</tr>
<tr class="rowColor" id="i3">
<td class="colFirst"><code><a href="../../../org/omg/PortableServer/IdUniquenessPolicy.html" title="interface in org.omg.PortableServer">IdUniquenessPolicy</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../org/omg/PortableServer/POAOperations.html#create_id_uniqueness_policy-org.omg.PortableServer.IdUniquenessPolicyValue-">create_id_uniqueness_policy</a></span>(<a href="../../../org/omg/PortableServer/IdUniquenessPolicyValue.html" title="class in org.omg.PortableServer">IdUniquenessPolicyValue</a> value)</code>
<div class="block">
这些操作都返回具有指定值的策略对象的引用。
</div> </td>
</tr>
<tr class="altColor" id="i4">
<td class="colFirst"><code><a href="../../../org/omg/PortableServer/ImplicitActivationPolicy.html" title="interface in org.omg.PortableServer">ImplicitActivationPolicy</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../org/omg/PortableServer/POAOperations.html#create_implicit_activation_policy-org.omg.PortableServer.ImplicitActivationPolicyValue-">create_implicit_activation_policy</a></span>(<a href="../../../org/omg/PortableServer/ImplicitActivationPolicyValue.html" title="class in org.omg.PortableServer">ImplicitActivationPolicyValue</a> value)</code>
<div class="block">
这些操作都返回具有指定值的策略对象的引用。
</div> </td>
</tr>
<tr class="rowColor" id="i5">
<td class="colFirst"><code><a href="../../../org/omg/PortableServer/LifespanPolicy.html" title="interface in org.omg.PortableServer">LifespanPolicy</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../org/omg/PortableServer/POAOperations.html#create_lifespan_policy-org.omg.PortableServer.LifespanPolicyValue-">create_lifespan_policy</a></span>(<a href="../../../org/omg/PortableServer/LifespanPolicyValue.html" title="class in org.omg.PortableServer">LifespanPolicyValue</a> value)</code>
<div class="block">
这些操作都返回具有指定值的策略对象的引用。
</div> </td>
</tr>
<tr class="altColor" id="i6">
<td class="colFirst"><code><a href="../../../org/omg/PortableServer/POA.html" title="interface in org.omg.PortableServer">POA</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../org/omg/PortableServer/POAOperations.html#create_POA-java.lang.String-org.omg.PortableServer.POAManager-org.omg.CORBA.Policy:A-">create_POA</a></span>(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> adapter_name, <a href="../../../org/omg/PortableServer/POAManager.html" title="interface in org.omg.PortableServer">POAManager</a> a_POAManager, <a href="../../../org/omg/CORBA/Policy.html" title="interface in org.omg.CORBA">Policy</a>[] policies)</code>
<div class="block">
此操作将创建一个新的POA作为目标POA的子代。
</div> </td>
</tr>
<tr class="rowColor" id="i7">
<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/PortableServer/POAOperations.html#create_reference_with_id-byte:A-java.lang.String-">create_reference_with_id</a></span>(byte[] oid, <a href="../../../java/lang/String.html" title="class in java.lang">String</a> intf)</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/PortableServer/POAOperations.html#create_reference-java.lang.String-">create_reference</a></span>(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> intf)</code>
<div class="block">
此操作创建一个对象引用该引用封装了POA生成的对象标识值和指定的接口存储库标识。
</div> </td>
</tr>
<tr class="rowColor" id="i9">
<td class="colFirst"><code><a href="../../../org/omg/PortableServer/RequestProcessingPolicy.html" title="interface in org.omg.PortableServer">RequestProcessingPolicy</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../org/omg/PortableServer/POAOperations.html#create_request_processing_policy-org.omg.PortableServer.RequestProcessingPolicyValue-">create_request_processing_policy</a></span>(<a href="../../../org/omg/PortableServer/RequestProcessingPolicyValue.html" title="class in org.omg.PortableServer">RequestProcessingPolicyValue</a> value)</code>
<div class="block">
这些操作都返回具有指定值的策略对象的引用。
</div> </td>
</tr>
<tr class="altColor" id="i10">
<td class="colFirst"><code><a href="../../../org/omg/PortableServer/ServantRetentionPolicy.html" title="interface in org.omg.PortableServer">ServantRetentionPolicy</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../org/omg/PortableServer/POAOperations.html#create_servant_retention_policy-org.omg.PortableServer.ServantRetentionPolicyValue-">create_servant_retention_policy</a></span>(<a href="../../../org/omg/PortableServer/ServantRetentionPolicyValue.html" title="class in org.omg.PortableServer">ServantRetentionPolicyValue</a> value)</code>
<div class="block">
这些操作都返回具有指定值的策略对象的引用。
</div> </td>
</tr>
<tr class="rowColor" id="i11">
<td class="colFirst"><code><a href="../../../org/omg/PortableServer/ThreadPolicy.html" title="interface in org.omg.PortableServer">ThreadPolicy</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../org/omg/PortableServer/POAOperations.html#create_thread_policy-org.omg.PortableServer.ThreadPolicyValue-">create_thread_policy</a></span>(<a href="../../../org/omg/PortableServer/ThreadPolicyValue.html" title="class in org.omg.PortableServer">ThreadPolicyValue</a> value)</code>
<div class="block">
这些操作都返回具有指定值的策略对象的引用。
</div> </td>
</tr>
<tr class="altColor" id="i12">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../org/omg/PortableServer/POAOperations.html#deactivate_object-byte:A-">deactivate_object</a></span>(byte[] oid)</code>
<div class="block">
此操作会导致在oid参数中指定的ObjectId被禁用。
</div> </td>
</tr>
<tr class="rowColor" id="i13">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../org/omg/PortableServer/POAOperations.html#destroy-boolean-boolean-">destroy</a></span>(boolean etherealize_objects, boolean wait_for_completion)</code>
<div class="block">
此操作会破坏POA和所有后代的POA。
</div> </td>
</tr>
<tr class="altColor" id="i14">
<td class="colFirst"><code><a href="../../../org/omg/PortableServer/POA.html" title="interface in org.omg.PortableServer">POA</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../org/omg/PortableServer/POAOperations.html#find_POA-java.lang.String-boolean-">find_POA</a></span>(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> adapter_name, boolean activate_it)</code>
<div class="block">
如果目标POA是具有指定名称相对于目标POA的子级POA的父级则返回该子级POA。
</div> </td>
</tr>
<tr class="rowColor" id="i15">
<td class="colFirst"><code><a href="../../../org/omg/PortableServer/ServantManager.html" title="interface in org.omg.PortableServer">ServantManager</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../org/omg/PortableServer/POAOperations.html#get_servant_manager--">get_servant_manager</a></span>()</code>
<div class="block">
如果POA的ServantRetentionPolicy是RETAIN则ServantManager参数imgr将支持ServantActivator接口。
</div> </td>
</tr>
<tr class="altColor" id="i16">
<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/POAOperations.html#get_servant--">get_servant</a></span>()</code>
<div class="block">
此操作返回与POA关联的默认servant。
</div> </td>
</tr>
<tr class="rowColor" id="i17">
<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/PortableServer/POAOperations.html#id_to_reference-byte:A-">id_to_reference</a></span>(byte[] oid)</code>
<div class="block">
如果具有指定的Object Id值的对象当前处于活动状态则返回封装用于激活对象的信息的引用。
</div> </td>
</tr>
<tr class="altColor" id="i18">
<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/POAOperations.html#id_to_servant-byte:A-">id_to_servant</a></span>(byte[] oid)</code>
<div class="block">
如果POA具有RETAIN策略并且指定的ObjectId位于活动对象映射中则此操作将返回与活动对象映射中该对象关联的servant。
</div> </td>
</tr>
<tr class="rowColor" id="i19">
<td class="colFirst"><code>byte[]</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../org/omg/PortableServer/POAOperations.html#id--">id</a></span>()</code>
<div class="block">
这将在其创建的过程中返回POA的唯一ID。
</div> </td>
</tr>
<tr class="altColor" id="i20">
<td class="colFirst"><code>byte[]</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../org/omg/PortableServer/POAOperations.html#reference_to_id-org.omg.CORBA.Object-">reference_to_id</a></span>(<a href="../../../org/omg/CORBA/Object.html" title="interface in org.omg.CORBA">Object</a> reference)</code>
<div class="block">
此操作返回由指定引用封装的对象Id值。
</div> </td>
</tr>
<tr class="rowColor" id="i21">
<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/POAOperations.html#reference_to_servant-org.omg.CORBA.Object-">reference_to_servant</a></span>(<a href="../../../org/omg/CORBA/Object.html" title="interface in org.omg.CORBA">Object</a> reference)</code>
<div class="block">
如果POA具有RETAIN策略并且活动对象映射中存在指定的对象则此操作将返回与活动对象映射中该对象关联的servant。
</div> </td>
</tr>
<tr class="altColor" id="i22">
<td class="colFirst"><code>byte[]</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../org/omg/PortableServer/POAOperations.html#servant_to_id-org.omg.PortableServer.Servant-">servant_to_id</a></span>(<a href="../../../org/omg/PortableServer/Servant.html" title="class in org.omg.PortableServer">Servant</a> p_servant)</code>
<div class="block">
此操作有四种可能的行为。
</div> </td>
</tr>
<tr class="rowColor" id="i23">
<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/PortableServer/POAOperations.html#servant_to_reference-org.omg.PortableServer.Servant-">servant_to_reference</a></span>(<a href="../../../org/omg/PortableServer/Servant.html" title="class in org.omg.PortableServer">Servant</a> p_servant)</code>
<div class="block">
此操作需要RETAIN策略如果在此POA发出的操作的上下文中被调用则需要UNIQUE_ID或IMPLICIT_ACTIVATION策略。
</div> </td>
</tr>
<tr class="altColor" id="i24">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../org/omg/PortableServer/POAOperations.html#set_servant_manager-org.omg.PortableServer.ServantManager-">set_servant_manager</a></span>(<a href="../../../org/omg/PortableServer/ServantManager.html" title="interface in org.omg.PortableServer">ServantManager</a> imgr)</code>
<div class="block">
此操作设置与POA关联的默认servant管理器。
</div> </td>
</tr>
<tr class="rowColor" id="i25">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../org/omg/PortableServer/POAOperations.html#set_servant-org.omg.PortableServer.Servant-">set_servant</a></span>(<a href="../../../org/omg/PortableServer/Servant.html" title="class in org.omg.PortableServer">Servant</a> p_servant)</code>
<div class="block">
此操作将指定的仆人作为默认仆人注册POA。
</div> </td>
</tr>
<tr class="altColor" id="i26">
<td class="colFirst"><code><a href="../../../org/omg/PortableServer/AdapterActivator.html" title="interface in org.omg.PortableServer">AdapterActivator</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../org/omg/PortableServer/POAOperations.html#the_activator--">the_activator</a></span>()</code>
<div class="block">
此属性标识与POA相关联的适配器激活器。
</div> </td>
</tr>
<tr class="rowColor" id="i27">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../org/omg/PortableServer/POAOperations.html#the_activator-org.omg.PortableServer.AdapterActivator-">the_activator</a></span>(<a href="../../../org/omg/PortableServer/AdapterActivator.html" title="interface in org.omg.PortableServer">AdapterActivator</a> newThe_activator)</code>
<div class="block">
此属性标识与POA相关联的适配器激活器。
</div> </td>
</tr>
<tr class="altColor" id="i28">
<td class="colFirst"><code><a href="../../../org/omg/PortableServer/POA.html" title="interface in org.omg.PortableServer">POA</a>[]</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../org/omg/PortableServer/POAOperations.html#the_children--">the_children</a></span>()</code>
<div class="block">
此属性标识当前POA所有子POA的集合。
</div> </td>
</tr>
<tr class="rowColor" id="i29">
<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/PortableServer/POAOperations.html#the_name--">the_name</a></span>()</code>
<div class="block">
此属性标识相对于其父项的POA。
</div> </td>
</tr>
<tr class="altColor" id="i30">
<td class="colFirst"><code><a href="../../../org/omg/PortableServer/POA.html" title="interface in org.omg.PortableServer">POA</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../org/omg/PortableServer/POAOperations.html#the_parent--">the_parent</a></span>()</code>
<div class="block">
此属性标识POA的父项。
</div> </td>
</tr>
<tr class="rowColor" id="i31">
<td class="colFirst"><code><a href="../../../org/omg/PortableServer/POAManager.html" title="interface in org.omg.PortableServer">POAManager</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../org/omg/PortableServer/POAOperations.html#the_POAManager--">the_POAManager</a></span>()</code>
<div class="block">
该属性标识与POA相关联的POA管理器。
</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="create_POA-java.lang.String-org.omg.PortableServer.POAManager-org.omg.CORBA.Policy:A-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>create_POA</h4> <pre><a href="../../../org/omg/PortableServer/POA.html" title="interface in org.omg.PortableServer">POA</a> create_POA(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> adapter_name,
<a href="../../../org/omg/PortableServer/POAManager.html" title="interface in org.omg.PortableServer">POAManager</a> a_POAManager,
<a href="../../../org/omg/CORBA/Policy.html" title="interface in org.omg.CORBA">Policy</a>[] policies)
throws <a href="../../../org/omg/PortableServer/POAPackage/AdapterAlreadyExists.html" title="class in org.omg.PortableServer.POAPackage">AdapterAlreadyExists</a>,
<a href="../../../org/omg/PortableServer/POAPackage/InvalidPolicy.html" title="class in org.omg.PortableServer.POAPackage">InvalidPolicy</a></pre>
<div class="block">
此操作将创建一个新的POA作为目标POA的子代。
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>adapter_name</code> - 识别相对于具有相同父POA的其他POA的新POA。
</dd>
<dd>
<code>a_POAManager</code> - 指定要与新的POA关联的POA管理器。
</dd>
<dd>
<code>policies</code> - 指定与POA关联以控制其行为的策略对象。
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code>AdapterAlreadyExists</code> - 指定目标POA已经具有指定名称的小孩POA。
</dd>
<dd>
<code>InvalidPolicy</code> - 如果任何策略对象对ORB无效或处于冲突状态或者需要尚未执行的管理操作则引发。
</dd>
</dl> </li>
</ul> <a name="find_POA-java.lang.String-boolean-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>find_POA</h4> <pre><a href="../../../org/omg/PortableServer/POA.html" title="interface in org.omg.PortableServer">POA</a> find_POA(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> adapter_name,
boolean activate_it)
throws <a href="../../../org/omg/PortableServer/POAPackage/AdapterNonExistent.html" title="class in org.omg.PortableServer.POAPackage">AdapterNonExistent</a></pre>
<div class="block">
如果目标POA是具有指定名称相对于目标POA的子级POA的父级则返回该子级POA。
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>adapter_name</code> - 要找到的POA名称。
</dd>
<dd>
<code>activate_it</code> - 如果具有指定名称的POA不存在并且activate_it参数的值为TRUE则调用目标POA的AdapterActivator如果存在
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
POA如果存在或被AdapterActivator激活。
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../../org/omg/PortableServer/POAPackage/AdapterNonExistent.html" title="class in org.omg.PortableServer.POAPackage">AdapterNonExistent</a></code>
</dd>
</dl> </li>
</ul> <a name="destroy-boolean-boolean-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>destroy</h4> <pre>void destroy(boolean etherealize_objects,
boolean wait_for_completion)</pre>
<div class="block">
<span>此操作会破坏POA和所有后代的POA。</span>
<span>在销毁含有POA之前所有后代的POA被销毁递归</span>
<span>可能会在相同的过程中重新创建被破坏的POA也就是其名称的POA</span>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>etherealize_objects</code> - 用于指示是否需要调用对servant管理器的
<code>etherealize_objects</code>化操作的标志。
</dd>
<dd>
<code>wait_for_completion</code> - 用于指示POA及其子女是否需要等待主动请求并且完成语音化的标志。
</dd>
</dl> </li>
</ul> <a name="create_thread_policy-org.omg.PortableServer.ThreadPolicyValue-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>create_thread_policy</h4> <pre><a href="../../../org/omg/PortableServer/ThreadPolicy.html" title="interface in org.omg.PortableServer">ThreadPolicy</a> create_thread_policy(<a href="../../../org/omg/PortableServer/ThreadPolicyValue.html" title="class in org.omg.PortableServer">ThreadPolicyValue</a> value)</pre>
<div class="block">
这些操作都返回具有指定值的策略对象的引用。
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>value</code> - 策略类型
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
ThreadPolcy对象
</dd>
</dl> </li>
</ul> <a name="create_lifespan_policy-org.omg.PortableServer.LifespanPolicyValue-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>create_lifespan_policy</h4> <pre><a href="../../../org/omg/PortableServer/LifespanPolicy.html" title="interface in org.omg.PortableServer">LifespanPolicy</a> create_lifespan_policy(<a href="../../../org/omg/PortableServer/LifespanPolicyValue.html" title="class in org.omg.PortableServer">LifespanPolicyValue</a> value)</pre>
<div class="block">
这些操作都返回具有指定值的策略对象的引用。
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>value</code> - 政策类型
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
LifespanPolicy对象。
</dd>
</dl> </li>
</ul> <a name="create_id_uniqueness_policy-org.omg.PortableServer.IdUniquenessPolicyValue-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>create_id_uniqueness_policy</h4> <pre><a href="../../../org/omg/PortableServer/IdUniquenessPolicy.html" title="interface in org.omg.PortableServer">IdUniquenessPolicy</a> create_id_uniqueness_policy(<a href="../../../org/omg/PortableServer/IdUniquenessPolicyValue.html" title="class in org.omg.PortableServer">IdUniquenessPolicyValue</a> value)</pre>
<div class="block">
这些操作都返回具有指定值的策略对象的引用。
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>value</code> - 策略类型
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
IdUniquenessPolicy对象。
</dd>
</dl> </li>
</ul> <a name="create_id_assignment_policy-org.omg.PortableServer.IdAssignmentPolicyValue-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>create_id_assignment_policy</h4> <pre><a href="../../../org/omg/PortableServer/IdAssignmentPolicy.html" title="interface in org.omg.PortableServer">IdAssignmentPolicy</a> create_id_assignment_policy(<a href="../../../org/omg/PortableServer/IdAssignmentPolicyValue.html" title="class in org.omg.PortableServer">IdAssignmentPolicyValue</a> value)</pre>
<div class="block">
这些操作都返回具有指定值的策略对象的引用。
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>value</code> - 策略类型
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
IdAssignmentPolicy对象。
</dd>
</dl> </li>
</ul> <a name="create_implicit_activation_policy-org.omg.PortableServer.ImplicitActivationPolicyValue-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>create_implicit_activation_policy</h4> <pre><a href="../../../org/omg/PortableServer/ImplicitActivationPolicy.html" title="interface in org.omg.PortableServer">ImplicitActivationPolicy</a> create_implicit_activation_policy(<a href="../../../org/omg/PortableServer/ImplicitActivationPolicyValue.html" title="class in org.omg.PortableServer">ImplicitActivationPolicyValue</a> value)</pre>
<div class="block">
这些操作都返回具有指定值的策略对象的引用。
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>value</code> - 策略类型
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
ImplicitActivationPolicy对象。
</dd>
</dl> </li>
</ul> <a name="create_servant_retention_policy-org.omg.PortableServer.ServantRetentionPolicyValue-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>create_servant_retention_policy</h4> <pre><a href="../../../org/omg/PortableServer/ServantRetentionPolicy.html" title="interface in org.omg.PortableServer">ServantRetentionPolicy</a> create_servant_retention_policy(<a href="../../../org/omg/PortableServer/ServantRetentionPolicyValue.html" title="class in org.omg.PortableServer">ServantRetentionPolicyValue</a> value)</pre>
<div class="block">
这些操作都返回具有指定值的策略对象的引用。
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>value</code> - 策略类型
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
ServantRetentionPolicy对象。
</dd>
</dl> </li>
</ul> <a name="create_request_processing_policy-org.omg.PortableServer.RequestProcessingPolicyValue-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>create_request_processing_policy</h4> <pre><a href="../../../org/omg/PortableServer/RequestProcessingPolicy.html" title="interface in org.omg.PortableServer">RequestProcessingPolicy</a> create_request_processing_policy(<a href="../../../org/omg/PortableServer/RequestProcessingPolicyValue.html" title="class in org.omg.PortableServer">RequestProcessingPolicyValue</a> value)</pre>
<div class="block">
这些操作都返回具有指定值的策略对象的引用。
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>value</code> - 策略类型
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
RequestProcessingPolicy对象。
</dd>
</dl> </li>
</ul> <a name="the_name--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>the_name</h4> <pre><a href="../../../java/lang/String.html" title="class in java.lang">String</a> the_name()</pre>
<div class="block">
<span>此属性标识相对于其父项的POA。</span>
<span>创建POA时将分配此名称。</span>
</div> </li>
</ul> <a name="the_parent--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>the_parent</h4> <pre><a href="../../../org/omg/PortableServer/POA.html" title="interface in org.omg.PortableServer">POA</a> the_parent()</pre>
<div class="block">
<span>此属性标识POA的父项。</span>
<span>根POA的父节点为null。</span>
</div> </li>
</ul> <a name="the_children--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>the_children</h4> <pre><a href="../../../org/omg/PortableServer/POA.html" title="interface in org.omg.PortableServer">POA</a>[] the_children()</pre>
<div class="block">
<span>此属性标识当前POA所有子POA的集合。</span>
<span>一组儿童保护协定只包括美国在内的直系儿童,而不是他们的后代。</span>
</div> </li>
</ul> <a name="the_POAManager--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>the_POAManager</h4> <pre><a href="../../../org/omg/PortableServer/POAManager.html" title="interface in org.omg.PortableServer">POAManager</a> the_POAManager()</pre>
<div class="block">
该属性标识与POA相关联的POA管理器。
</div> </li>
</ul> <a name="the_activator--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>the_activator</h4> <pre><a href="../../../org/omg/PortableServer/AdapterActivator.html" title="interface in org.omg.PortableServer">AdapterActivator</a> the_activator()</pre>
<div class="block">
此属性标识与POA相关联的适配器激活器。
</div> </li>
</ul> <a name="the_activator-org.omg.PortableServer.AdapterActivator-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>the_activator</h4> <pre>void the_activator(<a href="../../../org/omg/PortableServer/AdapterActivator.html" title="interface in org.omg.PortableServer">AdapterActivator</a> newThe_activator)</pre>
<div class="block">
此属性标识与POA相关联的适配器激活器。
</div> </li>
</ul> <a name="get_servant_manager--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>get_servant_manager</h4> <pre><a href="../../../org/omg/PortableServer/ServantManager.html" title="interface in org.omg.PortableServer">ServantManager</a> get_servant_manager()
throws <a href="../../../org/omg/PortableServer/POAPackage/WrongPolicy.html" title="class in org.omg.PortableServer.POAPackage">WrongPolicy</a></pre>
<div class="block">
<span>如果POA的ServantRetentionPolicy是RETAIN则ServantManager参数imgr将支持ServantActivator接口。</span>
<span>对于NON_RETAIN策略ServantManager将支持ServantLocator接口。</span>
<span>如果参数为nil或不支持所需的接口则会引发OBJ_ADAPTER异常。</span>
</div>
<dl>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
与POA关联的ServantManager如果不存在则为null。
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code>WrongPolicy</code> - 如果未指定USE_SERVANT_MANAGER策略则引发。
</dd>
</dl> </li>
</ul> <a name="set_servant_manager-org.omg.PortableServer.ServantManager-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>set_servant_manager</h4> <pre>void set_servant_manager(<a href="../../../org/omg/PortableServer/ServantManager.html" title="interface in org.omg.PortableServer">ServantManager</a> imgr)
throws <a href="../../../org/omg/PortableServer/POAPackage/WrongPolicy.html" title="class in org.omg.PortableServer.POAPackage">WrongPolicy</a></pre>
<div class="block">
<span>此操作设置与POA关联的默认servant管理器。</span>
<span>此操作只能在创建POA后调用一次。</span>
<span>尝试在已设置一个服务器管理器之后会导致引发BAD_INV_ORDER异常。</span>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>imgr</code> - 用作默认的servant manager。
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code>WrongPolicy</code> - 如果未指定USE_SERVANT_MANAGER策略则引发。
</dd>
</dl> </li>
</ul> <a name="get_servant--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>get_servant</h4> <pre><a href="../../../org/omg/PortableServer/Servant.html" title="class in org.omg.PortableServer">Servant</a> get_servant()
throws <a href="../../../org/omg/PortableServer/POAPackage/NoServant.html" title="class in org.omg.PortableServer.POAPackage">NoServant</a>,
<a href="../../../org/omg/PortableServer/POAPackage/WrongPolicy.html" title="class in org.omg.PortableServer.POAPackage">WrongPolicy</a></pre>
<div class="block">
此操作返回与POA关联的默认servant。
</div>
<dl>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
p_servant与POA关联的默认servant。
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code>NoServant</code> - 如果没有与POA相关联的默认servant则引发。
</dd>
<dd>
<code>WrongPolicy</code> - 如果未指定USE_DEFAULT_SERVANT策略则引发。
</dd>
</dl> </li>
</ul> <a name="set_servant-org.omg.PortableServer.Servant-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>set_servant</h4> <pre>void set_servant(<a href="../../../org/omg/PortableServer/Servant.html" title="class in org.omg.PortableServer">Servant</a> p_servant)
throws <a href="../../../org/omg/PortableServer/POAPackage/WrongPolicy.html" title="class in org.omg.PortableServer.POAPackage">WrongPolicy</a></pre>
<div class="block">
<span>此操作将指定的仆人作为默认仆人注册POA。</span>
<span>该仆人将用于在活动对象映射中找不到仆人的所有请求。</span>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>p_servant</code> - 用作默认的servant。
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code>WrongPolicy</code> - 未指定USE_DEFAULT_SERVANT策略时引发。
</dd>
</dl> </li>
</ul> <a name="activate_object-org.omg.PortableServer.Servant-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>activate_object</h4> <pre>byte[] activate_object(<a href="../../../org/omg/PortableServer/Servant.html" title="class in org.omg.PortableServer">Servant</a> p_servant)
throws <a href="../../../org/omg/PortableServer/POAPackage/ServantAlreadyActive.html" title="class in org.omg.PortableServer.POAPackage">ServantAlreadyActive</a>,
<a href="../../../org/omg/PortableServer/POAPackage/WrongPolicy.html" title="class in org.omg.PortableServer.POAPackage">WrongPolicy</a></pre>
<div class="block">
此操作生成对象标识,并在活动对象映射中输入对象标识和指定的仆人。
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>p_servant</code> - 要与要激活的对象关联的servant。
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
POA生成对象id。
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code>ServantAlreadyActive</code> - 如果POA具有UNIQUE_ID策略并且servant已经在活动对象映射中则被引发。
</dd>
<dd>
<code>WrongPolicy</code> - 如果未指定SYSTEM_ID和RETAIN策略则引发。
</dd>
</dl> </li>
</ul> <a name="activate_object_with_id-byte:A-org.omg.PortableServer.Servant-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>activate_object_with_id</h4> <pre>void activate_object_with_id(byte[] id,
<a href="../../../org/omg/PortableServer/Servant.html" title="class in org.omg.PortableServer">Servant</a> p_servant)
throws <a href="../../../org/omg/PortableServer/POAPackage/ServantAlreadyActive.html" title="class in org.omg.PortableServer.POAPackage">ServantAlreadyActive</a>,
<a href="../../../org/omg/PortableServer/POAPackage/ObjectAlreadyActive.html" title="class in org.omg.PortableServer.POAPackage">ObjectAlreadyActive</a>,
<a href="../../../org/omg/PortableServer/POAPackage/WrongPolicy.html" title="class in org.omg.PortableServer.POAPackage">WrongPolicy</a></pre>
<div class="block">
此操作将在“活动对象映射”中输入指定的对象标识和指定服务器之间的关联。
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>id</code> - 要激活的对象的对象标识。
</dd>
<dd>
<code>p_servant</code> - 与对象
<code>p_servant</code> servant。
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code>ServantAlreadyActive</code> - 如果POA具有UNIQUE_ID策略并且仆人已经在活动对象映射中则引发。
</dd>
<dd>
<code>ObjectAlreadyActive</code> - 如果对象在POA中已经处于活动状态则引发。
</dd>
<dd>
<code>WrongPolicy</code> - 如果未指定RETAIN策略则引发。
</dd>
</dl> </li>
</ul> <a name="deactivate_object-byte:A-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>deactivate_object</h4> <pre>void deactivate_object(byte[] oid)
throws <a href="../../../org/omg/PortableServer/POAPackage/ObjectNotActive.html" title="class in org.omg.PortableServer.POAPackage">ObjectNotActive</a>,
<a href="../../../org/omg/PortableServer/POAPackage/WrongPolicy.html" title="class in org.omg.PortableServer.POAPackage">WrongPolicy</a></pre>
<div class="block">
<span>此操作会导致在oid参数中指定的ObjectId被禁用。</span>
<span>已禁用的ObjectId继续处理请求直到对该ObjectID没有活动请求为止。</span>
<span>当为该ObjectId执行的所有请求都已完成时从活动对象映射中删除已停用的ObjectId。</span>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>oid</code> - 要停用对象的对象标识。
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code>ObjectNotActive</code> - 如果具有指定oid的对象不在活动对象映射中。
</dd>
<dd>
<code>WrongPolicy</code> - 如果未指定RETAIN策略则引发。
</dd>
</dl> </li>
</ul> <a name="create_reference-java.lang.String-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>create_reference</h4> <pre><a href="../../../org/omg/CORBA/Object.html" title="interface in org.omg.CORBA">Object</a> create_reference(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> intf)
throws <a href="../../../org/omg/PortableServer/POAPackage/WrongPolicy.html" title="class in org.omg.PortableServer.POAPackage">WrongPolicy</a></pre>
<div class="block">
此操作创建一个对象引用该引用封装了POA生成的对象标识值和指定的接口存储库标识。
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>intf</code> - 用于创建对象引用的rep id。
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
使用intf创建的对象引用。
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code>WrongPolicy</code> - 如果未指定SYSTEM_ID策略。
</dd>
</dl> </li>
</ul> <a name="create_reference_with_id-byte:A-java.lang.String-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>create_reference_with_id</h4> <pre><a href="../../../org/omg/CORBA/Object.html" title="interface in org.omg.CORBA">Object</a> create_reference_with_id(byte[] oid,
<a href="../../../java/lang/String.html" title="class in java.lang">String</a> intf)</pre>
<div class="block">
<span>此操作创建一个对象引用,该引用封装了指定的对象标识和接口存储库标识值。</span>
<span>它不会导致激活。</span>
<span>生成的引用可以传递给客户端,以便对这些引用的后续请求将导致必要时激活对象,或根据适用的策略使用默认服务方。</span>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>oid</code> - 创建对象的对象标识
</dd>
<dd>
<code>intf</code> - 创建对象的代码
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
使用oid和intf创建的对象引用
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code>BAD_PARAM</code> - 如果POA具有SYSTEM_ID策略并且它检测到对象Id值不是由系统生成的或该POA引起的。
</dd>
</dl> </li>
</ul> <a name="servant_to_id-org.omg.PortableServer.Servant-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>servant_to_id</h4> <pre>byte[] servant_to_id(<a href="../../../org/omg/PortableServer/Servant.html" title="class in org.omg.PortableServer">Servant</a> p_servant)
throws <a href="../../../org/omg/PortableServer/POAPackage/ServantNotActive.html" title="class in org.omg.PortableServer.POAPackage">ServantNotActive</a>,
<a href="../../../org/omg/PortableServer/POAPackage/WrongPolicy.html" title="class in org.omg.PortableServer.POAPackage">WrongPolicy</a></pre>
<div class="block">
<span>此操作有四种可能的行为。</span>
<span>1.如果POA具有UNIQUE_ID策略并且指定的servant处于活动状态则返回与该servant相关联的Object Id。</span>
<span>2.如果POA具有IMPLICIT_ACTIVATION策略并且POA具有MULTIPLE_ID策略或指定的servant不活动则使用POA生成的对象Id和与服务方关联的接口Id激活服务方并且该对象Id为回。</span>
<span>3.如果POA具有USE_DEFAULT_SERVANT策略则指定的servant是默认servant并且在执行对默认servant的请求的上下文中调用操作则返回与当前调用关联的ObjectId。</span>
<span>否则会引发ServantNotActive异常。</span>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>p_servant</code> - 对象disi返回的servant。
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
与仆人关联的对象标识。
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code>ServantNotActive</code> - 如果不符合上述规则和策略组合。
</dd>
<dd>
<code>WrongPolicy</code> - 如果USE_DEFAULT_SERVANT策略或RETAIN策略和UNIQUE_ID或IMPLICIT_ACTIVATION策略的组合不存在。
</dd>
</dl> </li>
</ul> <a name="servant_to_reference-org.omg.PortableServer.Servant-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>servant_to_reference</h4> <pre><a href="../../../org/omg/CORBA/Object.html" title="interface in org.omg.CORBA">Object</a> servant_to_reference(<a href="../../../org/omg/PortableServer/Servant.html" title="class in org.omg.PortableServer">Servant</a> p_servant)
throws <a href="../../../org/omg/PortableServer/POAPackage/ServantNotActive.html" title="class in org.omg.PortableServer.POAPackage">ServantNotActive</a>,
<a href="../../../org/omg/PortableServer/POAPackage/WrongPolicy.html" title="class in org.omg.PortableServer.POAPackage">WrongPolicy</a></pre>
<div class="block">
<span>此操作需要RETAIN策略如果在此POA发出的操作的上下文中被调用则需要UNIQUE_ID或IMPLICIT_ACTIVATION策略。</span>
<span>它有四种可能的行为。</span>
<span>1.如果POA同时具有RETAIN和UNIQUE_ID策略并且指定的servant处于活动状态则返回封装用于激活servant的信息的对象引用。</span>
<span>2.如果POA同时具有RETAIN和IMPLICIT_ACTIVATION策略并且POA具有MULTIPLE_ID策略或指定的servant不活动则使用POA生成的对象Id和与仆人相关联的Interface Id来激活仆人以及将返回相应的对象引用。</span>
<span>3.如果在对指定服务方执行请求的上下文中调用操作,则返回与当前调用相关联的引用。</span>
<span>否则会引发ServantNotActive异常。</span>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>p_servant</code> - 需要获取对象引用的servant。
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
与仆人关联的对象引用。
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code>WrongPolicy</code> - 如果在执行对指定服务方的请求的上下文中未调用操作,并且所需的策略不存在。
</dd>
<dd>
<code>ServantNotActive</code> - 如果不符合上述指定的政策和规则。
</dd>
</dl> </li>
</ul> <a name="reference_to_servant-org.omg.CORBA.Object-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>reference_to_servant</h4> <pre><a href="../../../org/omg/PortableServer/Servant.html" title="class in org.omg.PortableServer">Servant</a> reference_to_servant(<a href="../../../org/omg/CORBA/Object.html" title="interface in org.omg.CORBA">Object</a> reference)
throws <a href="../../../org/omg/PortableServer/POAPackage/ObjectNotActive.html" title="class in org.omg.PortableServer.POAPackage">ObjectNotActive</a>,
<a href="../../../org/omg/PortableServer/POAPackage/WrongPolicy.html" title="class in org.omg.PortableServer.POAPackage">WrongPolicy</a>,
<a href="../../../org/omg/PortableServer/POAPackage/WrongAdapter.html" title="class in org.omg.PortableServer.POAPackage">WrongAdapter</a></pre>
<div class="block">
<span>如果POA具有RETAIN策略并且活动对象映射中存在指定的对象则此操作将返回与活动对象映射中该对象关联的servant。</span>
<span>否则如果POA具有USE_DEFAULT_SERVANT策略并且已将默认服务器注册到POA则此操作将返回默认服务方。</span>
<span>如果此POA未创建对象引用则会引发WrongAdapter异常。</span>
<span>OMG问题与POA.IDL不一致。</span>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>reference</code> - 返回servant的对象引用。
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
与参考有关的仆人。
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code>WrongPolicy</code> - 如果不存在RETAIN策略或USE_DEFAULT_SERVANT策略。
</dd>
<dd>
<code>ObjectNotActive</code> - 如果活动对象映射对于RETAIN中不存在servant或没有注册默认servant对于USE_DEFAULT_POLICY
</dd>
<dd>
<code>WrongAdapter</code> - 如果此POA实例未创建引用。
</dd>
</dl> </li>
</ul> <a name="reference_to_id-org.omg.CORBA.Object-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>reference_to_id</h4> <pre>byte[] reference_to_id(<a href="../../../org/omg/CORBA/Object.html" title="interface in org.omg.CORBA">Object</a> reference)
throws <a href="../../../org/omg/PortableServer/POAPackage/WrongAdapter.html" title="class in org.omg.PortableServer.POAPackage">WrongAdapter</a>,
<a href="../../../org/omg/PortableServer/POAPackage/WrongPolicy.html" title="class in org.omg.PortableServer.POAPackage">WrongPolicy</a></pre>
<div class="block">
<span>此操作返回由指定引用封装的对象Id值。</span>
<span>该操作仅在由执行操作的POA创建引用时有效。</span>
<span>引用表示的对象不必为此操作有效而成功。</span>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>reference</code> - 需要返回对象id的对象引用。
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
对象id封装在引用中。
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code>WrongAdapter</code> - 如果引用不是由引用中指定的POA创建的。
</dd>
<dd>
<code>WrongPolicy</code> - 声明允许将来的扩展。
</dd>
</dl> </li>
</ul> <a name="id_to_servant-byte:A-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>id_to_servant</h4> <pre><a href="../../../org/omg/PortableServer/Servant.html" title="class in org.omg.PortableServer">Servant</a> id_to_servant(byte[] oid)
throws <a href="../../../org/omg/PortableServer/POAPackage/ObjectNotActive.html" title="class in org.omg.PortableServer.POAPackage">ObjectNotActive</a>,
<a href="../../../org/omg/PortableServer/POAPackage/WrongPolicy.html" title="class in org.omg.PortableServer.POAPackage">WrongPolicy</a></pre>
<div class="block">
<span>如果POA具有RETAIN策略并且指定的ObjectId位于活动对象映射中则此操作将返回与活动对象映射中该对象关联的servant。</span>
<span>否则如果POA具有USE_DEFAULT_SERVANT策略并且已将默认服务器注册到POA则此操作将返回默认服务方。</span>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>oid</code> - 返回仆人的对象标识。
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
与oid相关的仆人
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code>ObjectNotActive</code> - 如果ObjectId不在活动对象映射中对于RETAIN策略或者没有注册默认服务器对于USE_DEFAULT_SERVANT策略则生成。
</dd>
<dd>
<code>WrongPolicy</code> - 如果不存在RETAIN策略或USE_DEFAULT_SERVANT策略则会被引发。
</dd>
</dl> </li>
</ul> <a name="id_to_reference-byte:A-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>id_to_reference</h4> <pre><a href="../../../org/omg/CORBA/Object.html" title="interface in org.omg.CORBA">Object</a> id_to_reference(byte[] oid)
throws <a href="../../../org/omg/PortableServer/POAPackage/ObjectNotActive.html" title="class in org.omg.PortableServer.POAPackage">ObjectNotActive</a>,
<a href="../../../org/omg/PortableServer/POAPackage/WrongPolicy.html" title="class in org.omg.PortableServer.POAPackage">WrongPolicy</a></pre>
<div class="block">
如果具有指定的Object Id值的对象当前处于活动状态则返回封装用于激活对象的信息的引用。
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>oid</code> - 返回引用的对象的id。
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
对象引用
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code>ObjectNotActive</code> - 如果对象标识值在POA中未激活。
</dd>
<dd>
<code>WrongPolicy</code> - 如果不存在保留策略。
</dd>
</dl> </li>
</ul> <a name="id--">
<!-- --> </a>
<ul class="blockListLast">
<li class="blockList"> <h4>id</h4> <pre>byte[] id()</pre>
<div class="block">
<span>这将在其创建的过程中返回POA的唯一ID。</span>
<span>它由便携式拦截器使用。</span>
<p> <span>该ID在过程中保持POA的寿命独特。</span> <span>对于持久的POA这意味着如果在与另一个POA具有相同名称的同一路径中创建POA则这些POA是相同的因此具有相同的id。</span> <span>对于暂时的POA每个POA是唯一的。</span> </p>
</div> </li>
</ul> </li>
</ul> </li>
</ul>
</div>
</div>