软件包 javax.management.relation 的描述
提供 Relation Service 的定义。Relation Service 用于记录 MBean Server 中各个 MBean 之间的关系。Relation Service 本身就是一个 MBean。在一个 MBean Server 中可以注册多个 RelationService MBean 的实例。
关系类型 定义各个 MBean 之间的关系。它包含各个 MBean 在关系中充当的角色。通常，在一个关系类型中至少有两个角色。
关系 是关系类型的命名实例，其中具体的 MBean 将出现在由其 ObjectName 表示的角色中。
例如，假定存在 Module MBean，其表示应用程序内的模块。DependsOn 关系类型可以表达一些模块依赖于其他模块（这些模块可以用于定义模块开始和停止的顺序）的关系。DependsOn 关系类型应有两个角色，dependent 和 dependedOn。
每个角色都经过了类型化，意味着在该角色中出现的 MBean 必须是该角色类型的实例。在 DependsOn 示例中，两个角色都属于类型 Module。
每个角色都有一个容量，它在给定关系实例的这一角色中出现的 MBean 数提供上下边界。通常，上下边界都是 1，这样可保证在此角色中只出现一个 MBean。该容量只限制每个关系实例的角色中的 MBean 数。同一个 MBean 可以在任意数量的关系类型实例中的同一个角色中出现。在 DependsOn 示例中，给定模块可能依赖于许多其他模块，也可以被许多其他模块所依赖，但是任何给定关系实例都只能将一个 dependent 模块与唯一对应的那个 dependedOn 模块连接。
关系类型可以作为实现 RelationType 接口的对象显式地创建，此对象通常为 RelationTypeSupport。或者，它可以使用 Relation Service 的 createRelationType 方法隐式地创建。
关系类型可以作为实现 Relation 接口的对象显式地创建，此对象通常是为 RelationSupport。（RelationSupport 本身是一个有效的 MBean，因此它可以在 MBean Server 中注册，但不要求这样做。）或者，关系类型可以使用 Relation Service 的 createRelation 方法隐式地创建。
DependsOn 示例可以按以下方式编码。
import java.util.*;
import javax.management.*;
import javax.management.relation.*;
// ...
MBeanServer mbs = ...;
// Create the Relation Service MBean
ObjectName relSvcName = new ObjectName(":type=RelationService");
RelationService relSvcObject = new RelationService(true);
mbs.registerMBean(relSvcObject, relSvcName);
// Create an MBean proxy for easier access to the Relation Service
RelationServiceMBean relSvc = (RelationServiceMBean)
MBeanServerInvocationHandler.newProxyInstance(mbs, relSvcName,
RelationServiceMBean.class,
false);
// Define the DependsOn relation type
RoleInfo[] dependsOnRoles = {
new RoleInfo("dependent", Module.class.getName()),
new RoleInfo("dependedOn", Module.class.getName())
};
relSvc.createRelationType("DependsOn", dependsOnRoles);
// Now define a relation instance "moduleA DependsOn moduleB"
ObjectName moduleA = new ObjectName(":type=Module,name=A");
ObjectName moduleB = new ObjectName(":type=Module,name=B");
Role dependent = new Role("dependent", Collections.singletonList(moduleA));
Role dependedOn = new Role("dependedOn", Collections.singletonList(moduleB));
Role[] roleArray = {dependent, dependedOn};
RoleList roles = new RoleList(Arrays.asList(roleArray));
relSvc.createRelation("A-DependsOn-B", "DependsOn", roles);
// Query the Relation Service to find what modules moduleA depends on
Map dependentAMap = relSvc.findAssociatedMBeans(moduleA, "DependsOn", "dependent");
Set dependentASet = dependentAMap.keySet();
// Set of ObjectName containing moduleB
包规范
Specification of the JMX API, version 1.2 (Chapter 11, Relation Service)
从以下版本开始：
1.5
