Module java.management

Package javax.management.relation

Interface RelationServiceMBean

所有已知的实现类:

RelationService

       public interface RelationServiceMBean
      

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

自:

1.5

Method Summary

Modifier and Type	Method	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)	使用给定的角色信息（由RoleInfo对象提供）创建关系类型（RelationTypeSupport对象），并将其添加到关系服务中。
Map<ObjectName,List<String>>	findAssociatedMBeans(ObjectName mbeanName, String relationTypeName, String roleName)	检索与给定关系中的MBean相关联的MBeans。
Map<String,List<String>>	findReferencingRelations(ObjectName mbeanName, String relationTypeName, String roleName)	检索引用给定MBean的关系。
List<String>	findRelationsOfType(String relationTypeName)	返回给定类型的关系的关系ID。
List<String>	getAllRelationIds()	返回由关系服务处理的所有关系的所有关系ID。
List<String>	getAllRelationTypeNames()	检索所有已知关系类型的名称。
RoleResult	getAllRoles(String relationId)	返回关系中存在的所有角色。
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)	检索当前在给定角色中引用的MBeans的数量。
RoleInfo	getRoleInfo(String relationTypeName, String roleInfoName)	检索给定关系类型中给定角色的角色信息。
List<RoleInfo>	getRoleInfos(String relationTypeName)	检索给定关系类型的角色信息列表（RoleInfo对象）。
RoleResult	getRoles(String relationId, String[] roleNameArray)	检索给定关系中具有给定名称的角色的值。
Boolean	hasRelation(String relationId)	检查关系服务中是否有一个以给定关系ID标识的关系。
void	isActive()	检查关系服务是否处于活动状态。
String	isRelation(ObjectName objectName)	如果MBean已添加为关系服务中的关系，则返回与给定ObjectName关联的关系ID。
ObjectName	isRelationMBean(String relationId)	如果关系由一个MBean表示（由用户创建并添加为关系服务中的关系），则返回MBean的ObjectName。
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> oldRoleValue)	发送给定关系中角色更新的通知（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> oldRoleValue)	处理给定关系中给定角色的更新的关系服务角色映射。

Method Details

isActive

             void isActive() throws RelationServiceNotRegisteredException
            

检查关系服务是否处于活动状态。当前条件是关系服务必须在MBean服务器中注册。

抛出:

RelationServiceNotRegisteredException - 如果未注册

getPurgeFlag

             boolean getPurgeFlag()
            

返回一个标志，指示是否在接收到关系中引用的MBean取消注册的通知时，是否需要立即执行关系的“清除”（查找不再有效的关系），或者仅在显式调用purgeRelations方法时才执行。

true表示立即清除。

返回:

如果立即清除则为true。

参见:

• setPurgeFlag(boolean)

setPurgeFlag

             void setPurgeFlag(boolean purgeFlag)
            

设置一个标志，指示是否在接收到关系中引用的MBean取消注册的通知时，是否需要立即执行关系的“清除”（查找不再有效的关系），或者仅在显式调用purgeRelations方法时才执行。

true表示立即清除。

参数:

purgeFlag - 标志

参见:

• getPurgeFlag()

createRelationType

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

使用给定的角色信息（由RoleInfo对象提供）创建关系类型（RelationTypeSupport对象），并将其添加到关系服务中。

参数:

relationTypeName - 关系类型的名称

roleInfoArray - 角色信息数组

抛出:

IllegalArgumentException - 如果参数为null

InvalidRelationTypeException - 如果:

- 已经存在具有该名称的关系类型

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

- 未提供角色信息

- 提供了一个空的角色信息

addRelationType

             void addRelationType(RelationType relationTypeObj) throws IllegalArgumentException, InvalidRelationTypeException
            

将给定对象添加为关系类型。预期该对象实现RelationType接口。

参数:

relationTypeObj - 关系类型对象（实现RelationType接口）

抛出:

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

