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

<div class="header">
<div class="subTitle">
     compact3 
   </div>
<div class="subTitle">
     javax.management.relation 
   </div>
<h2 class="title" title="Interface Relation">Interface Relation</h2>
</div><div class="contentContainer">
<div class="description">
<ul class="blockList">
<li class="blockList">
<dl>
<dt>
         All Known Subinterfaces: 
       </dt>
<dd>
<span><a href="../../../javax/management/relation/RelationSupportMBean.html" title="javax.management.relation中的接口">RelationSupportMBean</a></span>
</dd>
</dl>
<dl>
<dt>
        所有已知实现类：
       </dt>
<dd>
<span><a href="../../../javax/management/relation/RelationSupport.html" title="javax.management.relation中的类">RelationSupport</a></span>
</dd>
</dl>
<hr/> <br/> <pre>public interface <span class="typeNameLabel">Relation</span></pre>
<div class="block">
<span>这个接口必须由任何MBean类来实现，该类可以表示使用关系服务管理的关系。</span>
<p> <span>可以直接由Relation Service（表示为RelationSupport对象，由Relation Service内部处理）创建简单的关系，即只有角色，无属性或方法。</span> </p>
<p> <span>如果用户想要表示更复杂的关系，涉及属性和/或方法，他必须提供他自己的实现Relation接口的类。</span> <span>这可以通过从RelationSupport类继承，或通过实现接口（完全或委派给RelationSupport对象成员）来实现。</span> </p>
<p> <span>指定这样的用户关系类是引入属性和/或方法。</span> <span>那些必须暴露于远程管理。</span> <span>所以这意味着任何用户关系类必须是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">
<!-- ========== 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><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/Relation.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/Relation.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/Relation.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/Relation.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/Relation.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/Relation.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/Relation.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/Relation.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/Relation.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="../../../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/Relation.html#retrieveAllRoles--">retrieveAllRoles</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/Relation.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="i11">
<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/Relation.html#setRoles-javax.management.relation.RoleList-">setRoles</a></span>(<a href="../../../javax/management/relation/RoleList.html" title="class in javax.management.relation">RoleList</a> roleList)</code>
<div class="block">
              设置给定的角色。 
            </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="getRole-java.lang.String-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getRole</h4> <pre><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="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> - if：</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/Relation.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><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="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/Relation.html#setRoles-javax.management.relation.RoleList-"><code>setRoles(javax.management.relation.RoleList)</code></a>
</dd>
</dl> </li>
</ul> <a name="getRoleCardinality-java.lang.String-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getRoleCardinality</h4> <pre><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="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="getAllRoles--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getAllRoles</h4> <pre><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="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><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="returnLabel">结果</span>
</dt>
<dd>
             一个RoleList。 
           </dd>
</dl> </li>
</ul> <a name="setRole-javax.management.relation.Role-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>setRole</h4> <pre>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="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/Relation.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><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> roleList)
             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="paramLabel">参数</span>
</dt>
<dd>
<code>roleList</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>
<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/Relation.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>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="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><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="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><a href="../../../java/lang/String.html" title="class in java.lang">String</a> getRelationTypeName()</pre>
<div class="block">
            返回关联关系类型的名称。 
          </div>
<dl>
<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><a href="../../../javax/management/ObjectName.html" title="class in javax.management">ObjectName</a> getRelationServiceName()</pre>
<div class="block">
            返回处理关系的关系服务的ObjectName。 
          </div>
<dl>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
             关系服务的ObjectName。 
           </dd>
</dl> </li>
</ul> <a name="getRelationId--">
<!-- --> </a>
<ul class="blockListLast">
<li class="blockList"> <h4>getRelationId</h4> <pre><a href="../../../java/lang/String.html" title="class in java.lang">String</a> getRelationId()</pre>
<div class="block">
            返回关系标识符（用于唯一标识关系服务中的关系）。 
          </div>
<dl>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
             the relation id. 
           </dd>
</dl> </li>
</ul> </li>
</ul> </li>
</ul>
</div>
</div>