javax.management.relation
类 RelationService

java.lang.Object
  javax.management.NotificationBroadcasterSupport
      javax.management.relation.RelationService

所有已实现的接口：

EventListener, MBeanRegistration, NotificationBroadcaster, NotificationEmitter, NotificationListener, RelationServiceMBean

public class RelationService
     

      extends 
      NotificationBroadcasterSupport
     
     

      implements 
      RelationServiceMBean, 
      MBeanRegistration, 
      NotificationListener
     

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

它通过扩展 NotificationBroadcasterSupport 实现 NotificationBroadcaster，以便在从中移除关系时发送通知。

它实现 NotificationListener 接口，以便能够接收有关注销关系角色中引用的 MBean 的通知以及注销关系 MBean 的通知。

它实现 MBeanRegistration 接口，以便能够检索其 ObjectName 和 MBean Server。

从以下版本开始：

1.5

RelationService

public RelationService(boolean immediatePurgeFlag)

构造方法。

参数：

immediatePurgeFlag - 指示何时接收注销关系中引用的 MBean 的通知，指示是否必须执行关系的直接“肃清”（查找不再有效的关系），或者是否只在显式调用 purgeRelations 方法时执行该操作。

true 表示立即肃清。

isActive

public void isActive()
              throws RelationServiceNotRegisteredException

检查该 Relation Service 是否处于活动状态。当前的条件是，Relation Service 必须在 MBean Server 中注册。

指定者：

接口 RelationServiceMBean 中的 isActive

抛出：

RelationServiceNotRegisteredException - 如果未注册 Relation Service

preRegister

public ObjectName preRegister(MBeanServer server,
                              ObjectName name)
                       throws Exception

从接口 MBeanRegistration 复制的描述

允许 MBean 在被注册到 MBean 服务器之前执行它所需要的任何操作。如果未指定 MBean 的名称，则该 MBean 可以提供一个注册名称。如果引发任何异常，则该 MBean 不会被注册到 MBean 服务器中。

指定者：

接口 MBeanRegistration 中的 preRegister

参数：

server - 将要在其中注册该 MBean 的 MBean 服务器。

name - 该 MBean 的对象名。如果 MBeanServer 接口中的某个 createMBean 方法或 registerMBean 方法的 name 参数为 null，则此 name 也为 null。在这种情况下，此方法必须为新 MBean 返回非 null 的 ObjectName。

返回：

MBean 要被注册的名称。此值必须不为 null。如果 name 参数不为 null，则它通常但并非一定为返回值。

抛出：

Exception - MBean 服务器会捕捉此异常并以 MBeanRegistrationException 的形式重新抛出。

postRegister

public void postRegister(Boolean registrationDone)

从接口 MBeanRegistration 复制的描述

允许 MBean 在被注册到 MBean 服务器或注销失败后执行任何所需要的操作。

指定者：

接口 MBeanRegistration 中的 postRegister

参数：

registrationDone - 指示该 MBean 是否已在 MBean 服务器中成功注册。false 值意味着注册阶段已失败。

preDeregister

public void preDeregister()
                   throws Exception

从接口 MBeanRegistration 复制的描述

允许该 MBean 在从 MBean 服务器注销之前执行它所需要的任何操作。

指定者：

接口 MBeanRegistration 中的 preDeregister

抛出：

Exception - MBean 服务器会捕捉此异常并以 MBeanRegistrationException 的形式重新抛出。

postDeregister

public void postDeregister()

从接口 MBeanRegistration 复制的描述

允许 MBean 在已从 MBean 服务器注销之后执行所需要的任何操作。

指定者：

接口 MBeanRegistration 中的 postDeregister

getPurgeFlag

public boolean getPurgeFlag()

返回一个标志，以指示何时接收注销关系中引用的 MBean 的通知，指示是否必须执行关系的直接“肃清”（查找不再有效的关系），或者是否只在将显式调用 purgeRelations 方法时执行该操作。

