compact3

javax.management.relation

Interface RelationServiceMBean

所有已知实现类：

RelationService

public interface RelationServiceMBean

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

从以下版本开始：

一点五

方法摘要

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) 返回当前在关系中的所有角色。
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) 在给定关系中检索给定名称的角色的值。
Boolean	hasRelation(String relationId) 检查是否有关系服务中确定的关系与给定的关系。
void	isActive() 检查关系服务是否是活动的。
String	isRelation(ObjectName objectName) 返回与给定的对象如果MBean已添加在关系服务关系ID。
ObjectName	isRelationMBean(String relationId) 如果关系是通过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> 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) 处理给定关系中给定角色的关系服务角色映射的更新。

方法详细信息

isActive

void isActive()
       throws RelationServiceNotRegisteredException

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

异常

RelationServiceNotRegisteredException -如果不是注册

getPurgeFlag

boolean getPurgeFlag()

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

真是立即清除。

结果

如果立即清除。

另请参见：

setPurgeFlag(boolean)

setPurgeFlag

void setPurgeFlag(boolean purgeFlag)

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

真是立即清除。

参数

purgeFlag旗

另请参见：

getPurgeFlag()

createRelationType

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

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

参数

relationTypeName -关系型的名字

roleInfoArray -角色信息的数组

异常

IllegalArgumentException如果空参数

InvalidRelationTypeException如果：

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

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

-没有提供任何角色信息

提供一个空的角色信息

addRelationType

void addRelationType(RelationType relationTypeObj)
              throws IllegalArgumentException,
                     InvalidRelationTypeException

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

参数

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

异常

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

InvalidRelationTypeException -如果已经存在一个同名的关系式

getAllRelationTypeNames

List<String> getAllRelationTypeNames()

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

结果

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

getRoleInfos

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

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

参数

relationTypeName -关系型的名字

结果

ArrayList的roleinfo。

异常

IllegalArgumentException如果空参数

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

getRoleInfo

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

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

参数

relationTypeName -关系型的名字

roleInfoName名字的角色

结果

roleinfo对象。

异常

IllegalArgumentException如果空参数

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

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

removeRelationType

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

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

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

参数

relationTypeName -关系型被删除的名字

异常

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

IllegalArgumentException如果空参数

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

createRelation

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

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

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

一个relationnotification，relation_basic_creation型，发送。

参数

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

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

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

异常

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

IllegalArgumentException如果空参数

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

InvalidRelationIdException如果关系ID已使用

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

InvalidRoleValueException如果：

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

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

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

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

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

addRelation

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

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

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

-实现关系接口

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

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

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

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

参数

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

ObjectName isRelationMBean(String relationId)
                    throws IllegalArgumentException,
                           RelationNotFoundException

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

参数

relationId关系ID识别的关系

结果

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

异常

IllegalArgumentException如果空参数

RelationNotFoundException -没有ID关联

isRelation

String isRelation(ObjectName objectName)
           throws IllegalArgumentException

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

参数

objectName -所谓的关系ObjectName

结果

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

异常

IllegalArgumentException如果空参数

hasRelation

Boolean hasRelation(String relationId)
             throws IllegalArgumentException

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

参数

relationId关系ID识别的关系

结果

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

异常

IllegalArgumentException如果空参数

getAllRelationIds

List<String> getAllRelationIds()

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

结果

数组的字符串

checkRoleReading

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

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

参数

roleName名角色进行检查

relationTypeName -关系型的名字

结果

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

- 0如果角色可以阅读

- rolestatus.no_role_with_name相应的整数

- rolestatus.role_not_readable相应的整数

异常

IllegalArgumentException如果空参数

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

checkRoleWriting

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

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

参数

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

void sendRelationCreationNotification(String relationId)
                               throws IllegalArgumentException,
                                      RelationNotFoundException

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

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

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

源对象是关系服务本身。

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

参数

relationId关系标识更新的关系

异常

IllegalArgumentException如果空参数

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

sendRoleUpdateNotification

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

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

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

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

源对象是关系服务本身。

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

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

参数

relationId关系标识更新的关系

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

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

异常

IllegalArgumentException如果空参数

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

sendRelationRemovalNotification

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

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

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

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

源对象是关系服务本身。

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

参数

relationId关系标识更新的关系

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

异常

IllegalArgumentException如果空参数

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

updateRoleMap

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

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

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

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

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

参数

relationId关系标识更新的关系

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

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

异常

IllegalArgumentException如果空参数

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

如果没有关系 RelationNotFoundException id。

removeRelation

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

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

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

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

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

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

参数

relationId -被删除ID的关系

异常

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

IllegalArgumentException如果空参数

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

purgeRelations

void purgeRelations()
             throws RelationServiceNotRegisteredException

清洗的关系。

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

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

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

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

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

异常

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

findReferencingRelations

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

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

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

参数

mbeanName - ObjectName of MBean

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

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

结果

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

异常

IllegalArgumentException如果空参数

findAssociatedMBeans

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

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

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

参数

mbeanName - ObjectName of MBean

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

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

结果

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

异常

IllegalArgumentException如果空参数

findRelationsOfType

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

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

参数

relationTypeName关系类型名称

结果

关系ID ArrayList。

异常

IllegalArgumentException如果空参数

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

getRole

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

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

参数

relationId关系ID

roleName名字的角色

结果

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

异常

RelationServiceNotRegisteredException如果关系服务没有注册

IllegalArgumentException如果空参数

RelationNotFoundException如果给定ID没有关系

RoleNotFoundException如果：

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

或

-角色是不可读的。

另请参见：

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

getRoles

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

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

参数

relationId关系ID

roleNameArray -要获取名称角色阵列

结果

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

异常

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

IllegalArgumentException如果空参数

RelationNotFoundException如果给定ID没有关系

另请参见：

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

getAllRoles

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

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

参数

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名字的角色

结果

一些目前引用MBeans这个角色

异常

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如果内部关系和价值提供了角色无效：

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

或

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

或

一个引用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映射：

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

异常

IllegalArgumentException如果空参数

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

getRelationTypeName

String getRelationTypeName(String relationId)
                    throws IllegalArgumentException,
                           RelationNotFoundException

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

参数

relationId关系ID

结果

关联关系类型的名称。

异常

IllegalArgumentException如果空参数

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