InvalidRelationTypeException - 如果已经存在具有该名称的关系类型

getAllRelationTypeNames

             List<String> getAllRelationTypeNames()
            

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

返回:

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

getRoleInfos

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

检索给定关系类型的角色信息列表（RoleInfo对象）。

参数:

relationTypeName - 关系类型的名称

返回:

RoleInfo的ArrayList。

抛出:

IllegalArgumentException - 如果参数为null

RelationTypeNotFoundException - 如果没有具有该名称的关系类型。

getRoleInfo

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

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

参数:

relationTypeName - 关系类型的名称

roleInfoName - 角色的名称

返回:

RoleInfo对象。

抛出:

IllegalArgumentException - 如果参数为null

RelationTypeNotFoundException - 如果关系类型在关系服务中未知

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

removeRelationType

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

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

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

参数:

relationTypeName - 要删除的关系类型的名称

抛出:

RelationServiceNotRegisteredException - 如果关系服务未在MBean服务器中注册

IllegalArgumentException - 如果参数为null

RelationTypeNotFoundException - 如果没有具有该名称的关系类型

createRelation

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

创建给定关系类型的简单关系（由RelationSupport对象表示），并将其添加到关系服务中。

根据参数中提供的角色列表初始化角色。未以此方式初始化的角色将设置为空的ObjectName ArrayList。

将发送一个类型为RELATION_BASIC_CREATION的RelationNotification。

参数:

relationId - 关系标识符，用于在关系服务内唯一标识关系

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

roleList - 用于初始化关系角色的角色列表（可以为null）

抛出:

RelationServiceNotRegisteredException - 如果关系服务未在MBean服务器中注册

IllegalArgumentException - 如果参数为null

RoleNotFoundException - 如果为关系类型中不存在的角色提供了值

InvalidRelationIdException - 如果关系id已被使用

RelationTypeNotFoundException - 如果关系类型在关系服务中未知

InvalidRoleValueException - 如果:

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

- 在给定值中引用的MBean数量少于预期的最小度数

- 在提供的值中引用的MBean数量超过了预期的最大度数

- 值中的一个引用的MBean不是该角色期望的MBean类的对象

- 为该角色提供的MBean不存在

addRelation

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

将用户创建的MBean（并由用户在MBean服务器中注册）作为关系添加到关系服务中。

要作为关系添加，MBean必须符合以下条件:

- 实现Relation接口

- 具有当前关系服务的ObjectName作为RelationService ObjectName

- 具有唯一且未在当前关系服务中使用的关系id

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

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

参数:

relationObjectName - 要添加的关系MBean的ObjectName

抛出:

IllegalArgumentException - 如果参数为null

RelationServiceNotRegisteredException - 如果关系服务未在MBean服务器中注册

NoSuchMethodException - 如果MBean未实现Relation接口

InvalidRelationIdException - 如果:

- MBean中没有关系标识符

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

InstanceNotFoundException - 如果给定ObjectName的MBean尚未注册

InvalidRelationServiceException - 如果:

- MBean中没有关系服务名称

- MBean中的关系服务名称与当前关系服务的名称不同

RelationTypeNotFoundException - 如果:

- MBean中没有关系类型名称

- MBean中的关系类型名称与在关系服务中创建的关系类型不对应

InvalidRoleValueException - 如果:

- 在角色中引用的MBean数量少于预期的最小度数

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

- 值中的一个引用的MBean不是该角色期望的MBean类的对象

- 为角色提供的MBean不存在

RoleNotFoundException - 如果为关系类型中不存在的角色提供了值

isRelationMBean

             ObjectName isRelationMBean(String relationId) throws IllegalArgumentException, RelationNotFoundException
            

如果关系由MBean表示（由用户创建并作为关系添加到关系服务中），则返回MBean的ObjectName。

参数:

relationId - 标识关系的关系id

返回:

