javax.management
类 MBeanAttributeInfo

java.lang.Object
  javax.management.MBeanFeatureInfo
      javax.management.MBeanAttributeInfo

所有已实现的接口：

Serializable, Cloneable, DescriptorRead

直接已知子类：

ModelMBeanAttributeInfo, OpenMBeanAttributeInfoSupport

public class MBeanAttributeInfo
extends MBeanFeatureInfo
implements Cloneable

描述出于管理目的而公开的 MBean 属性。此类的实例是不可变的。子类可以是可变的，但是不推荐使用此功能。

从以下版本开始：

1.5

另请参见：

序列化表格

MBeanAttributeInfo

public MBeanAttributeInfo(String name,
                          String type,
                          String description,
                          boolean isReadable,
                          boolean isWritable,
                          boolean isIs)

构造一个 MBeanAttributeInfo 对象。

参数：

name - 属性的名称。

type - 属性的类型或类名。

description - 该属性的可读描述。

isReadable - 如果该属性具有获取方法，则为 True；否则为 false。

isWritable - 如果该属性具有设置方法，则为 True；否则为 false。

isIs - 如果该属性具有 "is" 获取方法，则为 True；否则为 false。

抛出：

IllegalArgumentException - 如果 isIs 为 true 而 isReadable 不为 true，或者 isIs 为 true 且 type 不为 boolean 或 java.lang.Boolean。（新代码始终使用 boolean 而不是 java.lang.Boolean。）

MBeanAttributeInfo

public MBeanAttributeInfo(String name,
                          String type,
                          String description,
                          boolean isReadable,
                          boolean isWritable,
                          boolean isIs,
                          Descriptor descriptor)

构造一个 MBeanAttributeInfo 对象。

参数：

name - 属性的名称。

type - 属性的类型或类名。

description - 属性的可读描述。

isReadable - True 如果该属性有获取方法，则此参数为 true，否则为 false。

isWritable - True 如果该属性有设置方法，则此参数为 true，否则为 false。

isIs - True 如果该属性有一个 "is" 获取方法，则此参数为 True；否则为 false。

descriptor - 属性的描述符。此参数可以为 null，它等效于一个空描述符。

抛出：

IllegalArgumentException - 如果 isIs 为 true 而 isReadable 不为 true，或者 isIs 为 true 且 type 不为 boolean 或 java.lang.Boolean。（新代码始终使用 boolean 而不是使用 java.lang.Boolean。）

从以下版本开始：

1.6

MBeanAttributeInfo

public MBeanAttributeInfo(String name,
                          String description,
                          Method getter,
                          Method setter)
                   throws IntrospectionException

此构造方法带有简单属性的名称，以及读取和写入属性的 Method 对象。已构造对象的 Descriptor 包括 Method 对象（包含 DescriptorKey 元注释）生成的字段。

参数：

name - 属性的编程名称。

description - 该属性的可读描述。

getter - 用于读取属性值的方法。如果该属性是只写的，则可以为 null。

setter - 用于写入属性值的方法。如果该属性是只读的，则可以为 null。

抛出：

IntrospectionException - 如果在此属性的定义中存在一致性问题。

clone

public Object clone()

返回此实例的浅表副本。可通过调用 super.clone() 来获得该副本，因此要调用 Object.clone() 所实现的默认本机浅表复制机制。不进行任何内部字段的更深层复制。

因为此类是不可变的，所以主要对子类进行复制。

覆盖：

类 Object 中的 clone

返回：

此实例的一个副本。

另请参见：

Cloneable

getType

public String getType()

返回该属性的类名。

返回：

类名。

isReadable

public boolean isReadable()

该属性的值是否可读。

返回：

如果该属性可读，则返回 True；否则返回 false。

isWritable

public boolean isWritable()

是否可将新值写入该属性。

返回：

如果可写入该属性，则返回 True；否则返回 false。

isIs

public boolean isIs()

指示此属性是否有一个 "is" 获取方法。

返回：

如果此属性有一个 "is" 获取方法，则返回 true。

toString

public String toString()

从类 Object 复制的描述

返回该对象的字符串表示。通常，toString 方法会返回一个“以文本方式表示”此对象的字符串。结果应是一个简明但易于读懂的信息表达式。建议所有子类都重写此方法。

Object 类的 toString 方法返回一个字符串，该字符串由类名（对象是该类的一个实例）、at 标记符“@”和此对象哈希码的无符号十六进制表示组成。换句话说，该方法返回一个字符串，它的值等于：

getClass().getName() + '@' + Integer.toHexString(hashCode())
 

覆盖：

类 Object 中的 toString

返回：

该对象的字符串表示形式。

equals

public boolean equals(Object o)

比较此 MBeanAttributeInfo 与另一个 MBeanAttributeInfo。

覆盖：

类 MBeanFeatureInfo 中的 equals

参数：

o - 要比较的对象。

返回：

当且仅当 o 是一个 MBeanAttributeInfo，它的 MBeanFeatureInfo.getName()、getType()、MBeanFeatureInfo.getDescription()、isReadable()、isWritable() 和 isIs() 值与此 MBeanAttributeInfo 的这些值相等（不必完全一样）时，才返回 true。

另请参见：

Object.hashCode(), Hashtable

hashCode

public int hashCode()

从类 Object 复制的描述

返回该对象的哈希码值。支持此方法是为了提高哈希表（例如 java.util.Hashtable 提供的哈希表）的性能。

hashCode 的常规协定是：

• 在 Java 应用程序执行期间，在对同一对象多次调用 hashCode 方法时，必须一致地返回相同的整数，前提是将对象进行 equals 比较时所用的信息没有被修改。从某一应用程序的一次执行到同一应用程序的另一次执行，该整数无需保持一致。
• 如果根据 equals(Object) 方法，两个对象是相等的，那么对这两个对象中的每个对象调用 hashCode 方法都必须生成相同的整数结果。
• 如果根据 Object.equals(java.lang.Object) 方法，两个对象不相等，那么对这两个对象中的任一对象上调用 hashCode 方法不 要求一定生成不同的整数结果。但是，程序员应该意识到，为不相等的对象生成不同整数结果可以提高哈希表的性能。

实际上，由 Object 类定义的 hashCode 方法确实会针对不同的对象返回不同的整数。（这一般是通过将该对象的内部地址转换成一个整数来实现的，但是 Java^TM 编程语言不需要这种实现技巧。）

覆盖：

类 MBeanFeatureInfo 中的 hashCode

返回：

此对象的一个哈希码值。

另请参见：

Object.equals(java.lang.Object), Hashtable

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