compact3

javax.management.relation

Class RelationService

java.lang.Object

javax.management.NotificationBroadcasterSupport

javax.management.relation.RelationService

All Implemented Interfaces:

EventListener， MBeanRegistration， NotificationBroadcaster， NotificationEmitter， NotificationListener， RelationServiceMBean

public class RelationService
extends NotificationBroadcasterSupport
implements RelationServiceMBean, MBeanRegistration, NotificationListener

关系服务负责创建和删除关系类型和关系，处理一致性和提供查询机制。

它实现了notificationbroadcaster延伸notificationbroadcastersupport发送通知时，一个关系是从它删除。

它实现了notificationlistener接口可以接收关于关系的角色和关系MBeans引用MBeans注销通知。

它实现了mbeanregistration接口能够检索对象和管理服务器。

从以下版本开始：

一点五

构造方法摘要

构造方法

Constructor and Description
RelationService(boolean immediatePurgeFlag) 构造函数。

方法摘要

Modifier and Type	Method and Description
void	addRelation(ObjectName relationObjectName) 添加用户创建的MBean（和注册由他在MBean服务器）在关系服务的关系。
void	addRelationType(RelationType relationTypeObj) 添加给定对象作为关系类型。
Integer	checkRoleReading(String roleName, String relationTypeName) 检查给定的角色是否可以在给定类型的关系中读取。
Integer	checkRoleWriting(Role role, String relationTypeName, Boolean initFlag) 检查给定的角色是否可以设置在给定类型的关系中。
void	createRelation(String relationId, String relationTypeName, RoleList roleList) 创建一个简单的关系（由relationsupport对象表示）给定关系类型，并将其添加在关系服务。
void	createRelationType(String relationTypeName, RoleInfo[] roleInfoArray) 创建一个关系型（一relationtypesupport对象）与给定的角色信息（由roleinfo对象提供），并将其添加在关系服务。
Map<ObjectName,List<String>>	findAssociatedMBeans(ObjectName mbeanName, String relationTypeName, String roleName) 检索给定一个MBean相关关系。
Map<String,List<String>>	findReferencingRelations(ObjectName mbeanName, String relationTypeName, String roleName) 检索的关系在一个给定的MBean参考。
List<String>	findRelationsOfType(String relationTypeName) 返回给定类型关系的关系标识。
List<String>	getAllRelationIds() 返回关系服务处理的所有关系的所有关系标识。
List<String>	getAllRelationTypeNames() 检索所有已知关系类型的名称。
RoleResult	getAllRoles(String relationId) 返回当前在关系中的所有角色。
MBeanNotificationInfo[]	getNotificationInfo() 返回一个包含该通知和通知类型的java类的名称notificationinfo对象发送。
boolean	getPurgeFlag() 返回标志如果通知时MBean的关系中的引用关系注销，如果立即“清除”（寻找关系不再有效）必须执行，或者将要执行时，purgerelations方法将显式调用。
Map<ObjectName,List<String>>	getReferencedMBeans(String relationId) 检索关系的各种角色引用MBeans。
String	getRelationTypeName(String relationId) 给定关系的关联关系类型的返回名称。
List<ObjectName>	getRole(String relationId, String roleName) 检索给定角色名在给定关系中的角色值。
Integer	getRoleCardinality(String relationId, String roleName) 检索当前引用MBean给定角色的数量。
RoleInfo	getRoleInfo(String relationTypeName, String roleInfoName) 检索给定关系类型的给定角色名的角色信息。
List<RoleInfo>	getRoleInfos(String relationTypeName) 检索角色信息列表（roleinfo对象）的一个给定的关系式。
RoleResult	getRoles(String relationId, String[] roleNameArray) 在给定关系中检索给定名称的角色的值。
void	handleNotification(Notification notif, Object handback) 当调用一个JMX通知发生。
Boolean	hasRelation(String relationId) 检查是否有关系服务中确定的关系与给定的关系。
void	isActive() 检查关系服务是否是活动的。
String	isRelation(ObjectName objectName) 返回与给定的对象如果MBean已添加在关系服务关系ID。
ObjectName	isRelationMBean(String relationId) 如果关系是通过MBean代表（由用户创建并添加在关系服务关系），返回的MBean对象。
void	postDeregister() 允许MBean执行任何操作在MBean服务器被注册后需要。
void	postRegister(Boolean registrationDone) 允许MBean执行任何操作在MBean服务器或注册后不需要注册后。
void	preDeregister() 允许MBean执行任何需要的操作之前被注册的MBean服务器。
ObjectName	preRegister(MBeanServer server, ObjectName name) 允许MBean执行任何操作之前，它需要在MBean服务器注册。
void	purgeRelations() 清洗的关系。
void	removeRelation(String relationId) 从关系服务中移除给定的关系。
void	removeRelationType(String relationTypeName) 从关系服务中移除给定的关系类型。
void	sendRelationCreationNotification(String relationId) 发送通知（relationnotification）有关系的创造。
void	sendRelationRemovalNotification(String relationId, List<ObjectName> unregMBeanList) 发送通知（relationnotification）一个关系的去除。
void	sendRoleUpdateNotification(String relationId, Role newRole, List<ObjectName> oldValue) 发送通知（relationnotification）在给定关系的角色更新。
void	setPurgeFlag(boolean purgeFlag) 这个标志表示如果通知时MBean的关系中的引用关系注销，如果立即“清除”（寻找关系不再有效）必须执行，或者将要执行时，purgerelations方法将显式调用。
void	setRole(String relationId, Role role) 设置给定关系中的给定角色。
RoleResult	setRoles(String relationId, RoleList roleList) 设置给定关系中的给定角色。
void	updateRoleMap(String relationId, Role newRole, List<ObjectName> oldValue) 处理给定关系中给定角色的关系服务角色映射的更新。

