uTools-Manuals/docs/java/javax/management/relation/RelationSupport.html

<div class="header">
<div class="subTitle">
     compact3 
   </div>
<div class="subTitle">
     javax.management.relation 
   </div>
<h2 class="title" title="Class RelationSupport">Class RelationSupport</h2>
</div><div class="contentContainer">
<ul class="inheritance">
<li><a href="../../../java/lang/Object.html" title="class in java.lang">java.lang.Object</a></li>
<li>
<ul class="inheritance">
<li>javax.management.relation.RelationSupport</li>
</ul> </li>
</ul>
<div class="description">
<ul class="blockList">
<li class="blockList">
<dl>
<dt>
         All Implemented Interfaces: 
       </dt>
<dd>
<span><a href="../../../javax/management/MBeanRegistration.html" title="javax.management中的接口">MBeanRegistration</a> ， <a href="../../../javax/management/relation/Relation.html" title="javax.management.relation中的接口">Relation</a> ， <a href="../../../javax/management/relation/RelationSupportMBean.html" title="javax.management.relation中的接口">RelationSupportMBean</a></span>
</dd>
</dl>
<hr/> <br/> <pre>public class <span class="typeNameLabel">RelationSupport</span>
extends <a href="../../../java/lang/Object.html" title="class in java.lang">Object</a>
implements <a href="../../../javax/management/relation/RelationSupportMBean.html" title="interface in javax.management.relation">RelationSupportMBean</a>, <a href="../../../javax/management/MBeanRegistration.html" title="interface in javax.management">MBeanRegistration</a></pre>
<div class="block">
<span>RelationSupport对象由Relation Service内部使用，用于表示任意关系类型的简单关系（只有角色，无属性或方法）以及无限数量的角色。</span>
<span>作为内部表示，它不会暴露给用户。</span>
<p> <span>RelationSupport类符合标准MBean的设计模式。</span> <span>因此，用户可以自己将RelationSupport对象实例化为MBean（遵循MBean设计模式），将其注册到MBean服务器中，然后将其添加到关系服务中。</span> </p>
<p> <span>用户还可以在创建自己的MBean关系类时，扩展RelationSupport，以检索所需接口的实现（见下文）。</span> </p>
<p> <span>还可以在一个用户关系MBean类中有一个成员是一个RelationSupport对象，并通过将所有的对象委托给该成员来实现所需的接口。</span> </p>
<p> <span>RelationSupport实现了Relation接口（由Relation Service处理）。</span> </p>
<p> <span>它还实现了MBeanRegistration接口，以便能够检索其注册的MBean服务器（如果注册为MBean）以访问其关系服务。</span> </p>
</div>
<dl>
<dt>
<span class="simpleTagLabel">从以下版本开始：</span>
</dt>
<dd>
         1.5 
       </dd>
</dl> </li>
</ul>
</div>
<div class="summary">
<ul class="blockList">
<li class="blockList">
<!-- ======== CONSTRUCTOR SUMMARY ======== -->
<ul class="blockList">
<li class="blockList"><a name="constructor.summary">
<!-- --> </a> <h3>构造方法摘要</h3>
<table border="0" cellpadding="3" cellspacing="0" class="memberSummary" summary="Constructor Summary table, listing constructors, and an explanation">
<caption>
<span>构造方法</span>
<span class="tabEnd"> </span>
</caption>
<tbody>
<tr>
<th class="colOne" scope="col">Constructor and Description</th>
</tr>
<tr class="altColor">
<td class="colOne"><code><span class="memberNameLink"><a href="../../../javax/management/relation/RelationSupport.html#RelationSupport-java.lang.String-javax.management.ObjectName-javax.management.MBeanServer-java.lang.String-javax.management.relation.RoleList-">RelationSupport</a></span>(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> relationId, <a href="../../../javax/management/ObjectName.html" title="class in javax.management">ObjectName</a> relationServiceName, <a href="../../../javax/management/MBeanServer.html" title="interface in javax.management">MBeanServer</a> relationServiceMBeanServer, <a href="../../../java/lang/String.html" title="class in java.lang">String</a> relationTypeName, <a href="../../../javax/management/relation/RoleList.html" title="class in javax.management.relation">RoleList</a> list)</code>
<div class="block">
              创建一个 
             <code>RelationSupport</code>对象。 
            </div> </td>
</tr>
<tr class="rowColor">
<td class="colOne"><code><span class="memberNameLink"><a href="../../../javax/management/relation/RelationSupport.html#RelationSupport-java.lang.String-javax.management.ObjectName-java.lang.String-javax.management.relation.RoleList-">RelationSupport</a></span>(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> relationId, <a href="../../../javax/management/ObjectName.html" title="class in javax.management">ObjectName</a> relationServiceName, <a href="../../../java/lang/String.html" title="class in java.lang">String</a> relationTypeName, <a href="../../../javax/management/relation/RoleList.html" title="class in javax.management.relation">RoleList</a> list)</code>
<div class="block">
              创建一个 
             <code>RelationSupport</code>对象。 
            </div> </td>
</tr>
</tbody>
</table> </li>
</ul>
<!-- ========== 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="t4"><span><a href="javascript:show(8);">具体的方法</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><a href="../../../javax/management/relation/RoleResult.html" title="class in javax.management.relation">RoleResult</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/management/relation/RelationSupport.html#getAllRoles--">getAllRoles</a></span>()</code>
<div class="block">
              返回关系中存在的所有角色。 
            </div> </td>
</tr>
<tr class="rowColor" id="i1">
<td class="colFirst"><code><a href="../../../java/util/Map.html" title="interface in java.util">Map</a>&lt;<a href="../../../javax/management/ObjectName.html" title="class in javax.management">ObjectName</a>,<a href="../../../java/util/List.html" title="interface in java.util">List</a>&lt;<a href="../../../java/lang/String.html" title="class in java.lang">String</a>&gt;&gt;</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/management/relation/RelationSupport.html#getReferencedMBeans--">getReferencedMBeans</a></span>()</code>
<div class="block">
              检索在关系的各种角色中引用的MBean。 
            </div> </td>
</tr>
<tr class="altColor" id="i2">
<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="../../../javax/management/relation/RelationSupport.html#getRelationId--">getRelationId</a></span>()</code>
<div class="block">
              返回关系标识符（用于唯一标识关系服务中的关系）。 
            </div> </td>
</tr>
<tr class="rowColor" id="i3">
<td class="colFirst"><code><a href="../../../javax/management/ObjectName.html" title="class in javax.management">ObjectName</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/management/relation/RelationSupport.html#getRelationServiceName--">getRelationServiceName</a></span>()</code>
<div class="block">
              返回处理关系的关系服务的ObjectName。 
            </div> </td>
