JavaTM Platform
Standard Ed. 6

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
另请参见:
序列化表格

字段摘要
 
从类 javax.management.MBeanFeatureInfo 继承的字段
description, name
 
构造方法摘要
MBeanAttributeInfo(String name, String description, Method getter, Method setter)
          此构造方法带有简单属性的名称,以及读取和写入属性的 Method 对象。
MBeanAttributeInfo(String name, String type, String description, boolean isReadable, boolean isWritable, boolean isIs)
          构造一个 MBeanAttributeInfo 对象。
MBeanAttributeInfo(String name, String type, String description, boolean isReadable, boolean isWritable, boolean isIs, Descriptor descriptor)
          构造一个 MBeanAttributeInfo 对象。
 
方法摘要
 Object clone()
          返回此实例的浅表副本。
 boolean equals(Object o)
          比较此 MBeanAttributeInfo 与另一个 MBeanAttributeInfo。
 String getType()
          返回该属性的类名。
 int hashCode()
          返回该对象的哈希码值。
 boolean isIs()
          指示此属性是否有一个 "is" 获取方法。
 boolean isReadable()
          该属性的值是否可读。
 boolean isWritable()
          是否可将新值写入该属性。
 String toString()
          返回该对象的字符串表示。
 
从类 javax.management.MBeanFeatureInfo 继承的方法
getDescription, getDescriptor, getName
 
从类 java.lang.Object 继承的方法
finalize, getClass, notify, notifyAll, wait, wait, wait
 

构造方法详细信息

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 不为 booleanjava.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 不为 booleanjava.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 的常规协定是:

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

覆盖:
MBeanFeatureInfo 中的 hashCode
返回:
此对象的一个哈希码值。
另请参见:
Object.equals(java.lang.Object), Hashtable

JavaTM Platform
Standard Ed. 6

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

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