对应关系MBean的ObjectName，如果关系不是MBean则返回null

抛出:

IllegalArgumentException - 如果参数为null

RelationNotFoundException - 如果没有与该id关联的关系

isRelation

             String isRelation(ObjectName objectName) throws IllegalArgumentException
            

如果已将MBean添加为关系到关系服务中，则返回与给定ObjectName关联的关系id。

参数:

objectName - 所假定的关系的ObjectName

返回:

关系id（String）或null（如果ObjectName不是关系服务处理的关系）

抛出:

IllegalArgumentException - 如果参数为null

hasRelation

             Boolean hasRelation(String relationId) throws IllegalArgumentException
            

检查关系服务中是否存在具有给定关系id的关系。

参数:

relationId - 标识关系的关系id

返回:

布尔值: 如果存在关系则为true，否则为false

抛出:

IllegalArgumentException - 如果参数为null

getAllRelationIds

             List<String> getAllRelationIds()
            

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

返回:

String的ArrayList

checkRoleReading

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

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

参数:

roleName - 要检查的角色名称

relationTypeName - 关系类型的名称

返回:

包装整数的Integer，对应于RoleUnresolved中表示的可能问题的整数:

- 如果可以读取角色则为0

- 对应于RoleStatus.NO_ROLE_WITH_NAME的整数

- 对应于RoleStatus.ROLE_NOT_READABLE的整数

抛出:

IllegalArgumentException - 如果参数为null

RelationTypeNotFoundException - 如果关系类型在关系服务中未知

checkRoleWriting

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

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

参数:

role - 要检查的角色

relationTypeName - 关系类型的名称

initFlag - 用于指定检查是否用于角色的初始化，不应验证写访问权限

返回:

包装整数的Integer，对应于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 - 如果参数为null

RelationTypeNotFoundException - 如果未知关系类型

sendRelationCreationNotification

             void sendRelationCreationNotification(String relationId) throws IllegalArgumentException, RelationNotFoundException
            

发送关系创建的通知（RelationNotification）。通知类型为:

- 如果关系是关系服务内部对象，则为RelationNotification.RELATION_BASIC_CREATION

- 如果关系是作为关系添加的MBean，则为RelationNotification.RELATION_MBEAN_CREATION

源对象是关系服务本身。

在Relation Service的createRelation()和addRelation()方法中调用。

参数:

relationId - 更新的关系的关系标识符

抛出:

IllegalArgumentException - 如果参数为null

RelationNotFoundException - 如果没有与给定关系id关联的关系

sendRoleUpdateNotification

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

发送给定关系中角色更新的通知（RelationNotification）。通知类型为:

- 如果关系是关系服务内部对象，则为RelationNotification.RELATION_BASIC_UPDATE

- 如果关系是作为关系添加的MBean，则为RelationNotification.RELATION_MBEAN_UPDATE

源对象是关系服务本身。

在关系MBean的setRole()（对于给定角色）和setRoles()（对于每个角色）方法中调用（在RelationSupport类中提供实现）。

也在Relation Service的setRole()（对于给定角色）和setRoles()（对于每个角色）方法中调用。

参数:

relationId - 更新关系的关系标识符

newRole - 新角色（名称和新值）

oldRoleValue - 旧角色值（ObjectName对象列表）

抛出:

IllegalArgumentException - 如果参数为空

RelationNotFoundException - 如果给定关系id没有关系

sendRelationRemovalNotification

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

发送关系移除的通知（RelationNotification）。通知类型为：

- 如果关系是关系服务内部对象，则为RelationNotification.RELATION_BASIC_REMOVAL

- 如果关系是作为关系添加的MBean，则为RelationNotification.RELATION_MBEAN_REMOVAL

源对象是关系服务本身。

在Relation Service的removeRelation()方法中调用。

参数:

relationId - 更新关系的关系标识符

unregMBeanList - 预期由于关系移除而注销的MBean的ObjectName列表（可以为null）