</tr>
<tr class="altColor" id="i4">
<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="../../../javax/management/relation/RelationSupport.html#getRelationTypeName--">getRelationTypeName</a></span>()</code>
<div class="block">
              返回关联关系类型的名称。 
            </div> </td>
</tr>
<tr class="rowColor" id="i5">
<td class="colFirst"><code><a href="../../../java/util/List.html" title="interface in java.util">List</a>&lt;<a href="../../../javax/management/ObjectName.html" title="class in javax.management">ObjectName</a>&gt;</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/management/relation/RelationSupport.html#getRole-java.lang.String-">getRole</a></span>(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> roleName)</code>
<div class="block">
              检索给定角色名称的角色值。 
            </div> </td>
</tr>
<tr class="altColor" id="i6">
<td class="colFirst"><code><a href="../../../java/lang/Integer.html" title="class in java.lang">Integer</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/management/relation/RelationSupport.html#getRoleCardinality-java.lang.String-">getRoleCardinality</a></span>(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> roleName)</code>
<div class="block">
              返回当前在给定角色中引用的MBean数。 
            </div> </td>
</tr>
<tr class="rowColor" id="i7">
<td class="colFirst"><code><a href="../../../javax/management/relation/RoleResult.html" title="class in javax.management.relation">RoleResult</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/management/relation/RelationSupport.html#getRoles-java.lang.String:A-">getRoles</a></span>(<a href="../../../java/lang/String.html" title="class in java.lang">String</a>[] roleNameArray)</code>
<div class="block">
              检索具有给定名称的角色值。 
            </div> </td>
</tr>
<tr class="altColor" id="i8">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/management/relation/RelationSupport.html#handleMBeanUnregistration-javax.management.ObjectName-java.lang.String-">handleMBeanUnregistration</a></span>(<a href="../../../javax/management/ObjectName.html" title="class in javax.management">ObjectName</a> objectName, <a href="../../../java/lang/String.html" title="class in java.lang">String</a> roleName)</code>
<div class="block">
              当角色引用的MBean未注册时，关系服务使用的回调。 
            </div> </td>
</tr>
<tr class="rowColor" id="i9">
<td class="colFirst"><code><a href="../../../java/lang/Boolean.html" title="class in java.lang">Boolean</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/management/relation/RelationSupport.html#isInRelationService--">isInRelationService</a></span>()</code>
<div class="block">
              返回一个内部标志，指定对象是否仍由关系服务处理。 
            </div> </td>
</tr>
<tr class="altColor" id="i10">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/management/relation/RelationSupport.html#postDeregister--">postDeregister</a></span>()</code>
<div class="block">
              允许MBean在MBean服务器中取消注册后执行所需的任何操作。 
            </div> </td>
</tr>
<tr class="rowColor" id="i11">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/management/relation/RelationSupport.html#postRegister-java.lang.Boolean-">postRegister</a></span>(<a href="../../../java/lang/Boolean.html" title="class in java.lang">Boolean</a> registrationDone)</code>
<div class="block">
              允许MBean在MBean服务器中注册或注册失败后执行所需的操作。 
            </div> </td>
</tr>
<tr class="altColor" id="i12">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/management/relation/RelationSupport.html#preDeregister--">preDeregister</a></span>()</code>
<div class="block">
              允许MBean在MBean服务器取消注册之前执行所需的任何操作。 
            </div> </td>
</tr>
<tr class="rowColor" id="i13">
<td class="colFirst"><code><a href="../../../javax/management/ObjectName.html" title="class in javax.management">ObjectName</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/management/relation/RelationSupport.html#preRegister-javax.management.MBeanServer-javax.management.ObjectName-">preRegister</a></span>(<a href="../../../javax/management/MBeanServer.html" title="interface in javax.management">MBeanServer</a> server, <a href="../../../javax/management/ObjectName.html" title="class in javax.management">ObjectName</a> name)</code>
<div class="block">
              允许MBean在MBean服务器注册之前执行所需的任何操作。 
            </div> </td>
</tr>
<tr class="altColor" id="i14">
<td class="colFirst"><code><a href="../../../javax/management/relation/RoleList.html" title="class in javax.management.relation">RoleList</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/management/relation/RelationSupport.html#retrieveAllRoles--">retrieveAllRoles</a></span>()</code>
<div class="block">
              返回关系中的所有角色，而不检查读取模式。 
            </div> </td>
</tr>
<tr class="rowColor" id="i15">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/management/relation/RelationSupport.html#setRelationServiceManagementFlag-java.lang.Boolean-">setRelationServiceManagementFlag</a></span>(<a href="../../../java/lang/Boolean.html" title="class in java.lang">Boolean</a> flag)</code>
<div class="block">
              指定该关系是否由关系服务处理。 
            </div> </td>
</tr>
<tr class="altColor" id="i16">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/management/relation/RelationSupport.html#setRole-javax.management.relation.Role-">setRole</a></span>(<a href="../../../javax/management/relation/Role.html" title="class in javax.management.relation">Role</a> role)</code>
<div class="block">
              设置给定的角色。 
            </div> </td>
</tr>
<tr class="rowColor" id="i17">
<td class="colFirst"><code><a href="../../../javax/management/relation/RoleResult.html" title="class in javax.management.relation">RoleResult</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/management/relation/RelationSupport.html#setRoles-javax.management.relation.RoleList-">setRoles</a></span>(<a href="../../../javax/management/relation/RoleList.html" title="class in javax.management.relation">RoleList</a> list)</code>
<div class="block">
              设置给定的角色。 
            </div> </td>