Methods inherited from class javax.management.NotificationBroadcasterSupport

addNotificationListener, handleNotification, removeNotificationListener, removeNotificationListener, sendNotification

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

RelationService

public RelationService(boolean immediatePurgeFlag)

构造函数。

参数

immediatePurgeFlag旗指示通知时MBean的关系中的引用关系注销，如果立即“清除”（寻找关系不再有效）必须执行，或者将要执行时，purgerelations方法将显式调用。

真是立即清除。

方法详细信息

isActive

public void isActive()
              throws RelationServiceNotRegisteredException

检查关系服务是否是活动的。目前的状况是关系服务必须在MBean服务器注册

Specified by:

isActive 接口 RelationServiceMBean

异常

RelationServiceNotRegisteredException -如果不是注册

preRegister

public ObjectName preRegister(MBeanServer server,
                              ObjectName name)
                       throws 异常

从接口复制的描述： MBeanRegistration

允许MBean执行任何操作之前，它需要在MBean服务器注册。如果未指定的MBean的名字，MBean可以登记为其提供一个名称。如果有异常抛出，MBean将不会在MBean服务器注册。

Specified by:

preRegister 接口 MBeanRegistration

参数

server的MBean服务器中，MBean将注册。

name - MBean对象名称。如果Name参数中的一个 MBeanServer接口 createMBean或 registerMBean方法是零这个名字是空的。在这种情况下，该方法必须返回一个非空的新的MBean对象。

结果

的名义下，MBean是注册。此值不能为空。如果 name参数不为空，它通常但不返回值。

异常

异常这个例外将被重新抛出的MBean服务器作为一个 MBeanRegistrationException。

postRegister

public void postRegister(Boolean registrationDone)

从接口复制的描述： MBeanRegistration

允许MBean执行任何操作在MBean服务器或注册后不需要注册后。

如果执行此方法抛出一个RuntimeException或Error MBean服务器对象，将里面的人RuntimeMBeanException或RuntimeErrorException，分别。然而，在postRegister抛出异常并不会改变MBean的状态：如果MBean已经注册（registrationDone是true），MBean将保持注册。

这可能是混乱的代码调用createMBean()或registerMBean()，这样的代码可能会认为MBean注册失败时抛出一个异常。因此建议实现postRegister不抛出运行时异常或错误，如果它是可以避免的。

Specified by:

postRegister 接口 MBeanRegistration

参数

registrationDone -指示是否MBean已在MBean服务器注册成功。价值错误意味着注册阶段已经失败。

preDeregister

public void preDeregister()
                   throws 异常

