JavaTM 2 Platform
Standard Ed. 5.0

javax.management.relation
类 RoleInfo

java.lang.Object
  继承者 javax.management.relation.RoleInfo
所有已实现的接口:
Serializable

public class RoleInfo
extends Object
implements Serializable

RoleInfo 概括介绍关系类型中的角色。

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

字段摘要
static int ROLE_CARDINALITY_INFINITY
          指定无限的容量。
 
构造方法摘要
RoleInfo(RoleInfo theRoleInfo)
          复制构造方法。
RoleInfo(String theName, String theRefMBeanClassName)
          构造方法。
RoleInfo(String theName, String theRefMBeanClassName, boolean theIsReadable, boolean theIsWritable)
          构造方法。
RoleInfo(String theName, String theRefMBeanClassName, boolean theIsReadable, boolean theIsWritable, int theMinDegree, int theMaxDegree, String theDescription)
          构造方法。
 
方法摘要
 boolean checkMaxDegree(int theValue)
          返回一个 boolean 值,以指定给定的值是否小于或等于期望的最大程度(如果是,则返回 true)。
 boolean checkMinDegree(int theValue)
          返回一个 boolean 值,以指定给定的值是否大于或等于期望的最小程度(如果是,则返回 true)。
 String getDescription()
          返回角色的描述文本。
 int getMaxDegree()
          返回相应角色引用的最大程度。
 int getMinDegree()
          返回相应角色引用的最小程度。
 String getName()
          返回角色名称。
 String getRefMBeanClassName()
          返回期望在相应角色中引用的 MBean 的类型名称。
 boolean isReadable()
          返回角色的读取访问模式(如果可读,则返回 true)。
 boolean isWritable()
          返回角色的写入访问模式(如果可写,则返回 true)。
 String toString()
          返回描述角色信息的字符串。
 
从类 java.lang.Object 继承的方法
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

字段详细信息

ROLE_CARDINALITY_INFINITY

public static int ROLE_CARDINALITY_INFINITY
指定无限的容量。

构造方法详细信息

RoleInfo

public RoleInfo(String theName,
                String theRefMBeanClassName,
                boolean theIsReadable,
                boolean theIsWritable,
                int theMinDegree,
                int theMaxDegree,
                String theDescription)
         throws IllegalArgumentException,
                InvalidRoleInfoException,
                ClassNotFoundException,
                NotCompliantMBeanException
构造方法。

参数:
theName - 角色的名称。
theRefMBeanClassName - 期望在相应角色中引用的 MBean 的类名称。如果 MBean M 在此角色中,则对于 isInstanceOf(M, theRefMBeanClassName),MBean 服务器必须返回 true。
theIsReadable - 指示相应角色是否可读的标志
theIsWritable - 指示相应角色是否可设置的标志
theMinDegree - 角色的最小程度,即要在相应角色提供的 MBean 的最小数必须小于或等于 theMaxDegree。(ROLE_CARDINALITY_INFINITY 不受限制)
theMaxDegree - 角色的最大程度,即要在相应角色中提供的 MBean 的最大数必须大于或等于 theMinDegree(ROLE_CARDINALITY_INFINITY 不受限制)
theDescription - 角色的描述(可以为 null)
抛出:
IllegalArgumentException - 如果是 null 参数
InvalidRoleInfoException - 如果最小程度大于最大程度。
ClassNotFoundException - 从 JMX 1.2 开始,不再抛出此异常。它将保留在此类的声明中,以与现有代码兼容。
NotCompliantMBeanException - 如果类 theRefMBeanClassName 不是 MBean 类。

RoleInfo

public RoleInfo(String theName,
                String theRefMBeanClassName,
                boolean theIsReadable,
                boolean theIsWritable)
         throws IllegalArgumentException,
                ClassNotFoundException,
                NotCompliantMBeanException
构造方法。

参数:
theName - 角色的名称
theRefMBeanClassName - 期望在相应角色中引用的 MBean 的类名称。如果 MBean M 在此角色中,则对于 isInstanceOf(M, theRefMBeanClassName),MBean 服务器必须返回 true。
theIsReadable - 指示相应角色是否可读的标志
theIsWritable - 指示相应角色是否可设置的标志

默认为 1 的最小和最大程度。

默认为 null 的角色描述。

抛出:
IllegalArgumentException - 如果是 null 参数
ClassNotFoundException - 从 JMX 1.2 开始,不再抛出此异常。它将保留在此类的声明中,以与现有代码兼容。
NotCompliantMBeanException - 从 JMX 1.2 开始,不再抛出此异常。它将保留在此类的声明中,以与现有代码兼容。

RoleInfo

public RoleInfo(String theName,
                String theRefMBeanClassName)
         throws IllegalArgumentException,
                ClassNotFoundException,
                NotCompliantMBeanException
构造方法。

参数:
theName - 角色的名称
theRefMBeanClassName - 期望在相应角色中引用的 MBean 的类名称。如果 MBean M 在此角色中,则对于 isInstanceOf(M, theRefMBeanClassName),MBean 服务器必须返回 true。

默认为 true 的 IsReadable 和 IsWritable。

默认为 1 的最小和最大程度。

默认为 null 的角色描述。

抛出:
IllegalArgumentException - 如果是 null 参数
ClassNotFoundException - 从 JMX 1.2 开始,不再抛出此异常。它将保留在此类的声明中,以与现有代码兼容。
NotCompliantMBeanException - 从 JMX 1.2 开始,不再抛出此异常。它将保留在此类的声明中,以与现有代码兼容。

RoleInfo

public RoleInfo(RoleInfo theRoleInfo)
         throws IllegalArgumentException
复制构造方法。

参数:
theRoleInfo - 要复制的 RoleInfo。
抛出:
IllegalArgumentException - 如果是 null 参数
方法详细信息

getName

public String getName()
返回角色名称。

返回:
角色名称。

isReadable

public boolean isReadable()
返回角色的读取访问模式(如果可读,则返回 true)。

返回:
如果角色可读,则返回 true

isWritable

public boolean isWritable()
返回角色的写入访问模式(如果可写,则返回 true)。

返回:
如果角色可写,则返回 true。

getDescription

public String getDescription()
返回角色的描述文本。

返回:
角色的描述。

getMinDegree

public int getMinDegree()
返回相应角色引用的最小程度。

返回:
最小程度。

getMaxDegree

public int getMaxDegree()
返回相应角色引用的最大程度。

返回:
最大程度。

getRefMBeanClassName

public String getRefMBeanClassName()

返回期望在相应角色中引用的 MBean 的类型名称。

返回:
引用的类型名称。

checkMinDegree

public boolean checkMinDegree(int theValue)
返回一个 boolean 值,以指定给定的值是否大于或等于期望的最小程度(如果是,则返回 true)。

参数:
theValue - 值
返回:
如果大于或等于最小程度,则返回 true;否则,返回 false。

checkMaxDegree

public boolean checkMaxDegree(int theValue)
返回一个 boolean 值,以指定给定的值是否小于或等于期望的最大程度(如果是,则返回 true)。

参数:
theValue - 值
返回:
如果小于或等于最大程度,则返回 true;否则,返回 false。

toString

public String toString()
返回描述角色信息的字符串。

覆盖:
Object 中的 toString
返回:
角色信息的描述。

JavaTM 2 Platform
Standard Ed. 5.0

提交错误或意见
有关更多的 API 参考资料和开发人员文档,请参阅 Java 2 SDK SE 开发人员文档。该文档包含更详细的、面向开发人员的描述,以及总体概述、术语定义、使用技巧和工作代码示例。

版权所有 2004 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策