</tr>
</tbody>
</table>
<ul class="blockList">
<li class="blockList"><a name="methods.inherited.from.class.java.lang.Object">
<!-- --> </a> <h3>Methods inherited from class java.lang.<a href="../../../java/lang/Object.html" title="class in java.lang">Object</a></h3> <code><a href="../../../java/lang/Object.html#clone--">clone</a>, <a href="../../../java/lang/Object.html#equals-java.lang.Object-">equals</a>, <a href="../../../java/lang/Object.html#finalize--">finalize</a>, <a href="../../../java/lang/Object.html#getClass--">getClass</a>, <a href="../../../java/lang/Object.html#hashCode--">hashCode</a>, <a href="../../../java/lang/Object.html#notify--">notify</a>, <a href="../../../java/lang/Object.html#notifyAll--">notifyAll</a>, <a href="../../../java/lang/Object.html#toString--">toString</a>, <a href="../../../java/lang/Object.html#wait--">wait</a>, <a href="../../../java/lang/Object.html#wait-long-">wait</a>, <a href="../../../java/lang/Object.html#wait-long-int-">wait</a></code></li>
</ul> </li>
</ul> </li>
</ul>
</div>
<div class="details">
<ul class="blockList">
<li class="blockList">
<!-- ========= CONSTRUCTOR DETAIL ======== -->
<ul class="blockList">
<li class="blockList"><a name="constructor.detail">
<!-- --> </a> <h3>构造方法详细信息</h3> <a name="RelationSupport-java.lang.String-javax.management.ObjectName-java.lang.String-javax.management.relation.RoleList-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>RelationSupport</h4> <pre>public RelationSupport(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> relationId,
                       <a href="../../../javax/management/ObjectName.html" title="class in javax.management">ObjectName</a> relationServiceName,
                       <a href="../../../java/lang/String.html" title="class in java.lang">String</a> relationTypeName,
                       <a href="../../../javax/management/relation/RoleList.html" title="class in javax.management.relation">RoleList</a> list)
                throws <a href="../../../javax/management/relation/InvalidRoleValueException.html" title="class in javax.management.relation">InvalidRoleValueException</a>,
                       <a href="../../../java/lang/IllegalArgumentException.html" title="class in java.lang">IllegalArgumentException</a></pre>
<div class="block">
<span>创建一个<code>RelationSupport</code>对象。</span>
<p> <span>当RelationSupport对象将由用户注册为MBean时，或者创建类扩展了RelationSupport的用户关系MBean时，必须使用此构造函数。</span> </p>
<p> <span>在关系服务级别没有完成任何操作，即<code>RelationSupport</code>对象未添加到<code>RelationService</code> ，并且不执行检查以查看提供的值是否正确。</span> <span>对象始终被创建，除非：</span> </p>
<p> <span>- 任何所需的参数是<code>null</code> 。</span> </p>
<p> <span> - 相同的名称用于两个角色。</span> </p>
<p> <span>要作为关系处理，必须使用关联服务方法addRelation（）将<code>RelationSupport</code>对象添加到关系服务。</span> </p>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<span><code>relationId</code> - 关系标识符，用于标识关系服务中的关系。</span>
<p> <span>预期在给定的关系服务中是唯一的。</span> </p>
</dd>
<dd>
<span><code>relationServiceName</code> - 该关系将被注册的关系服务的ObjectName。</span>
<p> <span>该参数是必需的，因为它是关系服务，它意识到给定关系的关系类型的定义，以便能够检查更新操作（设置）。</span> </p>
</dd>
<dd>
<span><code>relationTypeName</code> - 关系类型的名称。</span>
<p> <span>预计在给定的关系服务中创建。</span> </p>
</dd>
<dd>
<span><code>list</code> - 初始化关系的角色（角色对象）列表。</span>
<span>可以<code>null</code> 。</span>
<p> <span>预期符合相关关系类型的关系信息。</span> </p>
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../../javax/management/relation/InvalidRoleValueException.html" title="class in javax.management.relation">InvalidRoleValueException</a></code> - 如果两个角色使用相同的名称。 
           </dd>
<dd>
<code><a href="../../../java/lang/IllegalArgumentException.html" title="class in java.lang">IllegalArgumentException</a></code> - 如果任何必需的参数（关系id，关系服务对象名称或关系类型名称）是 
            <code>null</code> 。 
           </dd>
</dl> </li>
</ul> <a name="RelationSupport-java.lang.String-javax.management.ObjectName-javax.management.MBeanServer-java.lang.String-javax.management.relation.RoleList-">
<!-- --> </a>
<ul class="blockListLast">
<li class="blockList"> <h4>RelationSupport</h4> <pre>public RelationSupport(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> relationId,
                       <a href="../../../javax/management/ObjectName.html" title="class in javax.management">ObjectName</a> relationServiceName,
                       <a href="../../../javax/management/MBeanServer.html" title="interface in javax.management">MBeanServer</a> relationServiceMBeanServer,
                       <a href="../../../java/lang/String.html" title="class in java.lang">String</a> relationTypeName,
                       <a href="../../../javax/management/relation/RoleList.html" title="class in javax.management.relation">RoleList</a> list)
                throws <a href="../../../javax/management/relation/InvalidRoleValueException.html" title="class in javax.management.relation">InvalidRoleValueException</a>,
                       <a href="../../../java/lang/IllegalArgumentException.html" title="class in java.lang">IllegalArgumentException</a></pre>
<div class="block">
<span>创建一个<code>RelationSupport</code>对象。</span>
<p> <span>当用户关系MBean通过委托RelationSupport对象实现期望由关系支持的接口时，必须使用此构造函数。</span> </p>
<p> <span>此对象需要知道关系服务预期处理关系。</span> <span>所以它必须知道关系服务注册的MBean服务器。</span> </p>
<p> <span>根据限制，必须在与预期处理它的关系服务相同的MBean服务器中注册关系MBean。</span> <span>因此，必须创建和注册用户关系MBean，然后可以在已识别的MBean服务器内创建包装的RelationSupport对象。</span> </p>
<p> <span>在关系服务级别没有完成任何操作，即<code>RelationSupport</code>对象未添加到<code>RelationService</code> ，并且不执行检查以查看提供的值是否正确。</span> <span>对象始终被创建，除非：</span> </p>
<p> <span>- 任何必需的参数是<code>null</code> 。</span> </p>
<p> <span> - 相同的名称用于两个角色。</span> </p>
<p> <span>要作为关系处理，必须使用关系服务方法addRelation（）将<code>RelationSupport</code>对象添加到关系服务。</span> </p>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<span><code>relationId</code> - 关系标识符，用于标识关系服务中的关系。</span>
<p> <span>预期在给定的关系服务中是唯一的。</span> </p>
</dd>
<dd>
<span><code>relationServiceName</code> - 该关系将被注册的关系服务的ObjectName。</span>
<p> <span>该参数是必需的，因为它是关系服务，它意识到给定关系的关系类型的定义，以便能够检查更新操作（设置）。</span> </p>
</dd>
<dd>
<span><code>relationServiceMBeanServer</code> - MBean包装MBean是或将被注册的服务器。</span>
<p> <span>预期是关系服务是或将被注册的MBean服务器。</span> </p>
</dd>
<dd>
<span><code>relationTypeName</code> - 关系类型的名称。</span>
<p> <span>预计在给定的关系服务中创建。</span> </p>
</dd>
<dd>
<span><code>list</code> - 初始化关系的角色列表（Role Objects）。</span>
<span>可以<code>null</code> 。</span>
<p> <span>预期符合相关关系类型的关系信息。</span> </p>
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../../javax/management/relation/InvalidRoleValueException.html" title="class in javax.management.relation">InvalidRoleValueException</a></code> - 如果同一个名称用于两个角色。 
           </dd>
