2058 lines
125 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">
compact3
</div>
<div class="subTitle">
javax.management.relation
</div>
<h2 class="title" title="Class RelationService">Class RelationService</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><a href="../../../javax/management/NotificationBroadcasterSupport.html" title="class in javax.management">javax.management.NotificationBroadcasterSupport</a></li>
<li>
<ul class="inheritance">
<li>javax.management.relation.RelationService</li>
</ul> </li>
</ul> </li>
</ul>
<div class="description">
<ul class="blockList">
<li class="blockList">
<dl>
<dt>
All Implemented Interfaces:
</dt>
<dd>
<span><a href="../../../java/util/EventListener.html" title="java.util中的接口">EventListener</a> <a href="../../../javax/management/MBeanRegistration.html" title="javax.management中的接口">MBeanRegistration</a> <a href="../../../javax/management/NotificationBroadcaster.html" title="javax.management中的接口">NotificationBroadcaster</a> <a href="../../../javax/management/NotificationEmitter.html" title="javax.management中的接口">NotificationEmitter</a> <a href="../../../javax/management/NotificationListener.html" title="javax.management中的接口">NotificationListener</a> <a href="../../../javax/management/relation/RelationServiceMBean.html" title="javax.management.relation中的接口">RelationServiceMBean</a></span>
</dd>
</dl>
<hr/> <br/> <pre>public class <span class="typeNameLabel">RelationService</span>
extends <a href="../../../javax/management/NotificationBroadcasterSupport.html" title="class in javax.management">NotificationBroadcasterSupport</a>
implements <a href="../../../javax/management/relation/RelationServiceMBean.html" title="interface in javax.management.relation">RelationServiceMBean</a>, <a href="../../../javax/management/MBeanRegistration.html" title="interface in javax.management">MBeanRegistration</a>, <a href="../../../javax/management/NotificationListener.html" title="interface in javax.management">NotificationListener</a></pre>
<div class="block">
<span>关系服务负责创建和删除关系类型和关系,处理一致性和提供查询机制。</span>
<p> <span>它通过扩展NotificationBroadcasterSupport来实现NotificationBroadcaster以便在从中删除关系时发送通知。</span> </p>
<p> <span>它实现NotificationListener接口以能够接收关于在关系角色和关系MBeans中引用的MBean的注销的通知。</span> </p>
<p> <span>它实现MBeanRegistration界面以便能够检索其ObjectName和MBean Server。</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/RelationService.html#RelationService-boolean-">RelationService</a></span>(boolean immediatePurgeFlag)</code>
<div class="block">
构造函数
</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>void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/management/relation/RelationService.html#addRelation-javax.management.ObjectName-">addRelation</a></span>(<a href="../../../javax/management/ObjectName.html" title="class in javax.management">ObjectName</a> relationObjectName)</code>
<div class="block">
将由用户创建的一个MBean并由他注册在MBean服务器中添加为关系服务中的关系。
</div> </td>
</tr>
<tr class="rowColor" id="i1">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/management/relation/RelationService.html#addRelationType-javax.management.relation.RelationType-">addRelationType</a></span>(<a href="../../../javax/management/relation/RelationType.html" title="interface in javax.management.relation">RelationType</a> relationTypeObj)</code>
<div class="block">
将给定对象添加为关系类型。
</div> </td>
</tr>
<tr class="altColor" id="i2">
<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/RelationService.html#checkRoleReading-java.lang.String-java.lang.String-">checkRoleReading</a></span>(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> roleName, <a href="../../../java/lang/String.html" title="class in java.lang">String</a> relationTypeName)</code>
<div class="block">
检查给定角色是否可以以给定类型的关系读取。
</div> </td>
</tr>
<tr class="rowColor" id="i3">
<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/RelationService.html#checkRoleWriting-javax.management.relation.Role-java.lang.String-java.lang.Boolean-">checkRoleWriting</a></span>(<a href="../../../javax/management/relation/Role.html" title="class in javax.management.relation">Role</a> role, <a href="../../../java/lang/String.html" title="class in java.lang">String</a> relationTypeName, <a href="../../../java/lang/Boolean.html" title="class in java.lang">Boolean</a> initFlag)</code>
<div class="block">
检查给定的角色是否可以按给定类型的关系进行设置。
</div> </td>
</tr>
<tr class="altColor" id="i4">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/management/relation/RelationService.html#createRelation-java.lang.String-java.lang.String-javax.management.relation.RoleList-">createRelation</a></span>(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> relationId, <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> roleList)</code>
<div class="block">
创建给定关系类型的简单关系由RelationSupport对象表示并将其添加到关系服务中。
</div> </td>
</tr>
<tr class="rowColor" id="i5">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/management/relation/RelationService.html#createRelationType-java.lang.String-javax.management.relation.RoleInfo:A-">createRelationType</a></span>(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> relationTypeName, <a href="../../../javax/management/relation/RoleInfo.html" title="class in javax.management.relation">RoleInfo</a>[] roleInfoArray)</code>
<div class="block">
使用给定的角色信息由RoleInfo对象提供创建关系类型RelationTypeSupport对象并将其添加到关系服务中。
</div> </td>
</tr>
<tr class="altColor" id="i6">
<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/RelationService.html#findAssociatedMBeans-javax.management.ObjectName-java.lang.String-java.lang.String-">findAssociatedMBeans</a></span>(<a href="../../../javax/management/ObjectName.html" title="class in javax.management">ObjectName</a> mbeanName, <a href="../../../java/lang/String.html" title="class in java.lang">String</a> relationTypeName, <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="../../../java/util/Map.html" title="interface in java.util">Map</a>&lt;<a href="../../../java/lang/String.html" title="class in java.lang">String</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/RelationService.html#findReferencingRelations-javax.management.ObjectName-java.lang.String-java.lang.String-">findReferencingRelations</a></span>(<a href="../../../javax/management/ObjectName.html" title="class in javax.management">ObjectName</a> mbeanName, <a href="../../../java/lang/String.html" title="class in java.lang">String</a> relationTypeName, <a href="../../../java/lang/String.html" title="class in java.lang">String</a> roleName)</code>
<div class="block">
检索给定MBean引用的关系。
</div> </td>
</tr>
<tr class="altColor" id="i8">
<td class="colFirst"><code><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;</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/management/relation/RelationService.html#findRelationsOfType-java.lang.String-">findRelationsOfType</a></span>(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> relationTypeName)</code>
<div class="block">
返回给定类型的关系的关系id。
</div> </td>
</tr>
<tr class="rowColor" id="i9">
<td class="colFirst"><code><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;</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/management/relation/RelationService.html#getAllRelationIds--">getAllRelationIds</a></span>()</code>
<div class="block">
返回由关系服务处理的所有关系的所有关系ID。
</div> </td>
</tr>
<tr class="altColor" id="i10">
<td class="colFirst"><code><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;</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/management/relation/RelationService.html#getAllRelationTypeNames--">getAllRelationTypeNames</a></span>()</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/RelationService.html#getAllRoles-java.lang.String-">getAllRoles</a></span>(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> relationId)</code>
<div class="block">
返回关系中存在的所有角色。
</div> </td>
</tr>
<tr class="altColor" id="i12">
<td class="colFirst"><code><a href="../../../javax/management/MBeanNotificationInfo.html" title="class in javax.management">MBeanNotificationInfo</a>[]</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/management/relation/RelationService.html#getNotificationInfo--">getNotificationInfo</a></span>()</code>
<div class="block">
返回一个NotificationInfo对象该对象包含通知的Java类的名称以及发送的通知类型。
</div> </td>
</tr>
<tr class="rowColor" id="i13">
<td class="colFirst"><code>boolean</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/management/relation/RelationService.html#getPurgeFlag--">getPurgeFlag</a></span>()</code>
<div class="block">
返回标志以指示是否在关系中引用的MBean的注销收到通知如果必须立即执行关系的“清除”查找关系不再有效或者如果将只有当purgeRelations方法被显式调用时才执行。
</div> </td>
</tr>
<tr class="altColor" id="i14">
<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/RelationService.html#getReferencedMBeans-java.lang.String-">getReferencedMBeans</a></span>(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> relationId)</code>
<div class="block">
检索在关系的各种角色中引用的MBean。
</div> </td>
</tr>
<tr class="rowColor" id="i15">
<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/RelationService.html#getRelationTypeName-java.lang.String-">getRelationTypeName</a></span>(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> relationId)</code>
<div class="block">
返回给定关系的关联关系类型的名称。
</div> </td>
</tr>
<tr class="altColor" id="i16">
<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/RelationService.html#getRole-java.lang.String-java.lang.String-">getRole</a></span>(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> relationId, <a href="../../../java/lang/String.html" title="class in java.lang">String</a> roleName)</code>
<div class="block">
在给定关系中为给定的角色名称检索角色值。
</div> </td>
</tr>
<tr class="rowColor" id="i17">
<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/RelationService.html#getRoleCardinality-java.lang.String-java.lang.String-">getRoleCardinality</a></span>(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> relationId, <a href="../../../java/lang/String.html" title="class in java.lang">String</a> roleName)</code>
<div class="block">
检索当前在给定角色中引用的MBeans数。
</div> </td>
</tr>
<tr class="altColor" id="i18">
<td class="colFirst"><code><a href="../../../javax/management/relation/RoleInfo.html" title="class in javax.management.relation">RoleInfo</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/management/relation/RelationService.html#getRoleInfo-java.lang.String-java.lang.String-">getRoleInfo</a></span>(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> relationTypeName, <a href="../../../java/lang/String.html" title="class in java.lang">String</a> roleInfoName)</code>
<div class="block">
检索给定关系类型的给定角色名称的角色信息。
</div> </td>
</tr>
<tr class="rowColor" id="i19">
<td class="colFirst"><code><a href="../../../java/util/List.html" title="interface in java.util">List</a>&lt;<a href="../../../javax/management/relation/RoleInfo.html" title="class in javax.management.relation">RoleInfo</a>&gt;</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/management/relation/RelationService.html#getRoleInfos-java.lang.String-">getRoleInfos</a></span>(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> relationTypeName)</code>
<div class="block">
检索给定关系类型的角色信息RoleInfo对象的列表。
</div> </td>
</tr>
<tr class="altColor" id="i20">
<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/RelationService.html#getRoles-java.lang.String-java.lang.String:A-">getRoles</a></span>(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> relationId, <a href="../../../java/lang/String.html" title="class in java.lang">String</a>[] roleNameArray)</code>
<div class="block">
以给定的关系取得给定名称的角色值。
</div> </td>
</tr>
<tr class="rowColor" id="i21">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/management/relation/RelationService.html#handleNotification-javax.management.Notification-java.lang.Object-">handleNotification</a></span>(<a href="../../../javax/management/Notification.html" title="class in javax.management">Notification</a> notif, <a href="../../../java/lang/Object.html" title="class in java.lang">Object</a> handback)</code>
<div class="block">
JMX通知发生时调用。
</div> </td>
</tr>
<tr class="altColor" id="i22">
<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/RelationService.html#hasRelation-java.lang.String-">hasRelation</a></span>(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> relationId)</code>
<div class="block">
检查在关系服务中是否存在与给定关系id相关联的关系。
</div> </td>
</tr>
<tr class="rowColor" id="i23">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/management/relation/RelationService.html#isActive--">isActive</a></span>()</code>
<div class="block">
检查关系服务是否处于活动状态。
</div> </td>
</tr>
<tr class="altColor" id="i24">
<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/RelationService.html#isRelation-javax.management.ObjectName-">isRelation</a></span>(<a href="../../../javax/management/ObjectName.html" title="class in javax.management">ObjectName</a> objectName)</code>
<div class="block">
如果MBean作为关系服务中的关系添加则返回与给定ObjectName关联的关系id。
</div> </td>
</tr>
<tr class="rowColor" id="i25">
<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/RelationService.html#isRelationMBean-java.lang.String-">isRelationMBean</a></span>(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> relationId)</code>
<div class="block">
如果关系由MBean由用户创建并在关系服务中添加为关系表示则返回MBean的ObjectName。
</div> </td>
</tr>
<tr class="altColor" id="i26">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/management/relation/RelationService.html#postDeregister--">postDeregister</a></span>()</code>
<div class="block">
允许MBean在MBean服务器中取消注册后执行所需的任何操作。
</div> </td>
</tr>
<tr class="rowColor" id="i27">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/management/relation/RelationService.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="i28">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/management/relation/RelationService.html#preDeregister--">preDeregister</a></span>()</code>
<div class="block">
允许MBean在MBean服务器取消注册之前执行所需的任何操作。
</div> </td>
</tr>
<tr class="rowColor" id="i29">
<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/RelationService.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="i30">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/management/relation/RelationService.html#purgeRelations--">purgeRelations</a></span>()</code>
<div class="block">
清除关系。
</div> </td>
</tr>
<tr class="rowColor" id="i31">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/management/relation/RelationService.html#removeRelation-java.lang.String-">removeRelation</a></span>(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> relationId)</code>
<div class="block">
从关系服务中删除给定的关系。
</div> </td>
</tr>
<tr class="altColor" id="i32">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/management/relation/RelationService.html#removeRelationType-java.lang.String-">removeRelationType</a></span>(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> relationTypeName)</code>
<div class="block">
从关系服务中删除给定的关系类型。
</div> </td>
</tr>
<tr class="rowColor" id="i33">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/management/relation/RelationService.html#sendRelationCreationNotification-java.lang.String-">sendRelationCreationNotification</a></span>(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> relationId)</code>
<div class="block">
发送关系创建的通知RelationNotification
</div> </td>
</tr>
<tr class="altColor" id="i34">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/management/relation/RelationService.html#sendRelationRemovalNotification-java.lang.String-java.util.List-">sendRelationRemovalNotification</a></span>(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> relationId, <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; unregMBeanList)</code>
<div class="block">
发送通知RelationNotification用于删除关系。
</div> </td>
</tr>
<tr class="rowColor" id="i35">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/management/relation/RelationService.html#sendRoleUpdateNotification-java.lang.String-javax.management.relation.Role-java.util.List-">sendRoleUpdateNotification</a></span>(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> relationId, <a href="../../../javax/management/relation/Role.html" title="class in javax.management.relation">Role</a> newRole, <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; oldValue)</code>
<div class="block">
发送给定关系中角色更新的通知RelationNotification
</div> </td>
</tr>
<tr class="altColor" id="i36">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/management/relation/RelationService.html#setPurgeFlag-boolean-">setPurgeFlag</a></span>(boolean purgeFlag)</code>
<div class="block">
设置标志以指示是否在关系中引用的MBean注销的通知被接收如果必须立即执行关系的“清除”寻找关系不再有效或者如果将只有当purgeRelations方法被显式调用时才执行。
</div> </td>
</tr>
<tr class="rowColor" id="i37">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/management/relation/RelationService.html#setRole-java.lang.String-javax.management.relation.Role-">setRole</a></span>(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> relationId, <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="altColor" id="i38">
<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/RelationService.html#setRoles-java.lang.String-javax.management.relation.RoleList-">setRoles</a></span>(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> relationId, <a href="../../../javax/management/relation/RoleList.html" title="class in javax.management.relation">RoleList</a> roleList)</code>
<div class="block">
在给定的关系中设定给定的角色。
</div> </td>
</tr>
<tr class="rowColor" id="i39">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/management/relation/RelationService.html#updateRoleMap-java.lang.String-javax.management.relation.Role-java.util.List-">updateRoleMap</a></span>(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> relationId, <a href="../../../javax/management/relation/Role.html" title="class in javax.management.relation">Role</a> newRole, <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; oldValue)</code>
<div class="block">
处理关系服务角色图更新给定关系中给定角色的更新。
</div> </td>
</tr>
</tbody>
</table>
<ul class="blockList">
<li class="blockList"><a name="methods.inherited.from.class.javax.management.NotificationBroadcasterSupport">
<!-- --> </a> <h3>Methods inherited from class javax.management.<a href="../../../javax/management/NotificationBroadcasterSupport.html" title="class in javax.management">NotificationBroadcasterSupport</a></h3> <code><a href="../../../javax/management/NotificationBroadcasterSupport.html#addNotificationListener-javax.management.NotificationListener-javax.management.NotificationFilter-java.lang.Object-">addNotificationListener</a>, <a href="../../../javax/management/NotificationBroadcasterSupport.html#handleNotification-javax.management.NotificationListener-javax.management.Notification-java.lang.Object-">handleNotification</a>, <a href="../../../javax/management/NotificationBroadcasterSupport.html#removeNotificationListener-javax.management.NotificationListener-">removeNotificationListener</a>, <a href="../../../javax/management/NotificationBroadcasterSupport.html#removeNotificationListener-javax.management.NotificationListener-javax.management.NotificationFilter-java.lang.Object-">removeNotificationListener</a>, <a href="../../../javax/management/NotificationBroadcasterSupport.html#sendNotification-javax.management.Notification-">sendNotification</a></code></li>
</ul>
<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="RelationService-boolean-">
<!-- --> </a>
<ul class="blockListLast">
<li class="blockList"> <h4>RelationService</h4> <pre>public RelationService(boolean immediatePurgeFlag)</pre>
<div class="block">
构造函数
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<span><code>immediatePurgeFlag</code> - 用于指示何时接收关于在关系中引用的MBean的注销的通知的时间如果必须执行关系的立即“清除”寻找关系不再有效或者将执行该关系只有当purgeRelations方法被显式调用时。</span>
<p> <span>真的是立即清除。</span> </p>
</dd>
</dl> </li>
</ul> </li>
</ul>
<!-- ============ METHOD DETAIL ========== -->
<ul class="blockList">
<li class="blockList"><a name="method.detail">
<!-- --> </a> <h3>方法详细信息</h3> <a name="isActive--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>isActive</h4> <pre>public void isActive()
throws <a href="../../../javax/management/relation/RelationServiceNotRegisteredException.html" title="class in javax.management.relation">RelationServiceNotRegisteredException</a></pre>
<div class="block">
<span>检查关系服务是否处于活动状态。</span>
<span>当前情况是必须在MBean服务器中注册关系服务</span>
</div>
<dl>
<dt>
<span class="overrideSpecifyLabel">Specified by:</span>
</dt>
<dd>
<code><a href="../../../javax/management/relation/RelationServiceMBean.html#isActive--">isActive</a></code>在界面
<code><a href="../../../javax/management/relation/RelationServiceMBean.html" title="interface in javax.management.relation">RelationServiceMBean</a></code>
</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> - 如果没有注册
</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将在其中
<code>server</code>的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="getPurgeFlag--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getPurgeFlag</h4> <pre>public boolean getPurgeFlag()</pre>
<div class="block">
<span>返回标志以指示是否在关系中引用的MBean的注销收到通知如果必须立即执行关系的“清除”查找关系不再有效或者如果将只有当purgeRelations方法被显式调用时才执行。</span>
<p> <span>真的是立即清除。</span> </p>
</div>
<dl>
<dt>
<span class="overrideSpecifyLabel">Specified by:</span>
</dt>
<dd>
<code><a href="../../../javax/management/relation/RelationServiceMBean.html#getPurgeFlag--">getPurgeFlag</a></code>在接口
<code><a href="../../../javax/management/relation/RelationServiceMBean.html" title="interface in javax.management.relation">RelationServiceMBean</a></code>
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
如果清洗是自动的,则为真。
</dd>
<dt>
<span class="seeLabel">另请参见:</span>
</dt>
<dd>
<a href="../../../javax/management/relation/RelationService.html#setPurgeFlag-boolean-"><code>setPurgeFlag(boolean)</code></a>
</dd>
</dl> </li>
</ul> <a name="setPurgeFlag-boolean-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>setPurgeFlag</h4> <pre>public void setPurgeFlag(boolean purgeFlag)</pre>
<div class="block">
<span>设置标志以指示是否在关系中引用的MBean注销的通知被接收如果必须立即执行关系的“清除”寻找关系不再有效或者如果将只有当purgeRelations方法被显式调用时才执行。</span>
<p> <span>真的是立即清除。</span> </p>
</div>
<dl>
<dt>
<span class="overrideSpecifyLabel">Specified by:</span>
</dt>
<dd>
<code><a href="../../../javax/management/relation/RelationServiceMBean.html#setPurgeFlag-boolean-">setPurgeFlag</a></code>在接口
<code><a href="../../../javax/management/relation/RelationServiceMBean.html" title="interface in javax.management.relation">RelationServiceMBean</a></code>
</dd>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>purgeFlag</code> - 国旗
</dd>
<dt>
<span class="seeLabel">另请参见:</span>
</dt>
<dd>
<a href="../../../javax/management/relation/RelationService.html#getPurgeFlag--"><code>getPurgeFlag()</code></a>
</dd>
</dl> </li>
</ul> <a name="createRelationType-java.lang.String-javax.management.relation.RoleInfo:A-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>createRelationType</h4> <pre>public void createRelationType(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> relationTypeName,
<a href="../../../javax/management/relation/RoleInfo.html" title="class in javax.management.relation">RoleInfo</a>[] roleInfoArray)
throws <a href="../../../java/lang/IllegalArgumentException.html" title="class in java.lang">IllegalArgumentException</a>,
<a href="../../../javax/management/relation/InvalidRelationTypeException.html" title="class in javax.management.relation">InvalidRelationTypeException</a></pre>
<div class="block">
使用给定的角色信息由RoleInfo对象提供创建关系类型RelationTypeSupport对象并将其添加到关系服务中。
</div>
<dl>
<dt>
<span class="overrideSpecifyLabel">Specified by:</span>
</dt>
<dd>
<code><a href="../../../javax/management/relation/RelationServiceMBean.html#createRelationType-java.lang.String-javax.management.relation.RoleInfo:A-">createRelationType</a></code>在接口
<code><a href="../../../javax/management/relation/RelationServiceMBean.html" title="interface in javax.management.relation">RelationServiceMBean</a></code>
</dd>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>relationTypeName</code> - 关系类型的名称
</dd>
<dd>
<code>roleInfoArray</code> - 角色信息数组
</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>
<span><code><a href="../../../javax/management/relation/InvalidRelationTypeException.html" title="class in javax.management.relation">InvalidRelationTypeException</a></code> - 如果:</span>
<p> <span> - 已经有一个关系类型与该名称</span> </p>
<p> <span> - 相同的名称已被用于两个不同的角色信息</span> </p>
<p> <span> - 没有提供角色信息</span> </p>
<p> <span> - 提供一个空的角色信息</span> </p>
</dd>
</dl> </li>
</ul> <a name="addRelationType-javax.management.relation.RelationType-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>addRelationType</h4> <pre>public void addRelationType(<a href="../../../javax/management/relation/RelationType.html" title="interface in javax.management.relation">RelationType</a> relationTypeObj)
throws <a href="../../../java/lang/IllegalArgumentException.html" title="class in java.lang">IllegalArgumentException</a>,
<a href="../../../javax/management/relation/InvalidRelationTypeException.html" title="class in javax.management.relation">InvalidRelationTypeException</a></pre>
<div class="block">
<span>将给定对象添加为关系类型。</span>
<span>该对象预计将实现RelationType接口。</span>
</div>
<dl>
<dt>
<span class="overrideSpecifyLabel">Specified by:</span>
</dt>
<dd>
<code><a href="../../../javax/management/relation/RelationServiceMBean.html#addRelationType-javax.management.relation.RelationType-">addRelationType</a></code>在接口
<code><a href="../../../javax/management/relation/RelationServiceMBean.html" title="interface in javax.management.relation">RelationServiceMBean</a></code>
</dd>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>relationTypeObj</code> - 关系类型对象实现RelationType接口
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../../java/lang/IllegalArgumentException.html" title="class in java.lang">IllegalArgumentException</a></code> - 如果null参数或者如果
<a href="../../../javax/management/relation/RelationType.html#getRelationTypeName--"><code>relationTypeObj.getRelationTypeName()</code></a>返回null。
</dd>
<dd>
<span><code><a href="../../../javax/management/relation/InvalidRelationTypeException.html" title="class in javax.management.relation">InvalidRelationTypeException</a></code> - 如果:</span>
<p> <span> - 相同的名称已被用于两个不同的角色</span> </p>
<p> <span> - 没有提供角色信息</span> </p>
<p> <span> - 提供一个空的角色信息</span> </p>
<p> <span> - 已经有一个关系类型与该名称</span> </p>
</dd>
</dl> </li>
</ul> <a name="getAllRelationTypeNames--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getAllRelationTypeNames</h4> <pre>public <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; getAllRelationTypeNames()</pre>
<div class="block">
检索所有已知关系类型的名称。
</div>
<dl>
<dt>
<span class="overrideSpecifyLabel">Specified by:</span>
</dt>
<dd>
<code><a href="../../../javax/management/relation/RelationServiceMBean.html#getAllRelationTypeNames--">getAllRelationTypeNames</a></code>在接口
<code><a href="../../../javax/management/relation/RelationServiceMBean.html" title="interface in javax.management.relation">RelationServiceMBean</a></code>
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
关系类型名称Strings的ArrayList
</dd>
</dl> </li>
</ul> <a name="getRoleInfos-java.lang.String-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getRoleInfos</h4> <pre>public <a href="../../../java/util/List.html" title="interface in java.util">List</a>&lt;<a href="../../../javax/management/relation/RoleInfo.html" title="class in javax.management.relation">RoleInfo</a>&gt; getRoleInfos(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> relationTypeName)
throws <a href="../../../java/lang/IllegalArgumentException.html" title="class in java.lang">IllegalArgumentException</a>,
<a href="../../../javax/management/relation/RelationTypeNotFoundException.html" title="class in javax.management.relation">RelationTypeNotFoundException</a></pre>
<div class="block">
检索给定关系类型的角色信息RoleInfo对象的列表。
</div>
<dl>
<dt>
<span class="overrideSpecifyLabel">Specified by:</span>
</dt>
<dd>
<code><a href="../../../javax/management/relation/RelationServiceMBean.html#getRoleInfos-java.lang.String-">getRoleInfos</a></code>在界面
<code><a href="../../../javax/management/relation/RelationServiceMBean.html" title="interface in javax.management.relation">RelationServiceMBean</a></code>
</dd>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>relationTypeName</code> - 关系类型的名称
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
RoleInfo的ArrayList。
</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/RelationTypeNotFoundException.html" title="class in javax.management.relation">RelationTypeNotFoundException</a></code> - 如果与该名称没有关系类型。
</dd>
</dl> </li>
</ul> <a name="getRoleInfo-java.lang.String-java.lang.String-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getRoleInfo</h4> <pre>public <a href="../../../javax/management/relation/RoleInfo.html" title="class in javax.management.relation">RoleInfo</a> getRoleInfo(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> relationTypeName,
<a href="../../../java/lang/String.html" title="class in java.lang">String</a> roleInfoName)
throws <a href="../../../java/lang/IllegalArgumentException.html" title="class in java.lang">IllegalArgumentException</a>,
<a href="../../../javax/management/relation/RelationTypeNotFoundException.html" title="class in javax.management.relation">RelationTypeNotFoundException</a>,
<a href="../../../javax/management/relation/RoleInfoNotFoundException.html" title="class in javax.management.relation">RoleInfoNotFoundException</a></pre>
<div class="block">
检索给定关系类型的给定角色名称的角色信息。
</div>
<dl>
<dt>
<span class="overrideSpecifyLabel">Specified by:</span>
</dt>
<dd>
<code><a href="../../../javax/management/relation/RelationServiceMBean.html#getRoleInfo-java.lang.String-java.lang.String-">getRoleInfo</a></code>在界面
<code><a href="../../../javax/management/relation/RelationServiceMBean.html" title="interface in javax.management.relation">RelationServiceMBean</a></code>
</dd>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>relationTypeName</code> - 关系类型的名称
</dd>
<dd>
<code>roleInfoName</code> - 角色名称
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
RoleInfo对象。
</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/RelationTypeNotFoundException.html" title="class in javax.management.relation">RelationTypeNotFoundException</a></code> - 如果关系类型在关系服务中未知
</dd>
<dd>
<code><a href="../../../javax/management/relation/RoleInfoNotFoundException.html" title="class in javax.management.relation">RoleInfoNotFoundException</a></code> - 如果角色不是关系类型的一部分。
</dd>
</dl> </li>
</ul> <a name="removeRelationType-java.lang.String-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>removeRelationType</h4> <pre>public void removeRelationType(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> relationTypeName)
throws <a href="../../../javax/management/relation/RelationServiceNotRegisteredException.html" title="class in javax.management.relation">RelationServiceNotRegisteredException</a>,
<a href="../../../java/lang/IllegalArgumentException.html" title="class in java.lang">IllegalArgumentException</a>,
<a href="../../../javax/management/relation/RelationTypeNotFoundException.html" title="class in javax.management.relation">RelationTypeNotFoundException</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/RelationServiceMBean.html#removeRelationType-java.lang.String-">removeRelationType</a></code>在界面
<code><a href="../../../javax/management/relation/RelationServiceMBean.html" title="interface in javax.management.relation">RelationServiceMBean</a></code>
</dd>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>relationTypeName</code> - 要删除的关系类型的名称
</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>
<dd>
<code><a href="../../../java/lang/IllegalArgumentException.html" title="class in java.lang">IllegalArgumentException</a></code> - 如果为空参数
</dd>
<dd>
<code><a href="../../../javax/management/relation/RelationTypeNotFoundException.html" title="class in javax.management.relation">RelationTypeNotFoundException</a></code> - 如果该名称没有关系类型
</dd>
</dl> </li>
</ul> <a name="createRelation-java.lang.String-java.lang.String-javax.management.relation.RoleList-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>createRelation</h4> <pre>public void createRelation(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> relationId,
<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> roleList)
throws <a href="../../../javax/management/relation/RelationServiceNotRegisteredException.html" title="class in javax.management.relation">RelationServiceNotRegisteredException</a>,
<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/InvalidRelationIdException.html" title="class in javax.management.relation">InvalidRelationIdException</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></pre>
<div class="block">
<span>创建给定关系类型的简单关系由RelationSupport对象表示并将其添加到关系服务中。</span>
<p> <span>角色根据参数中提供的角色列表进行初始化。</span> <span>没有以这种方式初始化的那些设置为ObjectName的空ArrayList。</span> </p>
<p> <span>发送一个类型为RELATION_BASIC_CREATION的关系通知。</span> </p>
</div>
<dl>
<dt>
<span class="overrideSpecifyLabel">Specified by:</span>
</dt>
<dd>
<code><a href="../../../javax/management/relation/RelationServiceMBean.html#createRelation-java.lang.String-java.lang.String-javax.management.relation.RoleList-">createRelation</a></code>在接口
<code><a href="../../../javax/management/relation/RelationServiceMBean.html" title="interface in javax.management.relation">RelationServiceMBean</a></code>
</dd>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>relationId</code> - 关系标识符,用于唯一标识关系服务内的关系
</dd>
<dd>
<code>relationTypeName</code> - 关系类型的名称(必须在关系服务中创建)
</dd>
<dd>
<code>roleList</code> - 用于初始化关系角色的角色列表可以为null
</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>
<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>
<code><a href="../../../javax/management/relation/InvalidRelationIdException.html" title="class in javax.management.relation">InvalidRelationIdException</a></code> - 如果关系id已经使用
</dd>
<dd>
<code><a href="../../../javax/management/relation/RelationTypeNotFoundException.html" title="class in javax.management.relation">RelationTypeNotFoundException</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> - 相同的角色名称用于两个不同的角色</span> </p>
<p> <span> - 给定值中引用的MBean的数量小于预期的最小度</span> </p>
<p> <span> - 提供的值中引用的MBean的数量超过预期的最大度</span> </p>
<p> <span> - 值中的一个引用的MBean不是该角色的MBean类的对象</span> </p>
<p> <span> - 为该角色提供的MBean不存在</span> </p>
</dd>
</dl> </li>
</ul> <a name="addRelation-javax.management.ObjectName-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>addRelation</h4> <pre>public void addRelation(<a href="../../../javax/management/ObjectName.html" title="class in javax.management">ObjectName</a> relationObjectName)
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="../../../java/lang/NoSuchMethodException.html" title="class in java.lang">NoSuchMethodException</a>,
<a href="../../../javax/management/relation/InvalidRelationIdException.html" title="class in javax.management.relation">InvalidRelationIdException</a>,
<a href="../../../javax/management/InstanceNotFoundException.html" title="class in javax.management">InstanceNotFoundException</a>,
<a href="../../../javax/management/relation/InvalidRelationServiceException.html" title="class in javax.management.relation">InvalidRelationServiceException</a>,
<a href="../../../javax/management/relation/RelationTypeNotFoundException.html" title="class in javax.management.relation">RelationTypeNotFoundException</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></pre>
<div class="block">
<span>将由用户创建的一个MBean并由他注册在MBean服务器中添加为关系服务中的关系。</span>
<p> <span>要作为关系添加MBean必须符合以下条件</span> </p>
<p> <span> - 实现Relation界面</span> </p>
<p> <span> - 为RelationService ObjectName提供当前关系服务的ObjectName</span> </p>
<p> <span> - 在当前的关系服务中具有唯一且不使用的关系ID</span> </p>
<p> <span> - 在关系服务中创建关系类型</span> </p>
<p> <span> - 具有符合关系类型中提供的角色信息的角色。</span> </p>
</div>
<dl>
<dt>
<span class="overrideSpecifyLabel">Specified by:</span>
</dt>
<dd>
<code><a href="../../../javax/management/relation/RelationServiceMBean.html#addRelation-javax.management.ObjectName-">addRelation</a></code>在接口
<code><a href="../../../javax/management/relation/RelationServiceMBean.html" title="interface in javax.management.relation">RelationServiceMBean</a></code>
</dd>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>relationObjectName</code> - 要添加的关系MBean的ObjectName。
</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="../../../java/lang/NoSuchMethodException.html" title="class in java.lang">NoSuchMethodException</a></code> - 如果MBean不实现Relation接口
</dd>
<dd>
<span><code><a href="../../../javax/management/relation/InvalidRelationIdException.html" title="class in javax.management.relation">InvalidRelationIdException</a></code> - if</span>
<p> <span> - 在MBean中没有关系标识符</span> </p>
<p> <span> - 关系标识符已经在关系服务中使用</span> </p>
</dd>
<dd>
<code><a href="../../../javax/management/InstanceNotFoundException.html" title="class in javax.management">InstanceNotFoundException</a></code> - 如果给定的ObjectName的MBean尚未注册
</dd>
<dd>
<span><code><a href="../../../javax/management/relation/InvalidRelationServiceException.html" title="class in javax.management.relation">InvalidRelationServiceException</a></code> - if</span>
<p> <span> - 在MBean中没有关系服务名称</span> </p>
<p> <span> - MBean中的关系服务名称不是当前的关系服务</span> </p>
</dd>
<dd>
<span><code><a href="../../../javax/management/relation/RelationTypeNotFoundException.html" title="class in javax.management.relation">RelationTypeNotFoundException</a></code> - 如果:</span>
<p> <span> - 在MBean中没有关系类型名称</span> </p>
<p> <span> - MBean中的关系类型名称与关系服务中创建的关系类型不对应</span> </p>
</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/RoleNotFoundException.html" title="class in javax.management.relation">RoleNotFoundException</a></code> - 如果为关系类型中不存在的角色提供值
</dd>
</dl> </li>
</ul> <a name="isRelationMBean-java.lang.String-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>isRelationMBean</h4> <pre>public <a href="../../../javax/management/ObjectName.html" title="class in javax.management">ObjectName</a> isRelationMBean(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> relationId)
throws <a href="../../../java/lang/IllegalArgumentException.html" title="class in java.lang">IllegalArgumentException</a>,
<a href="../../../javax/management/relation/RelationNotFoundException.html" title="class in javax.management.relation">RelationNotFoundException</a></pre>
<div class="block">
如果关系由MBean由用户创建并在关系服务中添加为关系表示则返回MBean的ObjectName。
</div>
<dl>
<dt>
<span class="overrideSpecifyLabel">Specified by:</span>
</dt>
<dd>
<code><a href="../../../javax/management/relation/RelationServiceMBean.html#isRelationMBean-java.lang.String-">isRelationMBean</a></code>在接口
<code><a href="../../../javax/management/relation/RelationServiceMBean.html" title="interface in javax.management.relation">RelationServiceMBean</a></code>
</dd>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>relationId</code> -
<code>relationId</code>关系的关系id
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
对应关系MBean的ObjectName如果关系不是MBean则为null。
</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/RelationNotFoundException.html" title="class in javax.management.relation">RelationNotFoundException</a></code> - 与该ID无关系
</dd>
</dl> </li>
</ul> <a name="isRelation-javax.management.ObjectName-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>isRelation</h4> <pre>public <a href="../../../java/lang/String.html" title="class in java.lang">String</a> isRelation(<a href="../../../javax/management/ObjectName.html" title="class in javax.management">ObjectName</a> objectName)
throws <a href="../../../java/lang/IllegalArgumentException.html" title="class in java.lang">IllegalArgumentException</a></pre>
<div class="block">
如果MBean作为关系服务中的关系添加则返回与给定ObjectName关联的关系id。
</div>
<dl>
<dt>
<span class="overrideSpecifyLabel">Specified by:</span>
</dt>
<dd>
<code><a href="../../../javax/management/relation/RelationServiceMBean.html#isRelation-javax.management.ObjectName-">isRelation</a></code>在界面
<code><a href="../../../javax/management/relation/RelationServiceMBean.html" title="interface in javax.management.relation">RelationServiceMBean</a></code>
</dd>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>objectName</code> - 假定关系的ObjectName
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
关系idString或null如果ObjectName不是由关系服务处理的关系
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../../java/lang/IllegalArgumentException.html" title="class in java.lang">IllegalArgumentException</a></code> - 如果为空参数
</dd>
</dl> </li>
</ul> <a name="hasRelation-java.lang.String-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>hasRelation</h4> <pre>public <a href="../../../java/lang/Boolean.html" title="class in java.lang">Boolean</a> hasRelation(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> relationId)
throws <a href="../../../java/lang/IllegalArgumentException.html" title="class in java.lang">IllegalArgumentException</a></pre>
<div class="block">
检查在关系服务中是否存在与给定关系id相关联的关系。
</div>
<dl>
<dt>
<span class="overrideSpecifyLabel">Specified by:</span>
</dt>
<dd>
<code><a href="../../../javax/management/relation/RelationServiceMBean.html#hasRelation-java.lang.String-">hasRelation</a></code>在接口
<code><a href="../../../javax/management/relation/RelationServiceMBean.html" title="interface in javax.management.relation">RelationServiceMBean</a></code>
</dd>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>relationId</code> -
<code>relationId</code>关系的关系id
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
boolean如果有关系则为true否则为false
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../../java/lang/IllegalArgumentException.html" title="class in java.lang">IllegalArgumentException</a></code> - 如果为空参数
</dd>
</dl> </li>
</ul> <a name="getAllRelationIds--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getAllRelationIds</h4> <pre>public <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; getAllRelationIds()</pre>
<div class="block">
返回由关系服务处理的所有关系的所有关系ID。
</div>
<dl>
<dt>
<span class="overrideSpecifyLabel">Specified by:</span>
</dt>
<dd>
<code><a href="../../../javax/management/relation/RelationServiceMBean.html#getAllRelationIds--">getAllRelationIds</a></code>在接口
<code><a href="../../../javax/management/relation/RelationServiceMBean.html" title="interface in javax.management.relation">RelationServiceMBean</a></code>
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
String的ArrayList
</dd>
</dl> </li>
</ul> <a name="checkRoleReading-java.lang.String-java.lang.String-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>checkRoleReading</h4> <pre>public <a href="../../../java/lang/Integer.html" title="class in java.lang">Integer</a> checkRoleReading(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> roleName,
<a href="../../../java/lang/String.html" title="class in java.lang">String</a> relationTypeName)
throws <a href="../../../java/lang/IllegalArgumentException.html" title="class in java.lang">IllegalArgumentException</a>,
<a href="../../../javax/management/relation/RelationTypeNotFoundException.html" title="class in javax.management.relation">RelationTypeNotFoundException</a></pre>
<div class="block">
检查给定角色是否可以以给定类型的关系读取。
</div>
<dl>
<dt>
<span class="overrideSpecifyLabel">Specified by:</span>
</dt>
<dd>
<code><a href="../../../javax/management/relation/RelationServiceMBean.html#checkRoleReading-java.lang.String-java.lang.String-">checkRoleReading</a></code>在界面
<code><a href="../../../javax/management/relation/RelationServiceMBean.html" title="interface in javax.management.relation">RelationServiceMBean</a></code>
</dd>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>roleName</code> - 要检查的角色的名称
</dd>
<dd>
<code>relationTypeName</code> - 关系类型的名称
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
<span>一个整数对应于在RoleUnresolved中表示为常量的可能问题的整数</span>
<p> <span> - 如果角色可以读取则为0</span> </p>
<p> <span> - 对应于RoleStatus.NO_ROLE_WITH_NAME的整数</span> </p>
<p> <span> - 对应于RoleStatus.ROLE_NOT_READABLE的整数</span> </p>
</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/RelationTypeNotFoundException.html" title="class in javax.management.relation">RelationTypeNotFoundException</a></code> - 如果关系类型在关系服务中未知
</dd>
</dl> </li>
</ul> <a name="checkRoleWriting-javax.management.relation.Role-java.lang.String-java.lang.Boolean-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>checkRoleWriting</h4> <pre>public <a href="../../../java/lang/Integer.html" title="class in java.lang">Integer</a> checkRoleWriting(<a href="../../../javax/management/relation/Role.html" title="class in javax.management.relation">Role</a> role,
<a href="../../../java/lang/String.html" title="class in java.lang">String</a> relationTypeName,
<a href="../../../java/lang/Boolean.html" title="class in java.lang">Boolean</a> initFlag)
throws <a href="../../../java/lang/IllegalArgumentException.html" title="class in java.lang">IllegalArgumentException</a>,
<a href="../../../javax/management/relation/RelationTypeNotFoundException.html" title="class in javax.management.relation">RelationTypeNotFoundException</a></pre>
<div class="block">
检查给定的角色是否可以按给定类型的关系进行设置。
</div>
<dl>
<dt>
<span class="overrideSpecifyLabel">Specified by:</span>
</dt>
<dd>
<code><a href="../../../javax/management/relation/RelationServiceMBean.html#checkRoleWriting-javax.management.relation.Role-java.lang.String-java.lang.Boolean-">checkRoleWriting</a></code>在界面
<code><a href="../../../javax/management/relation/RelationServiceMBean.html" title="interface in javax.management.relation">RelationServiceMBean</a></code>
</dd>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>role</code> - 要检查的角色
</dd>
<dd>
<code>relationTypeName</code> - 关系类型的名称
</dd>
<dd>
<code>initFlag</code> - 用于指定对角色初始化进行检查的标志,不能验证写访问权限。
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
<span>一个整数对应于在RoleUnresolved中表示为常量的可能问题的整数</span>
<p> <span> - 如果角色可以设置为0</span> </p>
<p> <span> - 对应于RoleStatus.NO_ROLE_WITH_NAME的整数</span> </p>
<p> <span> - 为RoleStatus.ROLE_NOT_WRITABLE的整数</span> </p>
<p> <span> - 为RoleStatus.LESS_THAN_MIN_ROLE_DEGREE的整数</span> </p>
<p> <span> - 为RoleStatus.MORE_THAN_MAX_ROLE_DEGREE的整数</span> </p>
<p> <span> - 为RoleStatus.REF_MBEAN_OF_INCORRECT_CLASS的整数</span> </p>
<p> <span> - 为RoleStatus.REF_MBEAN_NOT_REGISTERED的整数</span> </p>
</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/RelationTypeNotFoundException.html" title="class in javax.management.relation">RelationTypeNotFoundException</a></code> - 如果未知的关系类型
</dd>
</dl> </li>
</ul> <a name="sendRelationCreationNotification-java.lang.String-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>sendRelationCreationNotification</h4> <pre>public void sendRelationCreationNotification(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> relationId)
throws <a href="../../../java/lang/IllegalArgumentException.html" title="class in java.lang">IllegalArgumentException</a>,
<a href="../../../javax/management/relation/RelationNotFoundException.html" title="class in javax.management.relation">RelationNotFoundException</a></pre>
<div class="block">
<span>发送关系创建的通知RelationNotification</span>
<span>通知类型为:</span>
<p> <span> - RelationNotification.RELATION_BASIC_CREATION如果关系是关系服务内部的一个对象</span> </p>
<p> <span> - RelationNotification.RELATION_MBEAN_CREATION如果关系是作为关系添加的MBean。</span> </p>
<p> <span>源对象是Relation Service本身。</span> </p>
<p> <span>它在Relation Service中创建createRelation和addRelation方法。</span> </p>
</div>
<dl>
<dt>
<span class="overrideSpecifyLabel">Specified by:</span>
</dt>
<dd>
<code><a href="../../../javax/management/relation/RelationServiceMBean.html#sendRelationCreationNotification-java.lang.String-">sendRelationCreationNotification</a></code>在接口
<code><a href="../../../javax/management/relation/RelationServiceMBean.html" title="interface in javax.management.relation">RelationServiceMBean</a></code>
</dd>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>relationId</code> - 更新关系的关系标识符
</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/RelationNotFoundException.html" title="class in javax.management.relation">RelationNotFoundException</a></code> - 如果给定的关系id没有关系
</dd>
</dl> </li>
</ul> <a name="sendRoleUpdateNotification-java.lang.String-javax.management.relation.Role-java.util.List-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>sendRoleUpdateNotification</h4> <pre>public void sendRoleUpdateNotification(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> relationId,
<a href="../../../javax/management/relation/Role.html" title="class in javax.management.relation">Role</a> newRole,
<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; oldValue)
throws <a href="../../../java/lang/IllegalArgumentException.html" title="class in java.lang">IllegalArgumentException</a>,
<a href="../../../javax/management/relation/RelationNotFoundException.html" title="class in javax.management.relation">RelationNotFoundException</a></pre>
<div class="block">
<span>发送给定关系中角色更新的通知RelationNotification</span>
<span>通知类型为:</span>
<p> <span> - RelationNotification.RELATION_BASIC_UPDATE如果关系是关系服务内部的一个对象</span> </p>
<p> <span> - RelationNotification.RELATION_MBEAN_UPDATE如果关系是作为关系添加的MBean。</span> </p>
<p> <span>源对象是Relation Service本身。</span> </p>
<p> <span>它被称为关于MBean setRole用于给定角色和setRoles对于每个角色方法RelationSupport类中提供的实现</span> </p>
<p> <span>它也在Relation Service中调用setRole用于给定的角色和setRoles对于每个角色的方法。</span> </p>
</div>
<dl>
<dt>
<span class="overrideSpecifyLabel">Specified by:</span>
</dt>
<dd>
<code><a href="../../../javax/management/relation/RelationServiceMBean.html#sendRoleUpdateNotification-java.lang.String-javax.management.relation.Role-java.util.List-">sendRoleUpdateNotification</a></code>在接口
<code><a href="../../../javax/management/relation/RelationServiceMBean.html" title="interface in javax.management.relation">RelationServiceMBean</a></code>
</dd>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>relationId</code> - 更新关系的关系标识符
</dd>
<dd>
<code>newRole</code> - 新角色(名称和新值)
</dd>
<dd>
<code>oldValue</code> - 旧角色值ObjectName对象列表
</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/RelationNotFoundException.html" title="class in javax.management.relation">RelationNotFoundException</a></code> - 如果给定的关系id没有关系
</dd>
</dl> </li>
</ul> <a name="sendRelationRemovalNotification-java.lang.String-java.util.List-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>sendRelationRemovalNotification</h4> <pre>public void sendRelationRemovalNotification(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> relationId,
<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; unregMBeanList)
throws <a href="../../../java/lang/IllegalArgumentException.html" title="class in java.lang">IllegalArgumentException</a>,
<a href="../../../javax/management/relation/RelationNotFoundException.html" title="class in javax.management.relation">RelationNotFoundException</a></pre>
<div class="block">
<span>发送通知RelationNotification用于删除关系。</span>
<span>通知类型为:</span>
<p> <span> - RelationNotification.RELATION_BASIC_REMOVAL如果关系是关系服务内部的一个对象</span> </p>
<p> <span> - RelationNotification.RELATION_MBEAN_REMOVAL如果关系是作为关系添加的MBean。</span> </p>
<p> <span>源对象是Relation Service本身。</span> </p>
<p> <span>它在Relation Service中调用removeRelation方法。</span> </p>
</div>
<dl>
<dt>
<span class="overrideSpecifyLabel">Specified by:</span>
</dt>
<dd>
<code><a href="../../../javax/management/relation/RelationServiceMBean.html#sendRelationRemovalNotification-java.lang.String-java.util.List-">sendRelationRemovalNotification</a></code>在接口
<code><a href="../../../javax/management/relation/RelationServiceMBean.html" title="interface in javax.management.relation">RelationServiceMBean</a></code>
</dd>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>relationId</code> - 更新关系的关系标识符
</dd>
<dd>
<code>unregMBeanList</code> - 由于关系删除而预期未注册的MBean的
<code>unregMBeanList</code>列表可以为null
</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/RelationNotFoundException.html" title="class in javax.management.relation">RelationNotFoundException</a></code> - 如果给定的关系id没有关系
</dd>
</dl> </li>
</ul> <a name="updateRoleMap-java.lang.String-javax.management.relation.Role-java.util.List-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>updateRoleMap</h4> <pre>public void updateRoleMap(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> relationId,
<a href="../../../javax/management/relation/Role.html" title="class in javax.management.relation">Role</a> newRole,
<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; oldValue)
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/RelationNotFoundException.html" title="class in javax.management.relation">RelationNotFoundException</a></pre>
<div class="block">
<span>处理关系服务角色图更新给定关系中给定角色的更新。</span>
<p> <span>它被称为关于MBean setRole用于给定角色和setRoles对于每个角色方法RelationSupport类中提供的实现</span> </p>
<p> <span>它也在Relation Service中调用setRole用于给定的角色和setRoles对于每个角色的方法。</span> </p>
<p> <span>为了使关系服务保持一致性在MBean注销的情况下并且能够执行查询当更新角色时必须调用此方法。</span> </p>
</div>
<dl>
<dt>
<span class="overrideSpecifyLabel">Specified by:</span>
</dt>
<dd>
<code><a href="../../../javax/management/relation/RelationServiceMBean.html#updateRoleMap-java.lang.String-javax.management.relation.Role-java.util.List-">updateRoleMap</a></code>在接口
<code><a href="../../../javax/management/relation/RelationServiceMBean.html" title="interface in javax.management.relation">RelationServiceMBean</a></code>
</dd>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>relationId</code> - 更新关系的关系标识符
</dd>
<dd>
<code>newRole</code> - 新角色(名称和新值)
</dd>
<dd>
<code>oldValue</code> - 旧角色值ObjectName对象列表
</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/RelationNotFoundException.html" title="class in javax.management.relation">RelationNotFoundException</a></code> - 如果没有给定id的关系。
</dd>
</dl> </li>
</ul> <a name="removeRelation-java.lang.String-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>removeRelation</h4> <pre>public void removeRelation(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> relationId)
throws <a href="../../../javax/management/relation/RelationServiceNotRegisteredException.html" title="class in javax.management.relation">RelationServiceNotRegisteredException</a>,
<a href="../../../java/lang/IllegalArgumentException.html" title="class in java.lang">IllegalArgumentException</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_REMOVAL如果关系仅在关系服务内部</span> </p>
<p> <span> - RelationNotification.RELATION_MBEAN_REMOVAL如果关系被注册为MBean。</span> </p>
<p> <span>对于在这种关系中引用的MBean将不会做任何事情</span> </p>
</div>
<dl>
<dt>
<span class="overrideSpecifyLabel">Specified by:</span>
</dt>
<dd>
<code><a href="../../../javax/management/relation/RelationServiceMBean.html#removeRelation-java.lang.String-">removeRelation</a></code>在界面
<code><a href="../../../javax/management/relation/RelationServiceMBean.html" title="interface in javax.management.relation">RelationServiceMBean</a></code>
</dd>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>relationId</code> - 要删除的关系的关系id
</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>
<dd>
<code><a href="../../../java/lang/IllegalArgumentException.html" title="class in java.lang">IllegalArgumentException</a></code> - 如果为空参数
</dd>
<dd>
<code><a href="../../../javax/management/relation/RelationNotFoundException.html" title="class in javax.management.relation">RelationNotFoundException</a></code> - 如果与给定关系id相对应的关系不存在
</dd>
</dl> </li>
</ul> <a name="purgeRelations--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>purgeRelations</h4> <pre>public void purgeRelations()
throws <a href="../../../javax/management/relation/RelationServiceNotRegisteredException.html" title="class in javax.management.relation">RelationServiceNotRegisteredException</a></pre>
<div class="block">
<span>清除关系。</span>
<p> <span>根据purgeFlag值当接收到关联中引用的MBean的注销的通知如果该标志设置为true或者如果该标志设置为false则该方法被自动调用。</span> </p>
<p> <span>在这种情况下,用户可以调用它来保持关系的一致性。</span> <span>要记住如果MBean未注册并且清除不立即完成如果ObjectName被重用并分配给关系中引用的另一个MBean则手动调用此purgeRelations方法将导致麻烦因为将ObjectName作为对应于未注册的MBean没有看到新的MBean。</span> </p>
<p> <span>行为取决于引用未注册的MBean的角色的基数</span> </p>
<p> <span> - 如果删除角色中的一个MBean引用使其引用次数小于最小度则必须删除该关系。</span> </p>
<p> <span> - 如果删除MBean引用后剩余的引用数仍然在基数范围内请保持关系并更新它调用其handleMBeanUnregistration回调。</span> </p>
</div>
<dl>
<dt>
<span class="overrideSpecifyLabel">Specified by:</span>
</dt>
<dd>
<code><a href="../../../javax/management/relation/RelationServiceMBean.html#purgeRelations--">purgeRelations</a></code>在接口
<code><a href="../../../javax/management/relation/RelationServiceMBean.html" title="interface in javax.management.relation">RelationServiceMBean</a></code>
</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="findReferencingRelations-javax.management.ObjectName-java.lang.String-java.lang.String-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>findReferencingRelations</h4> <pre>public <a href="../../../java/util/Map.html" title="interface in java.util">Map</a>&lt;<a href="../../../java/lang/String.html" title="class in java.lang">String</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; findReferencingRelations(<a href="../../../javax/management/ObjectName.html" title="class in javax.management">ObjectName</a> mbeanName,
<a href="../../../java/lang/String.html" title="class in java.lang">String</a> relationTypeName,
<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></pre>
<div class="block">
<span>检索给定MBean引用的关系。</span>
<p> <span>这对应于CIM“引用”和“引用名称”操作。</span> </p>
</div>
<dl>
<dt>
<span class="overrideSpecifyLabel">Specified by:</span>
</dt>
<dd>
<code><a href="../../../javax/management/relation/RelationServiceMBean.html#findReferencingRelations-javax.management.ObjectName-java.lang.String-java.lang.String-">findReferencingRelations</a></code>在界面
<code><a href="../../../javax/management/relation/RelationServiceMBean.html" title="interface in javax.management.relation">RelationServiceMBean</a></code>
</dd>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>mbeanName</code> - MBean的ObjectName
</dd>
<dd>
<span><code>relationTypeName</code> - 可以为null;</span>
<span>如果指定的话,只有这种类型的关系才会在搜索中被考虑。</span>
<span>否则会考虑所有的关系类型。</span>
</dd>
<dd>
<span><code>roleName</code> - 可以为null;</span>
<span>如果指定则仅返回该角色中引用MBean的关系。</span>
<span>否则所有角色都被考虑。</span>
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
一个HashMap其中的关键字是引用MBean的关系的关系ids每个关键字的值都是一个角色名称的ArrayList可以在同一关系中的几个角色中引用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>
</dl> </li>
</ul> <a name="findAssociatedMBeans-javax.management.ObjectName-java.lang.String-java.lang.String-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>findAssociatedMBeans</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; findAssociatedMBeans(<a href="../../../javax/management/ObjectName.html" title="class in javax.management">ObjectName</a> mbeanName,
<a href="../../../java/lang/String.html" title="class in java.lang">String</a> relationTypeName,
<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></pre>
<div class="block">
<span>检索与某个关系中的给定关联的MBean。</span>
<p> <span>这对应于CIM Associator和AssociatorNames操作。</span> </p>
</div>
<dl>
<dt>
<span class="overrideSpecifyLabel">Specified by:</span>
</dt>
<dd>
<code><a href="../../../javax/management/relation/RelationServiceMBean.html#findAssociatedMBeans-javax.management.ObjectName-java.lang.String-java.lang.String-">findAssociatedMBeans</a></code>在接口
<code><a href="../../../javax/management/relation/RelationServiceMBean.html" title="interface in javax.management.relation">RelationServiceMBean</a></code>
</dd>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>mbeanName</code> - MBean的ObjectName
</dd>
<dd>
<span><code>relationTypeName</code> - 可以为null;</span>
<span>如果指定的话,只有这种类型的关系才会在搜索中被考虑。</span>
<span>否则会考虑所有的关系类型。</span>
</dd>
<dd>
<span><code>roleName</code> - 可以为null;</span>
<span>如果指定则仅考虑在该角色中引用MBean的关系。</span>
<span>否则所有角色都被考虑。</span>
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
一个HashMap其中的关键字是与给定MBean相关联的MBean的ObjectNames并且每个关键字的值是关键字MBean与给定关系的关系的关系id的ArrayList可以相关联的值在几个不同的关系
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../../java/lang/IllegalArgumentException.html" title="class in java.lang">IllegalArgumentException</a></code> - 如果为空参数
</dd>
</dl> </li>
</ul> <a name="findRelationsOfType-java.lang.String-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>findRelationsOfType</h4> <pre>public <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; findRelationsOfType(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> relationTypeName)
throws <a href="../../../java/lang/IllegalArgumentException.html" title="class in java.lang">IllegalArgumentException</a>,
<a href="../../../javax/management/relation/RelationTypeNotFoundException.html" title="class in javax.management.relation">RelationTypeNotFoundException</a></pre>
<div class="block">
返回给定类型的关系的关系id。
</div>
<dl>
<dt>
<span class="overrideSpecifyLabel">Specified by:</span>
</dt>
<dd>
<code><a href="../../../javax/management/relation/RelationServiceMBean.html#findRelationsOfType-java.lang.String-">findRelationsOfType</a></code>在界面
<code><a href="../../../javax/management/relation/RelationServiceMBean.html" title="interface in javax.management.relation">RelationServiceMBean</a></code>
</dd>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>relationTypeName</code> - 关系类型名称
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
一个关系ids的ArrayList。
</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/RelationTypeNotFoundException.html" title="class in javax.management.relation">RelationTypeNotFoundException</a></code> - 如果与该名称没有关系类型。
</dd>
</dl> </li>
</ul> <a name="getRole-java.lang.String-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> relationId,
<a href="../../../java/lang/String.html" title="class in java.lang">String</a> roleName)
throws <a href="../../../javax/management/relation/RelationServiceNotRegisteredException.html" title="class in javax.management.relation">RelationServiceNotRegisteredException</a>,
<a href="../../../java/lang/IllegalArgumentException.html" title="class in java.lang">IllegalArgumentException</a>,
<a href="../../../javax/management/relation/RelationNotFoundException.html" title="class in javax.management.relation">RelationNotFoundException</a>,
<a href="../../../javax/management/relation/RoleNotFoundException.html" title="class in javax.management.relation">RoleNotFoundException</a></pre>
<div class="block">
在给定关系中为给定的角色名称检索角色值。
</div>
<dl>
<dt>
<span class="overrideSpecifyLabel">Specified by:</span>
</dt>
<dd>
<code><a href="../../../javax/management/relation/RelationServiceMBean.html#getRole-java.lang.String-java.lang.String-">getRole</a></code>在界面
<code><a href="../../../javax/management/relation/RelationServiceMBean.html" title="interface in javax.management.relation">RelationServiceMBean</a></code>
</dd>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>relationId</code> - 关系id
</dd>
<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="../../../javax/management/relation/RelationServiceNotRegisteredException.html" title="class in javax.management.relation">RelationServiceNotRegisteredException</a></code> - 如果关系服务未注册
</dd>
<dd>
<code><a href="../../../java/lang/IllegalArgumentException.html" title="class in java.lang">IllegalArgumentException</a></code> - 如果为空参数
</dd>
<dd>
<code><a href="../../../javax/management/relation/RelationNotFoundException.html" title="class in javax.management.relation">RelationNotFoundException</a></code> - 如果与给定的id没有关系
</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>
<p> <span> - 角色不可读。</span> </p>
</dd>
<dt>
<span class="seeLabel">另请参见:</span>
</dt>
<dd>
<a href="../../../javax/management/relation/RelationService.html#setRole-java.lang.String-javax.management.relation.Role-"><code>setRole(java.lang.String, javax.management.relation.Role)</code></a>
</dd>
</dl> </li>
</ul> <a name="getRoles-java.lang.String-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> relationId,
<a href="../../../java/lang/String.html" title="class in java.lang">String</a>[] roleNameArray)
throws <a href="../../../javax/management/relation/RelationServiceNotRegisteredException.html" title="class in javax.management.relation">RelationServiceNotRegisteredException</a>,
<a href="../../../java/lang/IllegalArgumentException.html" title="class in java.lang">IllegalArgumentException</a>,
<a href="../../../javax/management/relation/RelationNotFoundException.html" title="class in javax.management.relation">RelationNotFoundException</a></pre>
<div class="block">
以给定的关系取得给定名称的角色值。
</div>
<dl>
<dt>
<span class="overrideSpecifyLabel">Specified by:</span>
</dt>
<dd>
<code><a href="../../../javax/management/relation/RelationServiceMBean.html#getRoles-java.lang.String-java.lang.String:A-">getRoles</a></code>在接口
<code><a href="../../../javax/management/relation/RelationServiceMBean.html" title="interface in javax.management.relation">RelationServiceMBean</a></code>
</dd>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>relationId</code> - 关系id
</dd>
<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="../../../javax/management/relation/RelationServiceNotRegisteredException.html" title="class in javax.management.relation">RelationServiceNotRegisteredException</a></code> - 如果关系服务未在MBean服务器中注册
</dd>
<dd>
<code><a href="../../../java/lang/IllegalArgumentException.html" title="class in java.lang">IllegalArgumentException</a></code> - 如果为空参数
</dd>
<dd>
<code><a href="../../../javax/management/relation/RelationNotFoundException.html" title="class in javax.management.relation">RelationNotFoundException</a></code> - 如果与给定的id没有关系
</dd>
<dt>
<span class="seeLabel">另请参见:</span>
</dt>
<dd>
<a href="../../../javax/management/relation/RelationService.html#setRoles-java.lang.String-javax.management.relation.RoleList-"><code>setRoles(java.lang.String, javax.management.relation.RoleList)</code></a>
</dd>
</dl> </li>
</ul> <a name="getAllRoles-java.lang.String-">
<!-- --> </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(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> relationId)
throws <a href="../../../java/lang/IllegalArgumentException.html" title="class in java.lang">IllegalArgumentException</a>,
<a href="../../../javax/management/relation/RelationNotFoundException.html" title="class in javax.management.relation">RelationNotFoundException</a>,
<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/RelationServiceMBean.html#getAllRoles-java.lang.String-">getAllRoles</a></code>在界面
<code><a href="../../../javax/management/relation/RelationServiceMBean.html" title="interface in javax.management.relation">RelationServiceMBean</a></code>
</dd>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>relationId</code> - 关系id
</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/RelationNotFoundException.html" title="class in javax.management.relation">RelationNotFoundException</a></code> - 如果没有给定id的关系
</dd>
<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="getRoleCardinality-java.lang.String-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> relationId,
<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/RelationNotFoundException.html" title="class in javax.management.relation">RelationNotFoundException</a>,
<a href="../../../javax/management/relation/RoleNotFoundException.html" title="class in javax.management.relation">RoleNotFoundException</a></pre>
<div class="block">
检索当前在给定角色中引用的MBeans数。
</div>
<dl>
<dt>
<span class="overrideSpecifyLabel">Specified by:</span>
</dt>
<dd>
<code><a href="../../../javax/management/relation/RelationServiceMBean.html#getRoleCardinality-java.lang.String-java.lang.String-">getRoleCardinality</a></code>在界面
<code><a href="../../../javax/management/relation/RelationServiceMBean.html" title="interface in javax.management.relation">RelationServiceMBean</a></code>
</dd>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>relationId</code> - 关系id
</dd>
<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> - 如果为空参数
</dd>
<dd>
<code><a href="../../../javax/management/relation/RelationNotFoundException.html" title="class in javax.management.relation">RelationNotFoundException</a></code> - 如果与给定的id没有关系
</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-java.lang.String-javax.management.relation.Role-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>setRole</h4> <pre>public void setRole(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> relationId,
<a href="../../../javax/management/relation/Role.html" title="class in javax.management.relation">Role</a> role)
throws <a href="../../../javax/management/relation/RelationServiceNotRegisteredException.html" title="class in javax.management.relation">RelationServiceNotRegisteredException</a>,
<a href="../../../java/lang/IllegalArgumentException.html" title="class in java.lang">IllegalArgumentException</a>,
<a href="../../../javax/management/relation/RelationNotFoundException.html" title="class in javax.management.relation">RelationNotFoundException</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></pre>
<div class="block">
<span>在给定的关系中设定给定的角色。</span>
<p> <span>将根据其在关系类型中提供的相应角色定义来检查角色</span> </p>
<p> <span>关系服务将跟踪变更以通过处理引用的MBean注销来保持关系的一致性。</span> </p>
</div>
<dl>
<dt>
<span class="overrideSpecifyLabel">Specified by:</span>
</dt>
<dd>
<code><a href="../../../javax/management/relation/RelationServiceMBean.html#setRole-java.lang.String-javax.management.relation.Role-">setRole</a></code>在界面
<code><a href="../../../javax/management/relation/RelationServiceMBean.html" title="interface in javax.management.relation">RelationServiceMBean</a></code>
</dd>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>relationId</code> - 关系id
</dd>
<dd>
<code>role</code> - 要设置的角色(名称和新值)
</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>
<dd>
<code><a href="../../../java/lang/IllegalArgumentException.html" title="class in java.lang">IllegalArgumentException</a></code> - 如果为空参数
</dd>
<dd>
<code><a href="../../../javax/management/relation/RelationNotFoundException.html" title="class in javax.management.relation">RelationNotFoundException</a></code> - 如果与给定的id没有关系
</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>要么</span> </p>
<p> <span> - 提供的值中引用的MBean的数量超过预期的最大度</span> </p>
<p> <span>要么</span> </p>
<p> <span> - 值中的一个引用的MBean不是该角色的MBean类的对象</span> </p>
<p> <span>要么</span> </p>
<p> <span> - 为该角色提供的MBean不存在</span> </p>
</dd>
<dt>
<span class="seeLabel">另请参见:</span>
</dt>
<dd>
<a href="../../../javax/management/relation/RelationService.html#getRole-java.lang.String-java.lang.String-"><code>getRole(java.lang.String, java.lang.String)</code></a>
</dd>
</dl> </li>
</ul> <a name="setRoles-java.lang.String-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="../../../java/lang/String.html" title="class in java.lang">String</a> relationId,
<a href="../../../javax/management/relation/RoleList.html" title="class in javax.management.relation">RoleList</a> roleList)
throws <a href="../../../javax/management/relation/RelationServiceNotRegisteredException.html" title="class in javax.management.relation">RelationServiceNotRegisteredException</a>,
<a href="../../../java/lang/IllegalArgumentException.html" title="class in java.lang">IllegalArgumentException</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>关系服务通过处理引用的MBean注销来跟踪更改以保持关系的一致性。</span> </p>
</div>
<dl>
<dt>
<span class="overrideSpecifyLabel">Specified by:</span>
</dt>
<dd>
<code><a href="../../../javax/management/relation/RelationServiceMBean.html#setRoles-java.lang.String-javax.management.relation.RoleList-">setRoles</a></code>在界面
<code><a href="../../../javax/management/relation/RelationServiceMBean.html" title="interface in javax.management.relation">RelationServiceMBean</a></code>
</dd>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>relationId</code> - 关系id
</dd>
<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="../../../javax/management/relation/RelationServiceNotRegisteredException.html" title="class in javax.management.relation">RelationServiceNotRegisteredException</a></code> - 如果关系服务未在MBean服务器中注册
</dd>
<dd>
<code><a href="../../../java/lang/IllegalArgumentException.html" title="class in java.lang">IllegalArgumentException</a></code> - 如果为空参数
</dd>
<dd>
<code><a href="../../../javax/management/relation/RelationNotFoundException.html" title="class in javax.management.relation">RelationNotFoundException</a></code> - 如果与给定的id没有关系
</dd>
<dt>
<span class="seeLabel">另请参见:</span>
</dt>
<dd>
<a href="../../../javax/management/relation/RelationService.html#getRoles-java.lang.String-java.lang.String:A-"><code>getRoles(java.lang.String, java.lang.String[])</code></a>
</dd>
</dl> </li>
</ul> <a name="getReferencedMBeans-java.lang.String-">
<!-- --> </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(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> relationId)
throws <a href="../../../java/lang/IllegalArgumentException.html" title="class in java.lang">IllegalArgumentException</a>,
<a href="../../../javax/management/relation/RelationNotFoundException.html" title="class in javax.management.relation">RelationNotFoundException</a></pre>
<div class="block">
检索在关系的各种角色中引用的MBean。
</div>
<dl>
<dt>
<span class="overrideSpecifyLabel">Specified by:</span>
</dt>
<dd>
<code><a href="../../../javax/management/relation/RelationServiceMBean.html#getReferencedMBeans-java.lang.String-">getReferencedMBeans</a></code>在界面
<code><a href="../../../javax/management/relation/RelationServiceMBean.html" title="interface in javax.management.relation">RelationServiceMBean</a></code>
</dd>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>relationId</code> - 关系id
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
<span>一个HashMap映射</span>
<p> <span>ObjectName - &gt; ArrayList的String角色名称</span> </p>
</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/RelationNotFoundException.html" title="class in javax.management.relation">RelationNotFoundException</a></code> - 如果给定的关系id没有关系
</dd>
</dl> </li>
</ul> <a name="getRelationTypeName-java.lang.String-">
<!-- --> </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(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> relationId)
throws <a href="../../../java/lang/IllegalArgumentException.html" title="class in java.lang">IllegalArgumentException</a>,
<a href="../../../javax/management/relation/RelationNotFoundException.html" title="class in javax.management.relation">RelationNotFoundException</a></pre>
<div class="block">
返回给定关系的关联关系类型的名称。
</div>
<dl>
<dt>
<span class="overrideSpecifyLabel">Specified by:</span>
</dt>
<dd>
<code><a href="../../../javax/management/relation/RelationServiceMBean.html#getRelationTypeName-java.lang.String-">getRelationTypeName</a></code>在接口
<code><a href="../../../javax/management/relation/RelationServiceMBean.html" title="interface in javax.management.relation">RelationServiceMBean</a></code>
</dd>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>relationId</code> - 关系id
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
关联关系类型的名称。
</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/RelationNotFoundException.html" title="class in javax.management.relation">RelationNotFoundException</a></code> - 如果给定关系id没有关系
</dd>
</dl> </li>
</ul> <a name="handleNotification-javax.management.Notification-java.lang.Object-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>handleNotification</h4> <pre>public void handleNotification(<a href="../../../javax/management/Notification.html" title="class in javax.management">Notification</a> notif,
<a href="../../../java/lang/Object.html" title="class in java.lang">Object</a> handback)</pre>
<div class="block">
<span>JMX通知发生时调用。</span>
<span>目前处理关于MBean取消注册的通知无论是在关系角色中引用还是作为关系本身。</span>
</div>
<dl>
<dt>
<span class="overrideSpecifyLabel">Specified by:</span>
</dt>
<dd>
<code><a href="../../../javax/management/NotificationListener.html#handleNotification-javax.management.Notification-java.lang.Object-">handleNotification</a></code>在接口
<code><a href="../../../javax/management/NotificationListener.html" title="interface in javax.management">NotificationListener</a></code>
</dd>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>notif</code> - 通知。
</dd>
<dd>
<code>handback</code> - 一种不透明的对象可帮助收听者将关于MBean发射器的信息可以为空关联起来。
</dd>
</dl> </li>
</ul> <a name="getNotificationInfo--">
<!-- --> </a>
<ul class="blockListLast">
<li class="blockList"> <h4>getNotificationInfo</h4> <pre>public <a href="../../../javax/management/MBeanNotificationInfo.html" title="class in javax.management">MBeanNotificationInfo</a>[] getNotificationInfo()</pre>
<div class="block">
返回一个NotificationInfo对象该对象包含通知的Java类的名称以及发送的通知类型。
</div>
<dl>
<dt>
<span class="overrideSpecifyLabel">Specified by:</span>
</dt>
<dd>
<code><a href="../../../javax/management/NotificationBroadcaster.html#getNotificationInfo--">getNotificationInfo</a></code>在界面
<code><a href="../../../javax/management/NotificationBroadcaster.html" title="interface in javax.management">NotificationBroadcaster</a></code>
</dd>
<dt>
<span class="overrideSpecifyLabel">重写:</span>
</dt>
<dd>
<code><a href="../../../javax/management/NotificationBroadcasterSupport.html#getNotificationInfo--">getNotificationInfo</a></code>
<code><a href="../../../javax/management/NotificationBroadcasterSupport.html" title="class in javax.management">NotificationBroadcasterSupport</a></code>
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
可能通知的数组。
</dd>
</dl> </li>
</ul> </li>
</ul> </li>
</ul>
</div>
</div>