Package javax.management.relation

提供关系服务的定义。

See: 描述

接口摘要

接口	描述
Relation	此接口已被任何MBean类将代表一个关系管理服务实现使用的关系。
RelationServiceMBean	关系服务负责创建和删除关系类型和关系，处理一致性和提供查询机制。
RelationSupportMBean	一个relationsupport对象内部使用的关系服务代表简单的关系（只有角色，没有属性或方法），随着角色数量不限，任何关系式。
RelationType	的relationtype接口已经被任何类代表一个关系类型实现的预期。

类摘要

类	描述
MBeanServerNotificationFilter	滤波器的 MBeanServerNotification。
RelationNotification	关系服务变更的通知。
RelationService	关系服务负责创建和删除关系类型和关系，处理一致性和提供查询机制。
RelationSupport	一个relationsupport对象内部使用的关系服务代表简单的关系（只有角色，没有属性或方法），随着角色数量不限，任何关系式。
RelationTypeSupport	一个relationtypesupport对象实现relationtype接口。
Role	代表角色：包括角色名称和引用MBeans（通过他们的objectnames）。
RoleInfo	一个roleinfo对象总结出关系型的作用。
RoleList	一个rolelist代表名单的角色（作用对象）。
RoleResult	表示多个访问关系的几个角色的结果（无论是阅读还是写作）。
RoleStatus	这个类描述了访问角色时遇到的各种问题。
RoleUnresolved	表示未解决的角色：由于问题的关系而无法检索的角色。
RoleUnresolvedList	一个roleunresolvedlist代表名单roleunresolved对象代表的角色，不从关系由于遇到的一个问题时，试图访问（读或写）的作用。

异常摘要

异常	描述
InvalidRelationIdException	当为关系提供的关系标识已被使用时，引发此异常。
InvalidRelationServiceException	当提供了一个无效的关系服务时，引发此异常。
InvalidRelationTypeException	无效关系类型。
InvalidRoleInfoException	此异常被提出时，在一个角色信息，其最小程度大于其最大程度。
InvalidRoleValueException	角色值无效。
RelationException	这类的任何异常可在关系管理提出了父类。
RelationNotFoundException	当关系服务中的给定关系标识没有关系时，引发此异常。
RelationServiceNotRegisteredException	当对关系服务进行访问时，和未注册的关系服务时，将引发此异常。
RelationTypeNotFoundException	当在关系服务中没有给定名称的关系类型时，引发此异常。
RoleInfoNotFoundException	这个异常是在一个给定的关系类型中没有给定名称的角色信息时引发的。
RoleNotFoundException	该异常时引发的关系中的作用是不存在的，或是不可读的，或是不可。

Package javax.management.relation Description

提供关系服务的定义。关系服务是用来在MBean服务器记录关系MBeans。关系本身是一个MBean服务。一个RelationService MBean的多个实例可以在一个MBean服务器注册。

一个关系类型之间的关系定义MBean。它包含在关系中发挥作用的MBeans。通常在一个关系类型中至少有两个角色。

一个关系是一个关系型的命名实例，具体哪里MBeans出现的角色，他们的ObjectNames代表。

例如，假设有Module MBeans，代表一个应用程序中的模块。一个DependsOn关系式可以表达一些模块依赖于他人的关系，这可以被用来确定该模块启动或停止命令。的DependsOn关系类型有两个角色，dependent和dependedOn。

每一个角色都是类型化的，这意味着一个MBean出现在这个角色必须是角色的类型的一个实例。在DependsOn例子，两者的角色将Module型。

每个角色都有一个基数，提供上下对MBeans可以出现在一个给定的关系实例的作用的数量界限。通常，下限和上限都是1，只有一个MBean中出现的角色。基数只限制在每个关系实例的作用不但数量。同样的MBean可以出现在任何数量的关系的类型的实例相同的作用。在DependsOn的例子，一个给定的模块可以取决于许多其他模块，可以依靠许多人，但是任何关系实例的链接一个dependent模块只有一个dependedOn模块。

一个关系式可以显式创建，作为贯彻RelationType接口的对象，通常是一个RelationTypeSupport。或者，它可以隐式地使用关系服务的createRelationType方法创建。

一个关系的实例可以显式创建，作为贯彻Relation接口的对象，通常是一个RelationSupport。（一RelationSupport本身是一种有效的MBean，所以它可以注册在MBean服务器，尽管这不是必需的。）另外，关系实例可以隐式使用关系服务的createRelation方法创建。

DependsOn的例子可能是编码如下。

导入java。利用*；进口javax.管理*；进口javax.管理。关系*；/ /…MBeanServer MBS =…；//创建关系服务管理对象relsvcname =新的对象（”：类型= relationservice”）；relationservice relsvcobject =新relationservice（真的）；住房抵押贷款证券化。registermbean（relsvcobject，relsvcname）；//创建更容易进入关系的MBean的代理服务relationservicembean relsvc =MBeanServerInvocationHandler。代理实例（MBS，relsvcname，RelationServiceMBean.class，假）；//定义取决于关系型roleinfo [ ] dependsonroles = {新的roleinfo（“依赖”，模块，类。getname()），新的roleinfo（“依靠”，模块，类。getname()）}；relsvc。createRelationType（“靠”，dependsonroles）；//现在定义一个关系实例”模块，取决于moduleb”对象模块=新的对象（”：类型=模块名称=“）；对象moduleb =新的对象（”：类型=模块名称= B”）；作用依赖=新的角色（“依赖”，集合。singletonlist（模块））；作用机制=新的角色（“依靠”，集合。singletonlist（moduleb））；作用[ ] rolearray = {依赖，依靠}；rolelist角色=新rolelist（阵列。asList（rolearray））；relsvc。createrelation（“a-dependson-b”、“取决于”角色）；/ /查询服务模块、关系到什么取决于图
 
     
     
     
   
     
   <对象，列表<字符串>
    
      
    
      
      
      
   > dependentamap =relsvc。findassociatedmbeans（、、“依赖”，“依赖”）；集
  
      
      
      
    
      
    <对象>
      dependentaset = dependentamap。keyset()；/ /组对象包含moduleb 
    
 
     
     
     
   
     
   

从以下版本开始：

1.5

另请参见：

Java Platform documentation on JMX technology, in particular the JMX Specification, version 1.4