<dd>
<code><a href="../../../java/lang/IllegalArgumentException.html" title="class in java.lang">IllegalArgumentException</a></code> - 如果任何必需的参数（关系id，关系服务对象名称，关系服务MBeanServer或关系类型名称）是 
            <code>null</code> 。 
           </dd>
</dl> </li>
</ul> </li>
</ul>
<!-- ============ METHOD DETAIL ========== -->
<ul class="blockList">
<li class="blockList"><a name="method.detail">
<!-- --> </a> <h3>方法详细信息</h3> <a name="getRole-java.lang.String-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getRole</h4> <pre>public <a href="../../../java/util/List.html" title="interface in java.util">List</a>&lt;<a href="../../../javax/management/ObjectName.html" title="class in javax.management">ObjectName</a>&gt; getRole(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> roleName)
                         throws <a href="../../../java/lang/IllegalArgumentException.html" title="class in java.lang">IllegalArgumentException</a>,
                                <a href="../../../javax/management/relation/RoleNotFoundException.html" title="class in javax.management.relation">RoleNotFoundException</a>,
                                <a href="../../../javax/management/relation/RelationServiceNotRegisteredException.html" title="class in javax.management.relation">RelationServiceNotRegisteredException</a></pre>
<div class="block">
<span>检索给定角色名称的角色值。</span>
<p> <span>检查角色是否存在，并根据关系类型可读。</span> </p>
</div>
<dl>
<dt>
<span class="overrideSpecifyLabel">Specified by:</span>
</dt>
<dd>
<code><a href="../../../javax/management/relation/Relation.html#getRole-java.lang.String-">getRole</a></code>在接口 
            <code><a href="../../../javax/management/relation/Relation.html" title="interface in javax.management.relation">Relation</a></code>
</dd>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>roleName</code> - 角色名称 
           </dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
             ObjectName对象的ArrayList是角色值 
           </dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../../java/lang/IllegalArgumentException.html" title="class in java.lang">IllegalArgumentException</a></code> - 如果为null角色名称 
           </dd>
<dd>
<span><code><a href="../../../javax/management/relation/RoleNotFoundException.html" title="class in javax.management.relation">RoleNotFoundException</a></code> - 如果：</span>
<p> <span> - 给定名字没有任何作用</span> </p>
<p> <span> - 角色不可读。</span> </p>
</dd>
<dd>
<code><a href="../../../javax/management/relation/RelationServiceNotRegisteredException.html" title="class in javax.management.relation">RelationServiceNotRegisteredException</a></code> - 如果关系服务未在MBean服务器中注册 
           </dd>
<dt>
<span class="seeLabel">另请参见：</span>
</dt>
<dd>
<a href="../../../javax/management/relation/RelationSupport.html#setRole-javax.management.relation.Role-"><code>setRole(javax.management.relation.Role)</code></a>
</dd>
</dl> </li>
</ul> <a name="getRoles-java.lang.String:A-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getRoles</h4> <pre>public <a href="../../../javax/management/relation/RoleResult.html" title="class in javax.management.relation">RoleResult</a> getRoles(<a href="../../../java/lang/String.html" title="class in java.lang">String</a>[] roleNameArray)
                    throws <a href="../../../java/lang/IllegalArgumentException.html" title="class in java.lang">IllegalArgumentException</a>,
                           <a href="../../../javax/management/relation/RelationServiceNotRegisteredException.html" title="class in javax.management.relation">RelationServiceNotRegisteredException</a></pre>
<div class="block">
<span>检索具有给定名称的角色值。</span>
<p> <span>检查每个角色是否存在，并根据关系类型可读。</span> </p>
</div>
<dl>
<dt>
<span class="overrideSpecifyLabel">Specified by:</span>
</dt>
<dd>
<code><a href="../../../javax/management/relation/Relation.html#getRoles-java.lang.String:A-">getRoles</a></code>在接口 
            <code><a href="../../../javax/management/relation/Relation.html" title="interface in javax.management.relation">Relation</a></code>
</dd>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>roleNameArray</code> - 要检索的角色的名称数组 
           </dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
             一个RoleResult对象，包括一个RoleList（用于成功检索的角色）和一个RoleUnresolvedList（对于未检索的角色）。 
           </dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../../java/lang/IllegalArgumentException.html" title="class in java.lang">IllegalArgumentException</a></code> - 如果为null角色名称 
           </dd>
<dd>
<code><a href="../../../javax/management/relation/RelationServiceNotRegisteredException.html" title="class in javax.management.relation">RelationServiceNotRegisteredException</a></code> - 如果关系服务未在MBean服务器中注册 
           </dd>
<dt>
<span class="seeLabel">另请参见：</span>
</dt>
<dd>
<a href="../../../javax/management/relation/RelationSupport.html#setRoles-javax.management.relation.RoleList-"><code>setRoles(javax.management.relation.RoleList)</code></a>
</dd>
</dl> </li>
</ul> <a name="getAllRoles--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getAllRoles</h4> <pre>public <a href="../../../javax/management/relation/RoleResult.html" title="class in javax.management.relation">RoleResult</a> getAllRoles()
                       throws <a href="../../../javax/management/relation/RelationServiceNotRegisteredException.html" title="class in javax.management.relation">RelationServiceNotRegisteredException</a></pre>
<div class="block">
            返回关系中存在的所有角色。 
          </div>
<dl>
<dt>
<span class="overrideSpecifyLabel">Specified by:</span>
</dt>
<dd>
<code><a href="../../../javax/management/relation/Relation.html#getAllRoles--">getAllRoles</a></code>在接口 
            <code><a href="../../../javax/management/relation/Relation.html" title="interface in javax.management.relation">Relation</a></code>
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
             一个RoleResult对象，包括一个RoleList（用于成功检索的角色）和一个RoleUnresolvedList（对于角色不可读）。 
           </dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../../javax/management/relation/RelationServiceNotRegisteredException.html" title="class in javax.management.relation">RelationServiceNotRegisteredException</a></code> - 如果关系服务未在MBean服务器中注册 
           </dd>
