Module java.management
Package javax.management.relation

Class RoleInfo

java.lang.Object
javax.management.relation.RoleInfo
所有已实现的接口:
Serializable
public class RoleInfo extends Object implements Serializable
RoleInfo对象总结了关系类型中的一个角色。

这个类的serialVersionUID是2504952983494636987L。

自JDK版本:
1.5
参见:

  • Field Details

    • ROLE_CARDINALITY_INFINITY

      public static final int ROLE_CARDINALITY_INFINITY
      用于指定无限基数。
      参见:

  • Constructor Details

    • RoleInfo

      public RoleInfo(String roleName, String mbeanClassName, boolean read, boolean write, int min, int max, String descr) throws IllegalArgumentException, InvalidRoleInfoException, ClassNotFoundException, NotCompliantMBeanException
      构造函数。
      参数:
      roleName - 角色的名称。
      mbeanClassName - 期望在相应角色中引用的MBean类的名称。如果一个MBean M在这个角色中，那么MBean服务器必须对isInstanceOf(M, mbeanClassName)返回true。
      read - 表示相应角色是否可读的标志
      write - 表示相应角色是否可设置的标志
      min - 角色的最小度数，即在相应角色中提供的MBean的最小数量必须小于或等于max。（无限制为ROLE_CARDINALITY_INFINITY）
      max - 角色的最大度数，即在相应角色中提供的MBean的最大数量必须大于或等于min（无限制为ROLE_CARDINALITY_INFINITY）
      descr - 角色的描述（可以为null）
      抛出:
      IllegalArgumentException - 如果参数为null
      InvalidRoleInfoException - 如果最小度数大于最大度数。
      ClassNotFoundException - 从JMX 1.2开始，不再会抛出此异常。为了与现有代码兼容，保留在此类的声明中。
      NotCompliantMBeanException - 如果类mbeanClassName不是MBean类。

    • RoleInfo

      public RoleInfo(String roleName, String mbeanClassName, boolean read, boolean write) throws IllegalArgumentException, ClassNotFoundException, NotCompliantMBeanException
      构造函数。
      参数:
      roleName - 角色的名称
      mbeanClassName - 期望在相应角色中引用的MBean类的名称。如果一个MBean M在这个角色中，那么MBean服务器必须对isInstanceOf(M, mbeanClassName)返回true。
      read - 表示相应角色是否可读的标志
      write - 表示相应角色是否可设置的标志

      最小和最大度数默认为1。

      角色描述默认为null。

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

    • RoleInfo

      public RoleInfo(String roleName, String mbeanClassName) throws IllegalArgumentException, ClassNotFoundException, NotCompliantMBeanException
      构造函数。
      参数:
      roleName - 角色的名称
      mbeanClassName - 期望在相应角色中引用的MBean类的名称。如果一个MBean M在这个角色中，那么MBean服务器必须对isInstanceOf(M, mbeanClassName)返回true。
      read - 表示相应角色是否可读的标志
      write - 表示相应角色是否可设置的标志

      IsReadable和IsWritable默认为true。

      最小和最大度数默认为1。

      角色描述默认为null。

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

    • RoleInfo

      public RoleInfo(RoleInfo roleInfo) throws IllegalArgumentException
      复制构造函数。
      参数:
      roleInfo - 要复制的RoleInfo实例。
      抛出:
      IllegalArgumentException - 如果参数为null

  • Method Details

    • 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 value)
      如果value参数大于或等于预期的最小度数，则返回true，否则返回false。
      参数:
      value - 要检查的值
      返回:
      大于或等于最小度数则返回true，否则返回false。

    • checkMaxDegree

      public boolean checkMaxDegree(int value)
      如果value参数低于或等于预期的最大度数，则返回true，否则返回false。
      参数:
      value - 要检查的值
      返回:
      低于或等于最大度数则返回true，否则返回false。

    • toString

      public String toString()
      返回描述角色信息的字符串。
      覆盖:
      toString 在类 Object
      返回:
      角色信息的描述。