从接口复制的描述： MBeanRegistration

允许MBean执行任何需要的操作之前被注册的MBean服务器。

Specified by:

preDeregister 接口 MBeanRegistration

异常

异常这个例外将被重新抛出的MBean服务器作为一个 MBeanRegistrationException。

postDeregister

public void postDeregister()

从接口复制的描述： MBeanRegistration

允许MBean执行任何操作在MBean服务器被注册后需要。

如果执行此方法抛出一个RuntimeException或Error MBean服务器对象，将里面的人RuntimeMBeanException或RuntimeErrorException，分别。然而，在postDeregister抛出异常并不会改变MBean状态：MBean已成功注销，今后仍将如此。

这可能是混乱的代码调用unregisterMBean()，它可能认为MBean deregistration已经失败了。因此建议实现postDeregister不抛出运行时异常或错误，如果它是可以避免的。

Specified by:

postDeregister 接口 MBeanRegistration

getPurgeFlag

public boolean getPurgeFlag()

返回标志如果通知时MBean的关系中的引用关系注销，如果立即“清除”（寻找关系不再有效）必须执行，或者将要执行时，purgerelations方法将显式调用。

真是立即清除。

Specified by:

getPurgeFlag 接口 RelationServiceMBean

结果

如果是自动清洗。

另请参见：

setPurgeFlag(boolean)

setPurgeFlag

public void setPurgeFlag(boolean purgeFlag)

这个标志表示如果通知时MBean的关系中的引用关系注销，如果立即“清除”（寻找关系不再有效）必须执行，或者将要执行时，purgerelations方法将显式调用。

真是立即清除。

Specified by:

setPurgeFlag 接口 RelationServiceMBean

参数

purgeFlag旗

另请参见：

getPurgeFlag()

createRelationType

public void createRelationType(String relationTypeName,
                               RoleInfo[] roleInfoArray)
                        throws IllegalArgumentException,
                               InvalidRelationTypeException

创建一个关系型（一relationtypesupport对象）与给定的角色信息（由roleinfo对象提供），并将其添加在关系服务。

Specified by:

createRelationType 接口 RelationServiceMBean

参数

relationTypeName -关系型的名字

roleInfoArray -角色信息的数组

异常

IllegalArgumentException如果空参数

InvalidRelationTypeException如果：

-已经有一个同名的关系类型

该名称已被用于两个不同的角色的信息

-没有提供任何角色信息

提供一个空的角色信息

addRelationType

public void addRelationType(RelationType relationTypeObj)
                     throws IllegalArgumentException,
                            InvalidRelationTypeException

添加给定对象作为关系类型。目标有望实现relationtype接口。

Specified by:

addRelationType 接口 RelationServiceMBean

参数

relationTypeObj关系型对象（实施relationtype接口）

异常

IllegalArgumentException如果空参数或者 relationTypeObj.getRelationTypeName()返回null。

InvalidRelationTypeException如果：

-相同的名称已被用于两个不同的角色

-没有提供任何角色信息

提供一个空的角色信息

-已经有一个同名的关系类型

getAllRelationTypeNames

public List<String> getAllRelationTypeNames()

检索所有已知关系类型的名称。

Specified by:

getAllRelationTypeNames 接口 RelationServiceMBean

结果

关系类型名称的数组（字符串）

getRoleInfos

public List<RoleInfo> getRoleInfos(String relationTypeName)
                            throws IllegalArgumentException,
                                   RelationTypeNotFoundException

检索角色信息列表（roleinfo对象）的一个给定的关系式。

Specified by:

getRoleInfos 接口 RelationServiceMBean

参数

relationTypeName -关系型的名字

结果

ArrayList的roleinfo。

异常

IllegalArgumentException如果空参数

RelationTypeNotFoundException -如果没有叫这个名字的关系式。

getRoleInfo

public RoleInfo getRoleInfo(String relationTypeName,
                            String roleInfoName)
                     throws IllegalArgumentException,
                            RelationTypeNotFoundException,
                            RoleInfoNotFoundException

检索给定关系类型的给定角色名的角色信息。

Specified by:

getRoleInfo 接口 RelationServiceMBean

参数

relationTypeName -关系型的名字

roleInfoName名字的角色