true 表示立即肃清。

指定者：

接口 RelationServiceMBean 中的 getPurgeFlag

返回：

如果肃清是自动进行的，则返回 true。

另请参见：

setPurgeFlag(boolean)

setPurgeFlag

public void setPurgeFlag(boolean purgeFlag)

设置一个标志，以指示注销关系中引用的 MBean 时是否接收通知，是否必须执行关系的直接“肃清”（查找不再有效的关系），或者是否只在显式调用 purgeRelations 方法时执行该操作。

true 表示立即肃清。

指定者：

接口 RelationServiceMBean 中的 setPurgeFlag

参数：

purgeFlag - 标志

另请参见：

getPurgeFlag()

createRelationType

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

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

指定者：

接口 RelationServiceMBean 中的 createRelationType

参数：

relationTypeName - 关系类型的名称

roleInfoArray - 角色信息的数组

抛出：

IllegalArgumentException - 如果参数为 null

InvalidRelationTypeException - 如果：

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

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

- 未提供角色信息

- 提供了一个 null 角色信息

addRelationType

public void addRelationType(RelationType relationTypeObj)
                     throws IllegalArgumentException,
                            InvalidRelationTypeException

作为关系类型添加给定的对象。该对象期望实现 RelationType 接口。

指定者：

接口 RelationServiceMBean 中的 addRelationType

参数：

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

抛出：

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

InvalidRelationTypeException - 如果：

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

- 未提供角色信息

- 提供了一个 null 角色信息

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

getAllRelationTypeNames

public List<String> getAllRelationTypeNames()

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

指定者：

接口 RelationServiceMBean 中的 getAllRelationTypeNames

返回：

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

getRoleInfos

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

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

指定者：

接口 RelationServiceMBean 中的 getRoleInfos

参数：

relationTypeName - 关系类型的名称

返回：

RoleInfo 的 ArrayList。

抛出：

IllegalArgumentException - 如果参数为 null

RelationTypeNotFoundException - 如果不存在具有该名称的关系类型。

getRoleInfo

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

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

指定者：

接口 RelationServiceMBean 中的 getRoleInfo

参数：

relationTypeName - 关系类型的名称

roleInfoName - 角色的名称

返回：

RoleInfo 对象。

抛出：

IllegalArgumentException - 如果参数为 null

RelationTypeNotFoundException - 如果在 Relation Service 中的关系类型未知

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

removeRelationType

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

从 Relation Service 中移除给定的关系类型。

此类型的关系对象将要从 Relation Service 中移除。

指定者：

接口 RelationServiceMBean 中的 removeRelationType

参数：

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

抛出：

RelationServiceNotRegisteredException - 如果该 Relation Service 未在 MBean Server 中注册

IllegalArgumentException - 如果参数为 null

RelationTypeNotFoundException - 如果不存在具有该名称的关系类型

createRelation

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

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

按照在参数中提供的角色列表初始化角色。将未按此方法初始化的角色设置为 ObjectName 的空 ArrayList。

发送类型为 RELATION_BASIC_CREATION 的 RelationNotification。

指定者：

接口 RelationServiceMBean 中的 createRelation

参数：

relationId - 关系标识符，用来唯一地标识 Relation Service 中的关系

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

roleList - 要初始化该关系的角色的角色列表（可以为 null）。

抛出：

RelationServiceNotRegisteredException - 如果 Relation Service 未在 MBean Server 中注册

IllegalArgumentException - 如果参数为 null（角色列表除外，它在未进行角色初始化时可以为 null）

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

InvalidRelationIdException - 如果关系 id 已经使用

RelationTypeNotFoundException - 如果在 Relation Service 中关系类型未知

InvalidRoleValueException - 如果：

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

- 给定值中引用的 MBean 数小于期望的最小程度

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

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

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

addRelation

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

作为 Relation Service 中的关系添加由用户创建（且由其在 MBean Server 中注册）的 MBean。

将作为关系