抛出:

IllegalArgumentException - 如果参数为空

RelationNotFoundException - 如果给定关系id没有关系

updateRoleMap

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

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

在关系MBean的setRole()（对于给定角色）和setRoles()（对于每个角色）方法中调用（在RelationSupport类中提供实现）。

还在Relation Service的setRole()（对于给定角色）和setRoles()（对于每个角色）方法中调用。

为了允许关系服务维护一致性（在MBean注销的情况下）并能够执行查询，当更新角色时必须调用此方法。

参数:

relationId - 更新关系的关系标识符

newRole - 新角色（名称和新值）

oldRoleValue - 旧角色值（ObjectName对象列表）

抛出:

IllegalArgumentException - 如果参数为空

RelationServiceNotRegisteredException - 如果关系服务未在MBean服务器中注册

RelationNotFoundException - 如果给定id没有关系

removeRelation

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

从关系服务中删除给定关系。

将发送一个RelationNotification通知，其类型为：

- 如果关系仅为关系服务内部，则为RelationNotification.RELATION_BASIC_REMOVAL

- 如果关系注册为MBean，则为RelationNotification.RELATION_MBEAN_REMOVAL

对于在此类关系中引用的MBean，不会执行任何操作。

参数:

relationId - 要移除的关系的关系id

抛出:

RelationServiceNotRegisteredException - 如果关系服务未在MBean服务器中注册

IllegalArgumentException - 如果参数为空

RelationNotFoundException - 如果没有与给定关系id对应的关系

purgeRelations

             void purgeRelations() throws RelationServiceNotRegisteredException
            

清除关系。

根据purgeFlag值的不同，当接收到关系中引用的MBean注销的通知时，此方法将自动调用（如果标志设置为true），或者不调用（如果标志设置为false）。

在这种情况下，用户需要手动调用此方法以保持关系的一致性。需要记住，如果一个MBean被注销并且未立即进行清除，如果ObjectName被重用并分配给另一个在关系中引用的MBean，手动调用此purgeRelations()方法将会导致问题，因为它将ObjectName视为对应于已注销的MBean，而不是看到新的MBean。

行为取决于引用了未注册MBean的角色的基数：

- 如果在角色中移除一个MBean引用使其引用数少于最小度数，则必须移除关系。

- 如果移除MBean引用后剩余的引用数仍在基数范围内，则保留关系并调用其handleMBeanUnregistration()回调进行更新。

抛出:

RelationServiceNotRegisteredException - 如果关系服务未在MBean服务器中注册。

findReferencingRelations

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

检索引用给定MBean的关系。

这对应于CIM的“References”和“ReferenceNames”操作。

Parameters:

mbeanName - ObjectName of MBean

relationTypeName - can be null; if specified, only the relations of that type will be considered in the search. Else all relation types are considered.

roleName - can be null; if specified, only the relations where the MBean is referenced in that role will be returned. Else all roles are considered.

Returns:

an HashMap, where the keys are the relation ids of the relations where the MBean is referenced, and the value is, for each key, an ArrayList of role names (as an MBean can be referenced in several roles in the same relation).

Throws:

IllegalArgumentException - if null parameter

findAssociatedMBeans

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

Retrieves the MBeans associated to given one in a relation.

This corresponds to CIM Associators and AssociatorNames operations.

Parameters:

mbeanName - ObjectName of MBean

relationTypeName - can be null; if specified, only the relations of that type will be considered in the search. Else all relation types are considered.

roleName - can be null; if specified, only the relations where the MBean is referenced in that role will be considered. Else all roles are considered.

Returns:

an HashMap, where the keys are the ObjectNames of the MBeans associated to given MBean, and the value is, for each key, an ArrayList of the relation ids of the relations where the key MBean is associated to given one (as they can be associated in several different relations).

Throws:

IllegalArgumentException - if null parameter

findRelationsOfType

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