结果

roleinfo对象。

异常

IllegalArgumentException如果空参数

RelationTypeNotFoundException如果关系类型不在关系服务

RoleInfoNotFoundException -如果角色不是关系型的一部分。

removeRelationType

public void removeRelationType(String relationTypeName)
                        throws RelationServiceNotRegisteredException,
                               IllegalArgumentException,
                               RelationTypeNotFoundException

从关系服务中移除给定的关系类型。

该类型的关系对象将从关系服务中删除。

Specified by:

removeRelationType 接口 RelationServiceMBean

参数

relationTypeName -关系型被删除的名字

异常

RelationServiceNotRegisteredException如果关系服务不在MBean服务器注册

IllegalArgumentException如果空参数

RelationTypeNotFoundException -如果没有叫这个名字的关系式

createRelation

public void createRelation(String relationId,
                           String relationTypeName,
                           RoleList roleList)
                    throws RelationServiceNotRegisteredException,
                           IllegalArgumentException,
                           RoleNotFoundException,
                           InvalidRelationIdException,
                           RelationTypeNotFoundException,
                           InvalidRoleValueException

创建一个简单的关系（由relationsupport对象表示）给定关系类型，并将其添加在关系服务。

根据参数中提供的角色列表初始化角色。那些没有初始化，这样设置的objectnames空数组。

一个relationnotification，relation_basic_creation型，发送。

Specified by:

createRelation 接口 RelationServiceMBean

参数

relationId关联的标识符，确定独特的内部关系服务的关系

relationTypeName -关系的类型名称（必须在关系服务创建）

roleList角色列表初始化的关系角色（可以为空）。

异常

RelationServiceNotRegisteredException如果关系服务不在MBean服务器注册

IllegalArgumentException如果空参数，除了角色列表，可以为空，如果没有角色初始化

RoleNotFoundException -如果一个值是提供一个角色不存在关系式

InvalidRelationIdException如果关系ID已使用

RelationTypeNotFoundException如果关系型的关系服务不知道

InvalidRoleValueException如果：

-相同的角色名称用于两个不同的角色

-引用MBeans给定值的数量少于预期的最低程度

-提供价值参考MBeans最大程度超过预期的数量

一个引用MBean的价值不在于MBean类预期，作用对象

对于这个角色不存在提供MBean

addRelation

public void addRelation(ObjectName relationObjectName)
                 throws IllegalArgumentException,
                        RelationServiceNotRegisteredException,
                        NoSuchMethodException,
                        InvalidRelationIdException,
                        InstanceNotFoundException,
                        InvalidRelationServiceException,
                        RelationTypeNotFoundException,
                        RoleNotFoundException,
                        InvalidRoleValueException

添加用户创建的MBean（和注册由他在MBean服务器）在关系服务的关系。

作为一种关系，MBean必须符合以下：

-实现关系接口

有relationservice对象当前关系服务的对象

在当前关系服务中有一个唯一的和未使用的关系标识

-在关系服务中创建的关系类型

-有符合关系类型中提供的角色信息的角色。

Specified by:

addRelation 接口 RelationServiceMBean

参数

relationObjectName - ObjectName关系MBean将增加。

异常

IllegalArgumentException如果空参数

RelationServiceNotRegisteredException如果关系服务不在MBean服务器注册

NoSuchMethodException如果MBean没有实现关系的界面

InvalidRelationIdException如果：

标识在MBean没有关系

-关系标识符已在关系服务中使用

InstanceNotFoundException如果给定对象尚未注册MBean

InvalidRelationServiceException如果：

在MBean没有关系的服务名称

在MBean的关系服务名称不一的电流关系服务

RelationTypeNotFoundException如果：

在MBean没有关系类型名称

在MBean的关系类型名称不对应一个服务创建关系型的关系

InvalidRoleValueException如果：

-引用MBeans角色中的数量低于预期的最低程度

-引用MBeans角色中最大程度的数量超过预期

一个引用MBean的价值不在于MBean类预期，作用对象

对一个角色提供了一个MBean不存在

RoleNotFoundException -如果一个值是提供一个角色不存在关系式

isRelationMBean

public ObjectName isRelationMBean(String relationId)
                           throws IllegalArgumentException,
                                  RelationNotFoundException