</dl> </li>
</ul> <a name="retrieveAllRoles--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>retrieveAllRoles</h4> <pre>public <a href="../../../javax/management/relation/RoleList.html" title="class in javax.management.relation">RoleList</a> retrieveAllRoles()</pre>
<div class="block">
            返回关系中的所有角色，而不检查读取模式。 
          </div>
<dl>
<dt>
<span class="overrideSpecifyLabel">Specified by:</span>
</dt>
<dd>
<code><a href="../../../javax/management/relation/Relation.html#retrieveAllRoles--">retrieveAllRoles</a></code>在接口 
            <code><a href="../../../javax/management/relation/Relation.html" title="interface in javax.management.relation">Relation</a></code>
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
             一个RoleList 
           </dd>
</dl> </li>
</ul> <a name="getRoleCardinality-java.lang.String-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getRoleCardinality</h4> <pre>public <a href="../../../java/lang/Integer.html" title="class in java.lang">Integer</a> getRoleCardinality(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> roleName)
                           throws <a href="../../../java/lang/IllegalArgumentException.html" title="class in java.lang">IllegalArgumentException</a>,
                                  <a href="../../../javax/management/relation/RoleNotFoundException.html" title="class in javax.management.relation">RoleNotFoundException</a></pre>
<div class="block">
            返回当前在给定角色中引用的MBean数。 
          </div>
<dl>
<dt>
<span class="overrideSpecifyLabel">Specified by:</span>
</dt>
<dd>
<code><a href="../../../javax/management/relation/Relation.html#getRoleCardinality-java.lang.String-">getRoleCardinality</a></code>在界面 
            <code><a href="../../../javax/management/relation/Relation.html" title="interface in javax.management.relation">Relation</a></code>
</dd>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>roleName</code> - 角色名称 
           </dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
             该角色中当前引用的MBean的数量 
           </dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../../java/lang/IllegalArgumentException.html" title="class in java.lang">IllegalArgumentException</a></code> - 如果为null角色名称 
           </dd>
<dd>
<code><a href="../../../javax/management/relation/RoleNotFoundException.html" title="class in javax.management.relation">RoleNotFoundException</a></code> - 如果没有给定名称的角色 
           </dd>
</dl> </li>
</ul> <a name="setRole-javax.management.relation.Role-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>setRole</h4> <pre>public void setRole(<a href="../../../javax/management/relation/Role.html" title="class in javax.management.relation">Role</a> role)
             throws <a href="../../../java/lang/IllegalArgumentException.html" title="class in java.lang">IllegalArgumentException</a>,
                    <a href="../../../javax/management/relation/RoleNotFoundException.html" title="class in javax.management.relation">RoleNotFoundException</a>,
                    <a href="../../../javax/management/relation/RelationTypeNotFoundException.html" title="class in javax.management.relation">RelationTypeNotFoundException</a>,
                    <a href="../../../javax/management/relation/InvalidRoleValueException.html" title="class in javax.management.relation">InvalidRoleValueException</a>,
                    <a href="../../../javax/management/relation/RelationServiceNotRegisteredException.html" title="class in javax.management.relation">RelationServiceNotRegisteredException</a>,
                    <a href="../../../javax/management/relation/RelationNotFoundException.html" title="class in javax.management.relation">RelationNotFoundException</a></pre>
<div class="block">
<span>设置给定的角色。</span>
<p> <span>将根据其在关系类型中提供的相应角色定义来检查角色</span> </p>
<p> <span>将发送通知（RelationNotification类型为RELATION_BASIC_UPDATE或RELATION_MBEAN_UPDATE，具体取决于关系是否为MBean）。</span> </p>
</div>
<dl>
<dt>
<span class="overrideSpecifyLabel">Specified by:</span>
</dt>
<dd>
<code><a href="../../../javax/management/relation/Relation.html#setRole-javax.management.relation.Role-">setRole</a></code>在界面 
            <code><a href="../../../javax/management/relation/Relation.html" title="interface in javax.management.relation">Relation</a></code>
</dd>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>role</code> - 要设置的角色（名称和新值） 
           </dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../../java/lang/IllegalArgumentException.html" title="class in java.lang">IllegalArgumentException</a></code> - 如果为null角色 
           </dd>
<dd>
<code><a href="../../../javax/management/relation/RoleNotFoundException.html" title="class in javax.management.relation">RoleNotFoundException</a></code> - 如果所提供角色的名称没有角色或角色不可写（在初始化角色时执行的写入访问模式没有测试） 
           </dd>
<dd>
<span><code><a href="../../../javax/management/relation/InvalidRoleValueException.html" title="class in javax.management.relation">InvalidRoleValueException</a></code> - 如果为角色提供的值无效，即：</span>
<p> <span> - 给定值中引用的MBean的数量小于预期的最小度</span> </p>
<p> <span> - 提供的值中引用的MBean的数量超过预期的最大度</span> </p>
<p> <span> - 值中的一个引用的MBean不是该角色的MBean类的对象</span> </p>
<p> <span> - 为该角色提供的MBean不存在</span> </p>
</dd>
<dd>
<code><a href="../../../javax/management/relation/RelationServiceNotRegisteredException.html" title="class in javax.management.relation">RelationServiceNotRegisteredException</a></code> - 如果关系服务未在MBean服务器中注册 
           </dd>
<dd>
<code><a href="../../../javax/management/relation/RelationTypeNotFoundException.html" title="class in javax.management.relation">RelationTypeNotFoundException</a></code> - 如果关系类型尚未在关系服务中声明 
           </dd>
<dd>
<code><a href="../../../javax/management/relation/RelationNotFoundException.html" title="class in javax.management.relation">RelationNotFoundException</a></code> - 如果关系尚未添加到关系服务中。 
           </dd>
<dt>
<span class="seeLabel">另请参见：</span>
</dt>
<dd>
<a href="../../../javax/management/relation/RelationSupport.html#getRole-java.lang.String-"><code>getRole(java.lang.String)</code></a>
</dd>
</dl> </li>
</ul> <a name="setRoles-javax.management.relation.RoleList-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>setRoles</h4> <pre>public <a href="../../../javax/management/relation/RoleResult.html" title="class in javax.management.relation">RoleResult</a> setRoles(<a href="../../../javax/management/relation/RoleList.html" title="class in javax.management.relation">RoleList</a> list)
                    throws <a href="../../../java/lang/IllegalArgumentException.html" title="class in java.lang">IllegalArgumentException</a>,
                           <a href="../../../javax/management/relation/RelationServiceNotRegisteredException.html" title="class in javax.management.relation">RelationServiceNotRegisteredException</a>,
                           <a href="../../../javax/management/relation/RelationTypeNotFoundException.html" title="class in javax.management.relation">RelationTypeNotFoundException</a>,
                           <a href="../../../javax/management/relation/RelationNotFoundException.html" title="class in javax.management.relation">RelationNotFoundException</a></pre>
