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

另请参见：

序列化表格

构造方法摘要

protected	RelationTypeSupport(String theRelTypeName) 用于子类的构造方法。
	RelationTypeSupport(String theRelTypeName, RoleInfo[] theRoleInfoArray) 所有角色定义在其中动态创建并作为参数传递的构造方法。

方法摘要

protected void	addRoleInfo(RoleInfo theRoleInfo) 添加角色信息。
String	getRelationTypeName() 返回关系类型名称。
RoleInfo	getRoleInfo(String theRoleInfoName) 返回给定角色信息名称的角色信息（RoleInfo 对象）（如果找不到，则返回 null）。
List	getRoleInfos() 返回角色定义的列表（RoleInfo 对象的 ArrayList）。

从类 java.lang.Object 继承的方法

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

构造方法详细信息

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 - 如果在当前具有同一名称的关系类型中已经存在角色信息。