如果关系是通过MBean代表（由用户创建并添加在关系服务关系），返回的MBean对象。

Specified by:

isRelationMBean 接口 RelationServiceMBean

参数

relationId关系ID识别的关系

结果

MBean对象的对应关系，或null如果关系不是一个MBean。

异常

IllegalArgumentException如果空参数

RelationNotFoundException -没有ID关联

isRelation

public String isRelation(ObjectName objectName)
                  throws IllegalArgumentException

返回与给定的对象如果MBean已添加在关系服务关系ID。

Specified by:

isRelation 接口 RelationServiceMBean

参数

objectName -所谓的关系ObjectName

结果

关系ID（字符串）或零（如果对象不是关系的关系服务处理）

异常

IllegalArgumentException如果空参数

hasRelation

public Boolean hasRelation(String relationId)
                    throws IllegalArgumentException

检查是否有关系服务中确定的关系与给定的关系。

Specified by:

hasRelation 接口 RelationServiceMBean

参数

relationId关系ID识别的关系

结果

布尔：真的如果有一个关系，其他的

异常

IllegalArgumentException如果空参数

getAllRelationIds

public List<String> getAllRelationIds()

返回关系服务处理的所有关系的所有关系标识。

Specified by:

getAllRelationIds 接口 RelationServiceMBean

结果

数组的字符串

checkRoleReading

public Integer checkRoleReading(String roleName,
                                String relationTypeName)
                         throws IllegalArgumentException,
                                RelationTypeNotFoundException

检查给定的角色是否可以在给定类型的关系中读取。

Specified by:

checkRoleReading 接口 RelationServiceMBean

参数

roleName名角色进行检查

relationTypeName -关系型的名字

结果

一个整数包装对应的可能的问题表示为常数roleunresolved整数：

- 0如果角色可以阅读

- rolestatus.no_role_with_name相应的整数

- rolestatus.role_not_readable相应的整数

异常

IllegalArgumentException如果空参数

RelationTypeNotFoundException如果关系类型不在关系服务

checkRoleWriting

public Integer checkRoleWriting(Role role,
                                String relationTypeName,
                                Boolean initFlag)
                         throws IllegalArgumentException,
                                RelationTypeNotFoundException

检查给定的角色是否可以设置在给定类型的关系中。

Specified by:

checkRoleWriting 接口 RelationServiceMBean

参数

role角色进行检查

relationTypeName -关系型的名字

initFlag旗指定的检测是一个角色的初始化完成，不得进行写访问。

结果

一个整数包装对应的可能的问题表示为常数roleunresolved整数：

- 0如果角色可以设置

- rolestatus.no_role_with_name相应的整数

整数为rolestatus.role_not_writable

整数为rolestatus.less_than_min_role_degree

整数为rolestatus.more_than_max_role_degree

整数为rolestatus.ref_mbean_of_incorrect_class

整数为rolestatus.ref_mbean_not_registered

异常

IllegalArgumentException如果空参数

RelationTypeNotFoundException如果未知的关系式

sendRelationCreationNotification

public void sendRelationCreationNotification(String relationId)
                                      throws IllegalArgumentException,
                                             RelationNotFoundException

发送通知（relationnotification）有关系的创造。通知类型是：

- relationnotification.relation_basic_creation如果关系是对象内部的关系服务

- relationnotification.relation_mbean_creation如果关系是MBean作为一个关系。

源对象是关系服务本身。

这是关系服务createrelation()和addrelation()方法称为。

Specified by:

sendRelationCreationNotification 接口 RelationServiceMBean

参数

relationId关系标识更新的关系

异常

IllegalArgumentException如果空参数

如果没有关系 RelationNotFoundException给定ID有关系

sendRoleUpdateNotification

public void sendRoleUpdateNotification(String relationId,
                                       Role newRole,
                                       List<ObjectName> oldValue)
                                throws IllegalArgumentException,
                                       RelationNotFoundException

发送通知（relationnotification）在给定关系的角色更新。通知类型是：

- relationnotification.relation_basic_update如果关系是对象内部的关系服务

- relationnotification.relation_mbean_update如果关系是MBean作为一个关系。

源对象是关系服务本身。