<div class="block">
<span>设置给定的角色。</span>
<p> <span>将根据其在关系类型中提供的相应角色定义来检查角色</span> </p>
<p> <span>将发送一个通知（RelationNotification类型为RELATION_BASIC_UPDATE或RELATION_MBEAN_UPDATE，取决于关系是否为MBean）每个更新的角色。</span> </p>
</div>
<dl>
<dt>
<span class="overrideSpecifyLabel">Specified by:</span>
</dt>
<dd>
<code><a href="../../../javax/management/relation/Relation.html#setRoles-javax.management.relation.RoleList-">setRoles</a></code>在接口 
            <code><a href="../../../javax/management/relation/Relation.html" title="interface in javax.management.relation">Relation</a></code>
</dd>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>list</code> - 要设置的角色列表 
           </dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
             一个RoleResult对象，包括一个RoleList（用于角色成功设置）和一个RoleUnresolvedList（对于未设置的角色）。 
           </dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../../java/lang/IllegalArgumentException.html" title="class in java.lang">IllegalArgumentException</a></code> - 如果为空角色列表 
           </dd>
<dd>
<code><a href="../../../javax/management/relation/RelationServiceNotRegisteredException.html" title="class in javax.management.relation">RelationServiceNotRegisteredException</a></code> - 如果关系服务未在MBean服务器中注册 
           </dd>
<dd>
<code><a href="../../../javax/management/relation/RelationTypeNotFoundException.html" title="class in javax.management.relation">RelationTypeNotFoundException</a></code> - 如果关系类型尚未在关系服务中声明。 
           </dd>
<dd>
<code><a href="../../../javax/management/relation/RelationNotFoundException.html" title="class in javax.management.relation">RelationNotFoundException</a></code> - 如果关系MBean尚未添加在关系服务中。 
           </dd>
<dt>
<span class="seeLabel">另请参见：</span>
</dt>
<dd>
<a href="../../../javax/management/relation/RelationSupport.html#getRoles-java.lang.String:A-"><code>getRoles(java.lang.String[])</code></a>
</dd>
</dl> </li>
</ul> <a name="handleMBeanUnregistration-javax.management.ObjectName-java.lang.String-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>handleMBeanUnregistration</h4> <pre>public void handleMBeanUnregistration(<a href="../../../javax/management/ObjectName.html" title="class in javax.management">ObjectName</a> objectName,
                                      <a href="../../../java/lang/String.html" title="class in java.lang">String</a> roleName)
                               throws <a href="../../../java/lang/IllegalArgumentException.html" title="class in java.lang">IllegalArgumentException</a>,
                                      <a href="../../../javax/management/relation/RoleNotFoundException.html" title="class in javax.management.relation">RoleNotFoundException</a>,
                                      <a href="../../../javax/management/relation/InvalidRoleValueException.html" title="class in javax.management.relation">InvalidRoleValueException</a>,
                                      <a href="../../../javax/management/relation/RelationServiceNotRegisteredException.html" title="class in javax.management.relation">RelationServiceNotRegisteredException</a>,
                                      <a href="../../../javax/management/relation/RelationTypeNotFoundException.html" title="class in javax.management.relation">RelationTypeNotFoundException</a>,
                                      <a href="../../../javax/management/relation/RelationNotFoundException.html" title="class in javax.management.relation">RelationNotFoundException</a></pre>
<div class="block">
<span>当角色引用的MBean未注册时，关系服务使用的回调。</span>
<p> <span>关系服务将称之为这种方法，让关系采取行动来反映这种注册的影响。</span> </p>
<p> <span>谨防。</span> <span>用户不期望调用此方法。</span> </p>
<p> <span>当前实现是使用其当前值（引用的MBean的ObjectNames列表）设置角色，而不注册未注册的值。</span> </p>
</div>
<dl>
<dt>
<span class="overrideSpecifyLabel">Specified by:</span>
</dt>
<dd>
<code><a href="../../../javax/management/relation/Relation.html#handleMBeanUnregistration-javax.management.ObjectName-java.lang.String-">handleMBeanUnregistration</a></code>在接口 
            <code><a href="../../../javax/management/relation/Relation.html" title="interface in javax.management.relation">Relation</a></code>
</dd>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>objectName</code> - 未注册的MBean的ObjectName 
           </dd>
<dd>
<code>roleName</code> - 
            <code>roleName</code> MBean的角色名称 
           </dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../../java/lang/IllegalArgumentException.html" title="class in java.lang">IllegalArgumentException</a></code> - 如果为空参数 
           </dd>
<dd>
<code><a href="../../../javax/management/relation/RoleNotFoundException.html" title="class in javax.management.relation">RoleNotFoundException</a></code> - 如果角色不存在于关系或不可写 
           </dd>
<dd>
<code><a href="../../../javax/management/relation/InvalidRoleValueException.html" title="class in javax.management.relation">InvalidRoleValueException</a></code> - 如果角色值不符合关联的角色信息（当从关系服务调用时，这将永远不会发生） 
           </dd>
<dd>
<code><a href="../../../javax/management/relation/RelationServiceNotRegisteredException.html" title="class in javax.management.relation">RelationServiceNotRegisteredException</a></code> - 如果关系服务未在MBean服务器中注册 
           </dd>
<dd>
<code><a href="../../../javax/management/relation/RelationTypeNotFoundException.html" title="class in javax.management.relation">RelationTypeNotFoundException</a></code> - 如果关系类型尚未在关系服务中声明。 
           </dd>
<dd>
<code><a href="../../../javax/management/relation/RelationNotFoundException.html" title="class in javax.management.relation">RelationNotFoundException</a></code> - 如果为在关系服务中未添加的关系MBean调用此方法。 
           </dd>
</dl> </li>
</ul> <a name="getReferencedMBeans--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getReferencedMBeans</h4> <pre>public <a href="../../../java/util/Map.html" title="interface in java.util">Map</a>&lt;<a href="../../../javax/management/ObjectName.html" title="class in javax.management">ObjectName</a>,<a href="../../../java/util/List.html" title="interface in java.util">List</a>&lt;<a href="../../../java/lang/String.html" title="class in java.lang">String</a>&gt;&gt; getReferencedMBeans()</pre>
<div class="block">
            检索在关系的各种角色中引用的MBean。 
          </div>