Returns the relation ids for relations of the given type.

Parameters:

relationTypeName - relation type name

Returns:

an ArrayList of relation ids.

Throws:

IllegalArgumentException - if null parameter

RelationTypeNotFoundException - if there is no relation type with that name.

getRole

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

Retrieves role value for given role name in given relation.

Parameters:

relationId - relation id

roleName - name of role

Returns:

the ArrayList of ObjectName objects being the role value

Throws:

RelationServiceNotRegisteredException - if the Relation Service is not registered

IllegalArgumentException - if null parameter

RelationNotFoundException - if no relation with given id

RoleNotFoundException - if:

- there is no role with given name

or

- the role is not readable.

See Also:

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

getRoles

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

Retrieves values of roles with given names in given relation.

Parameters:

relationId - relation id

roleNameArray - array of names of roles to be retrieved

Returns:

a RoleResult object, including a RoleList (for roles successfully retrieved) and a RoleUnresolvedList (for roles not retrieved).

Throws:

RelationServiceNotRegisteredException - if the Relation Service is not registered in the MBean Server

IllegalArgumentException - if null parameter

RelationNotFoundException - if no relation with given id

See Also:

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

getAllRoles

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

Returns all roles present in the relation.

参数:

relationId - 关系id

返回:

一个RoleResult对象，包括一个RoleList（成功检索的角色）和一个RoleUnresolvedList（无法读取的角色）。

抛出:

IllegalArgumentException - 如果参数为空

RelationNotFoundException - 如果给定id没有关系

RelationServiceNotRegisteredException - 如果关系服务未在MBean服务器中注册

getRoleCardinality

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

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

参数:

relationId - 关系id

roleName - 角色名称

返回:

该角色中当前引用的MBean数量

抛出:

IllegalArgumentException - 如果参数为空

RelationNotFoundException - 如果给定id没有关系

RoleNotFoundException - 如果没有给定名称的角色

setRole

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

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

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

关系服务将跟踪更改，通过处理引用的MBean注销来保持关系的一致性。

参数:

relationId - 关系id

role - 要设置的角色（名称和新值）

抛出:

RelationServiceNotRegisteredException - 如果关系服务未在MBean服务器中注册

IllegalArgumentException - 如果参数为空

RelationNotFoundException - 如果给定id没有关系

RoleNotFoundException - 如果：

- 内部关系

和

- 角色不存在或不可写

InvalidRoleValueException - 如果内部关系且为角色提供的值无效：

- 给定值中引用的MBean数量少于预期的最小度

或

- 提供的值中引用的MBean数量超过预期的最大度

或

- 值中的一个引用的MBean不是该角色所期望的MBean类的对象

或

- 为该角色提供的MBean不存在

RelationTypeNotFoundException - 如果关系类型未知

参见:

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

setRoles

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

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

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

关系服务将跟踪更改，通过处理引用的MBean注销来保持关系的一致性。

参数:

relationId - 关系id

roleList - 要设置的角色列表

返回:

一个RoleResult对象，包括一个RoleList（成功设置的角色）和一个RoleUnresolvedList（未设置的角色）。

抛出:

RelationServiceNotRegisteredException - 如果关系服务未在MBean服务器中注册

IllegalArgumentException - 如果参数为空

RelationNotFoundException - 如果给定id没有关系

参见:

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

getReferencedMBeans

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

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

参数:

relationId - 关系id

返回:

一个HashMap映射：

ObjectName -> String数组列表（角色名称）

抛出:

IllegalArgumentException - 如果参数为空

RelationNotFoundException - 如果给定关系id没有关系

getRelationTypeName

             String getRelationTypeName(String relationId) throws IllegalArgumentException, RelationNotFoundException
            

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

参数:

relationId - 关系id

返回:

关联关系类型的名称。

抛出:

IllegalArgumentException - 如果参数为空

RelationNotFoundException - 如果给定关系id没有关系