它关系setrole()（对于给定的角色叫MBean）和setroles()（每个角色）方法（在relationsupport类提供实现）。

也正是在关系服务setrole()叫（对于给定的角色）和setroles()（每个角色）的方法。

Specified by:

sendRoleUpdateNotification 接口 RelationServiceMBean

参数

relationId关系标识更新的关系

newRole -新的角色（名字和新价值）

oldValue岁的角色值（对象的对象列表）

异常

IllegalArgumentException如果空参数

如果没有关系 RelationNotFoundException给定ID有关系

sendRelationRemovalNotification

public void sendRelationRemovalNotification(String relationId,
                                            List<ObjectName> unregMBeanList)
                                     throws IllegalArgumentException,
                                            RelationNotFoundException

发送通知（relationnotification）一个关系的去除。通知类型是：

- relationnotification.relation_basic_removal如果关系是对象内部的关系服务

- relationnotification.relation_mbean_removal如果关系是MBean作为一个关系。

源对象是关系服务本身。

这是关系服务removerelation()方法称为。

Specified by:

sendRelationRemovalNotification 接口 RelationServiceMBean

参数

relationId关系标识更新的关系

unregMBeanList表的objectnames MBean将注册由于关系去除（可以为空）

异常

IllegalArgumentException如果空参数

如果没有关系 RelationNotFoundException给定ID有关系

updateRoleMap

public void updateRoleMap(String relationId,
                          Role newRole,
                          List<ObjectName> oldValue)
                   throws IllegalArgumentException,
                          RelationServiceNotRegisteredException,
                          RelationNotFoundException

处理给定关系中给定角色的关系服务角色映射的更新。

它关系setrole()（对于给定的角色叫MBean）和setroles()（每个角色）方法（在relationsupport类提供实现）。

也正是在关系服务setrole()叫（对于给定的角色）和setroles()（每个角色）的方法。

让关系服务保持一致性（MBean注销的情况下），可以执行查询，方法必须调用当角色更新。

Specified by:

updateRoleMap 接口 RelationServiceMBean

参数

relationId关系标识更新的关系

newRole -新的角色（名字和新价值）

oldValue岁的角色值（对象的对象列表）

异常

IllegalArgumentException如果空参数

RelationServiceNotRegisteredException如果关系服务不在MBean服务器注册

如果没有关系 RelationNotFoundException id。

removeRelation

public void removeRelation(String relationId)
                    throws RelationServiceNotRegisteredException,
                           IllegalArgumentException,
                           RelationNotFoundException

从关系服务中移除给定的关系。

一个relationnotification发送通知，其类型：

- relationnotification.relation_basic_removal如果关系是内部关系服务

- relationnotification.relation_mbean_removal如果关系是注册MBean。

在这种关系中引用MBeans，什么也不会做，

Specified by:

removeRelation 接口 RelationServiceMBean

参数

relationId -被删除ID的关系

异常

RelationServiceNotRegisteredException如果关系服务不在MBean服务器注册

IllegalArgumentException如果空参数

RelationNotFoundException -如果没有关系对应于给定的关系ID

purgeRelations

public void purgeRelations()
                    throws RelationServiceNotRegisteredException

清洗的关系。

根据purgeflag值，这种方法称为自动通知时MBean的关系中引用的注销（如果标志设置为true），或（如果标志设置为false）。

在这种情况下，它是由用户调用它来保持关系的一致性。要记住，如果是未注册的MBean和清除不马上做，如果对象是重复使用和分配给另一个MBean关系中的引用，调用手动purgerelations()方法会引起麻烦，会考虑对象对应于未注册的MBean，没有看到新的一。

行为取决于基数的作用在未注册的MBean引用：

如果除去一个MBean的参考作用使其引用低于最低度数，关系已被删除。

如果剩余的引用数去除MBean参考后仍然是在基数的范围内，保持联系和更新，称其handlembeanunregistration()回调。

Specified by:

purgeRelations 接口 RelationServiceMBean

异常

RelationServiceNotRegisteredException如果关系服务不在MBean服务器注册。

findReferencingRelations

public Map<String,List<String>> findReferencingRelations(ObjectName mbeanName,
                                                         String relationTypeName,
                                                         String roleName)
                                                  throws IllegalArgumentException