<dl>
<dt>
<span class="overrideSpecifyLabel">Specified by:</span>
</dt>
<dd>
<code><a href="../../../javax/management/relation/Relation.html#getReferencedMBeans--">getReferencedMBeans</a></code>在接口 
            <code><a href="../../../javax/management/relation/Relation.html" title="interface in javax.management.relation">Relation</a></code>
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
<span>一个HashMap映射：</span>
<p> <span>ObjectName - &gt; ArrayList的String（角色名称）</span> </p>
</dd>
</dl> </li>
</ul> <a name="getRelationTypeName--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getRelationTypeName</h4> <pre>public <a href="../../../java/lang/String.html" title="class in java.lang">String</a> getRelationTypeName()</pre>
<div class="block">
            返回关联关系类型的名称。 
          </div>
<dl>
<dt>
<span class="overrideSpecifyLabel">Specified by:</span>
</dt>
<dd>
<code><a href="../../../javax/management/relation/Relation.html#getRelationTypeName--">getRelationTypeName</a></code>在接口 
            <code><a href="../../../javax/management/relation/Relation.html" title="interface in javax.management.relation">Relation</a></code>
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
             关系类型的名称。 
           </dd>
</dl> </li>
</ul> <a name="getRelationServiceName--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getRelationServiceName</h4> <pre>public <a href="../../../javax/management/ObjectName.html" title="class in javax.management">ObjectName</a> getRelationServiceName()</pre>
<div class="block">
            返回处理关系的关系服务的ObjectName。 
          </div>
<dl>
<dt>
<span class="overrideSpecifyLabel">Specified by:</span>
</dt>
<dd>
<code><a href="../../../javax/management/relation/Relation.html#getRelationServiceName--">getRelationServiceName</a></code>在界面 
            <code><a href="../../../javax/management/relation/Relation.html" title="interface in javax.management.relation">Relation</a></code>
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
             关系服务的ObjectName。 
           </dd>
</dl> </li>
</ul> <a name="getRelationId--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getRelationId</h4> <pre>public <a href="../../../java/lang/String.html" title="class in java.lang">String</a> getRelationId()</pre>
<div class="block">
            返回关系标识符（用于唯一标识关系服务中的关系）。 
          </div>
<dl>
<dt>
<span class="overrideSpecifyLabel">Specified by:</span>
</dt>
<dd>
<code><a href="../../../javax/management/relation/Relation.html#getRelationId--">getRelationId</a></code>在界面 
            <code><a href="../../../javax/management/relation/Relation.html" title="interface in javax.management.relation">Relation</a></code>
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
             关系id。 
           </dd>
</dl> </li>
</ul> <a name="preRegister-javax.management.MBeanServer-javax.management.ObjectName-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>preRegister</h4> <pre>public <a href="../../../javax/management/ObjectName.html" title="class in javax.management">ObjectName</a> preRegister(<a href="../../../javax/management/MBeanServer.html" title="interface in javax.management">MBeanServer</a> server,
                              <a href="../../../javax/management/ObjectName.html" title="class in javax.management">ObjectName</a> name)
                       throws <a href="../../../java/lang/Exception.html" title="class in java.lang">异常</a></pre>
<div class="block">
<span class="descfrmTypeLabel">说明从界面复制： <code><a href="../../../javax/management/MBeanRegistration.html#preRegister-javax.management.MBeanServer-javax.management.ObjectName-">MBeanRegistration</a></code></span>
</div>
<div class="block">
<span>允许MBean在MBean服务器注册之前执行所需的任何操作。</span>
<span>如果未指定MBean的名称，则MBean可以为其注册提供一个名称。</span>
<span>如果引发任何异常，MBean将不会在MBean服务器中注册。</span>
</div>
<dl>
<dt>
<span class="overrideSpecifyLabel">Specified by:</span>
</dt>
<dd>
<code><a href="../../../javax/management/MBeanRegistration.html#preRegister-javax.management.MBeanServer-javax.management.ObjectName-">preRegister</a></code>在界面 
            <code><a href="../../../javax/management/MBeanRegistration.html" title="interface in javax.management">MBeanRegistration</a></code>
</dd>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>server</code> - MBean将被注册的MBean服务器。 
           </dd>
<dd>
<span><code>name</code> - MBean的对象名称。</span>
<span>此名称为null如果名称参数的一个<code>createMBean</code>或<code>registerMBean</code>方法在<a href="../../../javax/management/MBeanServer.html" title="javax.management中的接口"><code>MBeanServer</code></a>接口为空。</span>
<span>在这种情况下，此方法必须为新的MBean返回非空的ObjectName。</span>
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
<span>要注册MBean的名称。</span>
<span>此值不能为空。</span>
<span>如果<code>name</code>参数不为空，通常不一定是返回值。</span>
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<span><code><a href="../../../java/lang/Exception.html" title="class in java.lang">异常</a></code> - 这个异常将被MBean服务器捕获，并重新抛出为<a href="../../../javax/management/MBeanRegistrationException.html" title="javax.management中的类"><code>MBeanRegistrationException</code></a> 。</span>
</dd>
</dl> </li>
</ul> <a name="postRegister-java.lang.Boolean-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>postRegister</h4> <pre>public void postRegister(<a href="../../../java/lang/Boolean.html" title="class in java.lang">Boolean</a> registrationDone)</pre>
<div class="block">
<span class="descfrmTypeLabel">从接口复制： <code><a href="../../../javax/management/MBeanRegistration.html#postRegister-java.lang.Boolean-">MBeanRegistration</a></code></span>
</div>
<div class="block">
<span>允许MBean在MBean服务器中注册或注册失败后执行所需的操作。</span>
<p> <span>如果此方法的实现抛出一个<a href="../../../java/lang/RuntimeException.html" title="java.lang中的类"><code>RuntimeException</code></a>或<a href="../../../java/lang/Error.html" title="java.lang中的类"><code>Error</code></a> ，则MBean服务器的重新抛出那些内部<a href="../../../javax/management/RuntimeMBeanException.html" title="javax.management中的类"><code>RuntimeMBeanException</code></a>或<a href="../../../javax/management/RuntimeErrorException.html" title="javax.management中的类"><code>RuntimeErrorException</code></a>分别。</span> <span>但是，在postRegister中<code>postRegister</code>将不会更改MBean的状态：如果MBean已经注册（ <code>registrationDone</code>是<code>true</code> ），那么MBean将保持注册。</span> </p>
<p> <span>这可能会导致调用<code>createMBean()</code>或<code>registerMBean()</code>的代码<code>createMBean()</code> <code>registerMBean()</code> ，因为这样的代码可能会假设在引发异常时MBean注册失败。</span> <span>因此，建议的实现<code>postRegister</code>不抛出运行时异常或错误，如果能够避免它。</span> </p>
</div>
<dl>
<dt>
<span class="overrideSpecifyLabel">Specified by:</span>
</dt>
<dd>
<code><a href="../../../javax/management/MBeanRegistration.html#postRegister-java.lang.Boolean-">postRegister</a></code>在接口 
            <code><a href="../../../javax/management/MBeanRegistration.html" title="interface in javax.management">MBeanRegistration</a></code>
