Java javax.management.relation 类 RelationTypeSupport（JDK5）

所有类

javax.management.relation
类 RelationTypeSupport

java.lang.Object
  javax.management.relation.RelationTypeSupport

所有已实现的接口：

Serializable, RelationType

public class RelationTypeSupport
   
   
   
   
   
extends Object
   
   
   
   
   
   
   
   
   
   
implements RelationType
   
   
   
   
   

RelationTypeSupport 对象实现 RelationType 接口。

它表示一个关系类型，提供期望在该类型的每个关系中受支持的各角色的角色实现。

关系类型包括关系类型名称和角色信息（由 RoleInfo 对象表示）的列表。

关系类型必须在 Relation Service（关系服务）中声明：

- 可以使用 createRelationType() 方法，在此情况下，将在 Relation Service 中创建和保存 RelationTypeSupport 对象

- 也可以使用 addRelationType() 方法，在此情况下，用户必须创建一个实现 RelationType 接口的对象，并将此对象用于表示 Relation Service 中的关系类型。

从以下版本开始：

1.5

另请参见：

序列化表格

RelationTypeSupport

public RelationTypeSupport(String theRelTypeName,
                           RoleInfo[] theRoleInfoArray)
                    throws IllegalArgumentException,
                           InvalidRelationTypeException

所有角色定义在其中动态创建并作为参数传递的构造方法。

参数：

theRelTypeName - 关系类型的名称

theRoleInfoArray - 角色定义（RoleInfo 对象）的列表

抛出：

IllegalArgumentException - 如果是 null 参数

InvalidRelationTypeException - 如果：

- 两个不同的角色用了同一个名称

- 未提供角色信息

- 提供了一个 null 角色信息

RelationTypeSupport

protected RelationTypeSupport(String theRelTypeName)

用于子类的构造方法。

参数：

theRelTypeName - 关系类型的名称。

抛出：

IllegalArgumentException - 如果是 null 参数。

getRelationTypeName

public String getRelationTypeName()

返回关系类型名称。

指定者：

接口 RelationType 中的 getRelationTypeName

返回：

关系类型名称。

getRoleInfos

public List getRoleInfos()

返回角色定义的列表（RoleInfo 对象的 ArrayList）。

指定者：

接口 RelationType 中的 getRoleInfos

返回：

RoleInfo 的 ArrayList。

getRoleInfo

public RoleInfo getRoleInfo(String theRoleInfoName)
                     throws IllegalArgumentException,
                            RoleInfoNotFoundException

返回给定角色信息名称的角色信息（RoleInfo 对象）（如果找不到，则返回 null）。

指定者：

接口 RelationType 中的 getRoleInfo

参数：

theRoleInfoName - 角色信息名称

返回：

如果提供角色定义的对象不存在，则返回 RoleInfo 对象

抛出：

IllegalArgumentException - 如果是 null 参数

RoleInfoNotFoundException - 如果在关系类型中没有带该名称的角色信息。

addRoleInfo

protected void addRoleInfo(RoleInfo theRoleInfo)
                    throws IllegalArgumentException,
                           InvalidRelationTypeException

添加角色信息。创建关系类型后当然不应使用此方法，因为更新这种关系类型将无效，已创建的与该类型关联的关系仍然遵循这种关系类型。如果试图更新在 Relation Service 中声明的关系类型，则可能抛出 RuntimeException。

参数：

theRoleInfo - 要添加的角色信息。

抛出：

IllegalArgumentException - 如果是 null 参数。

InvalidRelationTypeException - 如果在当前具有同一名称的关系类型中已经存在角色信息。