检索的关系在一个给定的MBean参考。

这对应于CIM“参考文献”和“referencenames”行动。

Specified by:

findReferencingRelations 接口 RelationServiceMBean

参数

mbeanName - ObjectName of MBean

relationTypeName -可以为空；如果规定，只有该类型将在搜索考虑的关系。其他所有的关系类型都被考虑。

roleName -可以为空；如果规定，只有关系的MBean是这个角色将返回引用。其他所有的角色都被考虑。

结果

一个HashMap，按键位置的关系的关系，IDS MBean是引用，和值，每个关键，角色名称ArrayList（如MBean可以参考的几个角色在同一关系）。

异常

IllegalArgumentException如果空参数

findAssociatedMBeans

public Map<ObjectName,List<String>> findAssociatedMBeans(ObjectName mbeanName,
                                                         String relationTypeName,
                                                         String roleName)
                                                  throws IllegalArgumentException

检索给定一个MBean相关关系。

这相当于CIM会员和associatornames操作。

Specified by:

findAssociatedMBeans 接口 RelationServiceMBean

参数

mbeanName - ObjectName of MBean

relationTypeName -可以为空；如果规定，只有该类型将在搜索考虑的关系。其他所有的关系类型都被考虑。

roleName -可以为空；如果规定，只有关系的MBean是这个角色将被引用。其他所有的角色都被考虑。

结果

一个HashMap，其中的关键是要给出相关的objectnames MBean的MBean，和值，每个关键，ArrayList的关系的关系，ID MBean的关键是与给定的一个（他们可以在几种不同的关系有关）。

异常

IllegalArgumentException如果空参数

findRelationsOfType

public List<String> findRelationsOfType(String relationTypeName)
                                 throws IllegalArgumentException,
                                        RelationTypeNotFoundException

返回给定类型关系的关系标识。

Specified by:

findRelationsOfType 接口 RelationServiceMBean

参数

relationTypeName关系类型名称

结果

关系ID ArrayList。

异常

IllegalArgumentException如果空参数

RelationTypeNotFoundException -如果没有叫这个名字的关系式。

getRole

public List<ObjectName> getRole(String relationId,
                                String roleName)
                         throws RelationServiceNotRegisteredException,
                                IllegalArgumentException,
                                RelationNotFoundException,
                                RoleNotFoundException

检索给定角色名在给定关系中的角色值。

Specified by:

getRole 接口 RelationServiceMBean

参数

relationId关系ID

roleName名字的角色

结果

的对象的对象的角色值的数组

异常

RelationServiceNotRegisteredException如果关系服务没有注册

IllegalArgumentException如果空参数

RelationNotFoundException如果给定ID没有关系

RoleNotFoundException如果：

-有没有角色与给定的名称

或

-角色是不可读的。

另请参见：

setRole(java.lang.String, javax.management.relation.Role)

getRoles

public RoleResult getRoles(String relationId,
                           String[] roleNameArray)
                    throws RelationServiceNotRegisteredException,
                           IllegalArgumentException,
                           RelationNotFoundException

在给定关系中检索给定名称的角色的值。

Specified by:

getRoles 接口 RelationServiceMBean

参数

relationId关系ID

roleNameArray -要获取名称角色阵列

结果

一个roleresult对象，包括rolelist（角色成功检索）和roleunresolvedlist（角色不检索）。

异常

RelationServiceNotRegisteredException如果关系服务不在MBean服务器注册

IllegalArgumentException如果空参数

RelationNotFoundException如果给定ID没有关系

另请参见：

setRoles(java.lang.String, javax.management.relation.RoleList)

getAllRoles

public RoleResult getAllRoles(String relationId)
                       throws IllegalArgumentException,
                              RelationNotFoundException,
                              RelationServiceNotRegisteredException

返回当前在关系中的所有角色。

Specified by:

getAllRoles 接口 RelationServiceMBean

参数

relationId关系ID

结果

一个roleresult对象，包括rolelist（角色成功检索）和roleunresolvedlist（角色不可读）。

异常

IllegalArgumentException如果空参数

如果没有关系 RelationNotFoundException给定ID