</dd>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<span><code>registrationDone</code> - 指示MBean是否已在MBean服务器中成功注册。</span>
<span>值false表示注册阶段失败。</span>
</dd>
</dl> </li>
</ul> <a name="preDeregister--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>preDeregister</h4> <pre>public void preDeregister()
                   throws <a href="../../../java/lang/Exception.html" title="class in java.lang">异常</a></pre>
<div class="block">
<span class="descfrmTypeLabel">说明从界面： <code><a href="../../../javax/management/MBeanRegistration.html#preDeregister--">MBeanRegistration</a></code>复制</span>
</div>
<div class="block">
            允许MBean在MBean服务器取消注册之前执行所需的任何操作。 
          </div>
<dl>
<dt>
<span class="overrideSpecifyLabel">Specified by:</span>
</dt>
<dd>
<code><a href="../../../javax/management/MBeanRegistration.html#preDeregister--">preDeregister</a></code>中的 
            <code><a href="../../../javax/management/MBeanRegistration.html" title="interface in javax.management">MBeanRegistration</a></code>
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<span><code><a href="../../../java/lang/Exception.html" title="class in java.lang">异常</a></code> - 此异常将被MBean服务器捕获，并重新抛出为<a href="../../../javax/management/MBeanRegistrationException.html" title="javax.management中的类"><code>MBeanRegistrationException</code></a> 。</span>
</dd>
</dl> </li>
</ul> <a name="postDeregister--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>postDeregister</h4> <pre>public void postDeregister()</pre>
<div class="block">
<span class="descfrmTypeLabel">说明从界面： <code><a href="../../../javax/management/MBeanRegistration.html#postDeregister--">MBeanRegistration</a></code>复制</span>
</div>
<div class="block">
<span>允许MBean在MBean服务器中取消注册后执行所需的任何操作。</span>
<p> <span>如果这种方法的实现会引发一个<a href="../../../java/lang/RuntimeException.html" title="java.lang中的类"><code>RuntimeException</code></a>或<a href="../../../java/lang/Error.html" title="java.lang中的类"><code>Error</code></a> ，那么MBean服务器将<a href="../../../javax/management/RuntimeMBeanException.html" title="javax.management中的类">分别推出<code>RuntimeMBeanException</code></a>或<a href="../../../javax/management/RuntimeErrorException.html" title="javax.management中的类"><code>RuntimeErrorException</code></a>内的那些。</span> <span>然而，在postDeregister中<code>postDeregister</code>将不会改变MBean的状态：MBean已经成功注销，并将保持不变。</span> </p>
<p> <span>这可能会使代码调用<code>unregisterMBean()</code> ，因为它可能会假设MBean注销失败。</span> <span>因此，建议的实现<code>postDeregister</code>不抛出运行时异常或错误，如果能够避免它。</span> </p>
</div>
<dl>
<dt>
<span class="overrideSpecifyLabel">Specified by:</span>
</dt>
<dd>
<code><a href="../../../javax/management/MBeanRegistration.html#postDeregister--">postDeregister</a></code>在接口 
            <code><a href="../../../javax/management/MBeanRegistration.html" title="interface in javax.management">MBeanRegistration</a></code>
</dd>
</dl> </li>
</ul> <a name="isInRelationService--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>isInRelationService</h4> <pre>public <a href="../../../java/lang/Boolean.html" title="class in java.lang">Boolean</a> isInRelationService()</pre>
<div class="block">
            返回一个内部标志，指定对象是否仍由关系服务处理。 
          </div>
<dl>
<dt>
<span class="overrideSpecifyLabel">Specified by:</span>
</dt>
<dd>
<code><a href="../../../javax/management/relation/RelationSupportMBean.html#isInRelationService--">isInRelationService</a></code>在接口 
            <code><a href="../../../javax/management/relation/RelationSupportMBean.html" title="interface in javax.management.relation">RelationSupportMBean</a></code>
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
             一个布尔值等于 
            <a href="../../../java/lang/Boolean.html#TRUE"><code>Boolean.TRUE</code>，</a>如果对象仍然由关系服务处理， 
            <a href="../../../java/lang/Boolean.html#FALSE">否则为</a>
<code>Boolean.FALSE</code>。 
           </dd>
</dl> </li>
</ul> <a name="setRelationServiceManagementFlag-java.lang.Boolean-">
<!-- --> </a>
<ul class="blockListLast">
<li class="blockList"> <h4>setRelationServiceManagementFlag</h4> <pre>public void setRelationServiceManagementFlag(<a href="../../../java/lang/Boolean.html" title="class in java.lang">Boolean</a> flag)
                                      throws <a href="../../../java/lang/IllegalArgumentException.html" title="class in java.lang">IllegalArgumentException</a></pre>
<div class="block">
<span class="descfrmTypeLabel">说明从界面复制： <code><a href="../../../javax/management/relation/RelationSupportMBean.html#setRelationServiceManagementFlag-java.lang.Boolean-">RelationSupportMBean</a></code></span>
</div>
<div class="block">
<p> <span>指定该关系是否由关系服务处理。</span> </p>
<p> <span>BEWARE，该方法必须被公开，因为关系服务将通过其管理界面访问该关系。</span> <span>建议不要使用这种方法。</span> <span>使用它不影响关系对象在关系服务中的注册，但会提供错误的信息！</span> </p>
</div>
<dl>
<dt>
<span class="overrideSpecifyLabel">Specified by:</span>
</dt>
<dd>
<code><a href="../../../javax/management/relation/RelationSupportMBean.html#setRelationServiceManagementFlag-java.lang.Boolean-">setRelationServiceManagementFlag</a></code>在界面 
            <code><a href="../../../javax/management/relation/RelationSupportMBean.html" title="interface in javax.management.relation">RelationSupportMBean</a></code>
</dd>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>flag</code> - 关系是否由关系服务处理。 
           </dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../../java/lang/IllegalArgumentException.html" title="class in java.lang">IllegalArgumentException</a></code> - if null parameter 
           </dd>
</dl> </li>
</ul> </li>
</ul> </li>
</ul>
</div>
</div>