javax.management.relation

接口
异常
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 中的关系类型。

此类的 serialVersionUID4611072955724144607L

从以下版本开始:
1.5
另请参见:
序列化表格

构造方法摘要
protected RelationTypeSupport(String relationTypeName)
          用于子类的构造方法。
  RelationTypeSupport(String relationTypeName, RoleInfo[] roleInfoArray)
          所有角色定义在其中动态创建并作为参数传递的构造方法。
 
方法摘要
protected  void addRoleInfo(RoleInfo roleInfo)
          添加角色信息。
 String getRelationTypeName()
          返回关系类型名称。
 RoleInfo getRoleInfo(String roleInfoName)
          返回给定角色信息名称的角色信息(RoleInfo 对象)(如果找不到,则返回 null)。
 List<RoleInfo> getRoleInfos()
          返回角色定义的列表(RoleInfo 对象的 ArrayList)。
 
从类 java.lang.Object 继承的方法
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

构造方法详细信息

RelationTypeSupport

public RelationTypeSupport(String relationTypeName,
                           RoleInfo[] roleInfoArray)
                    throws IllegalArgumentException,
                           InvalidRelationTypeException
所有角色定义在其中动态创建并作为参数传递的构造方法。

参数:
relationTypeName - 关系类型的名称
roleInfoArray - 角色定义(RoleInfo 对象)的列表
抛出:
IllegalArgumentException - 如果是 null 参数
InvalidRelationTypeException - 如果:

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

- 未提供角色信息

- 提供了一个 null 角色信息


RelationTypeSupport

protected RelationTypeSupport(String relationTypeName)
用于子类的构造方法。

参数:
relationTypeName - 关系类型的名称。
抛出:
IllegalArgumentException - 如果是 null 参数。
方法详细信息

getRelationTypeName

public String getRelationTypeName()
返回关系类型名称。

指定者:
接口 RelationType 中的 getRelationTypeName
返回:
关系类型名称。

getRoleInfos

public List<RoleInfo> getRoleInfos()
返回角色定义的列表(RoleInfo 对象的 ArrayList)。

指定者:
接口 RelationType 中的 getRoleInfos
返回:
RoleInfoArrayList

getRoleInfo

public RoleInfo getRoleInfo(String roleInfoName)
                     throws IllegalArgumentException,
                            RoleInfoNotFoundException
返回给定角色信息名称的角色信息(RoleInfo 对象)(如果找不到,则返回 null)。

指定者:
接口 RelationType 中的 getRoleInfo
参数:
roleInfoName - 角色信息名称
返回:
如果提供角色定义的对象不存在,则返回 RoleInfo 对象
抛出:
IllegalArgumentException - 如果是 null 参数
RoleInfoNotFoundException - 如果在关系类型中没有带该名称的角色信息。

addRoleInfo

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

参数:
roleInfo - 要添加的角色信息。
抛出:
IllegalArgumentException - 如果是 null 参数。
InvalidRelationTypeException - 如果在当前具有同一名称的关系类型中已经存在角色信息。