RelationServiceNotRegisteredException如果关系服务不在MBean服务器注册

getRoleCardinality

public Integer getRoleCardinality(String relationId,
                                  String roleName)
                           throws IllegalArgumentException,
                                  RelationNotFoundException,
                                  RoleNotFoundException

检索当前引用MBean给定角色的数量。

Specified by:

getRoleCardinality 接口 RelationServiceMBean

参数

relationId关系ID

roleName名字的角色

结果

一些目前引用MBeans这个角色

异常

IllegalArgumentException如果空参数

RelationNotFoundException如果给定ID没有关系

RoleNotFoundException -如果名字没有作用

setRole

public void setRole(String relationId,
                    Role role)
             throws RelationServiceNotRegisteredException,
                    IllegalArgumentException,
                    RelationNotFoundException,
                    RoleNotFoundException,
                    InvalidRoleValueException

设置给定关系中的给定角色。

将根据其在关系类型中所提供的相应角色定义来检查角色

关系服务将跟踪变化的处理引用的MBean撤销登记保持关系的一致性。

Specified by:

setRole 接口 RelationServiceMBean

参数

relationId关系ID

role角色被设置（名称和新价值）

异常

RelationServiceNotRegisteredException如果关系服务不在MBean服务器注册

IllegalArgumentException如果空参数

RelationNotFoundException如果给定ID没有关系

RoleNotFoundException -如果角色不存在或不可写

InvalidRoleValueException -如果提供的角色值无效：

-引用MBeans给定值的数量少于预期的最低程度

或

-提供价值参考MBeans最大程度超过预期的数量

或

一个引用MBean的价值不在于MBean类预期，作用对象

或

对于这个角色不存在提供MBean

另请参见：

getRole(java.lang.String, java.lang.String)

setRoles

public RoleResult setRoles(String relationId,
                           RoleList roleList)
                    throws RelationServiceNotRegisteredException,
                           IllegalArgumentException,
                           RelationNotFoundException

设置给定关系中的给定角色。

将根据其在关系类型中所提供的相应角色定义来检查角色

关系服务跟踪处理引用的MBean撤销登记保持一致的变化关系。

Specified by:

setRoles 接口 RelationServiceMBean

参数

relationId关系ID

roleList -角色设定

结果

一个roleresult对象，包括rolelist（角色设置成功）和roleunresolvedlist（角色设置）。

异常

RelationServiceNotRegisteredException如果关系服务不在MBean服务器注册

IllegalArgumentException如果空参数

RelationNotFoundException如果给定ID没有关系

另请参见：

getRoles(java.lang.String, java.lang.String[])

getReferencedMBeans

public Map<ObjectName,List<String>> getReferencedMBeans(String relationId)
                                                 throws IllegalArgumentException,
                                                        RelationNotFoundException

检索关系的各种角色引用MBeans。

Specified by:

getReferencedMBeans 接口 RelationServiceMBean

参数

relationId关系ID

结果

一个HashMap映射：

ArrayList对象->字符串（角色名称）

异常

IllegalArgumentException如果空参数

如果没有关系 RelationNotFoundException给定关系ID

getRelationTypeName

public String getRelationTypeName(String relationId)
                           throws IllegalArgumentException,
                                  RelationNotFoundException

给定关系的关联关系类型的返回名称。

Specified by:

getRelationTypeName 接口 RelationServiceMBean

参数

relationId关系ID

结果

关联关系类型的名称。

异常

IllegalArgumentException如果空参数

如果没有关系 RelationNotFoundException给定关系ID

handleNotification

public void handleNotification(Notification notif,
                               Object handback)

当调用一个JMX通知发生。目前处理通知取消注册MBean，要么引用关系中的角色或是一种关系本身。

Specified by:

handleNotification 接口 NotificationListener

参数

notif -通知。

handback -一个不透明的物体使听者联想到有关MBean emitter（可以为空）。

getNotificationInfo

public MBeanNotificationInfo[] getNotificationInfo()

返回一个包含该通知和通知类型的java类的名称notificationinfo对象发送。

Specified by:

getNotificationInfo 接口 NotificationBroadcaster

重写：

getNotificationInfo 方法重写，继承类 NotificationBroadcasterSupport

结果

可能通知的数组。