ModelMBeanAttributeInfo

目录搜索

文字

概述

软件包

类

使用

树

已过时

索引

帮助

Java^TM 2 Platform
Standard Ed. 6

上一个类 下一个类

框架 无框架

摘要：嵌套 | 字段 | 构造方法 | 方法

详细信息：字段 | 构造方法 | 方法

javax.management.modelmbean
类 ModelMBeanAttributeInfo

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

所有已实现的接口：: Serializable, Cloneable, DescriptorAccess, DescriptorRead

public class ModelMBeanAttributeInfo
extends MBeanAttributeInfo
implements DescriptorAccess

ModelMBeanAttributeInfo 对象描述了 ModelMBean 的属性。它是 MBeanAttributeInfo 的一个子类，添加了关联的 Descriptor 和 DescriptorAccess 接口实现。

描述符中的字段定义如下，但不限于此：

 name           : 属性名称 
 descriptorType : 必须为 "attribute"   
 value          : 属性的当前值
 default        : 属性的默认值
 displayName    : 将在显示中使用的属性名称
 getMethod      : get 方法的操作描述符名称
 setMethod      : set 方法的操作描述符名称
 protocolMap    : 实现 Descriptor 接口的对象：映射关系必须适用于该属性并且项可以在运行时进行更新或扩充。
 persistPolicy  : OnUpdate|OnTimer|NoMoreOftenThan|OnUnregister|Always|Never  
 persistPeriod  : 秒数 － 持续周期的频率。当 persistPolicy 为 "OnTimer" 或 "NoMoreOftenThan" 时使用。  
 currencyTimeLimit : 值保持有效的时间，<0 表示无效，=0 表示总是有效，>0 表示有效的秒数
 lastUpdatedTimeStamp : 当设置值时
 visibility     : 1-4，其中 1 表示总是可见；4 表示几乎不可见
 presentationString : 允许数据呈现的 xml 格式的字符串

默认的描述符包含 name、descriptorType 和 displayName 字段。

注：由于与此规范的以前版本不一致，因此对于 currencyTimeLimit，建议不使用负值或零。要指示某个缓存的值永远无效，请忽略 currencyTimeLimit 字段。要指示它总是有效，请对此字段使用一个非常大的值。

此类的 serialVersionUID 为 6181543027787327345L。

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

字段摘要

从类 javax.management.MBeanFeatureInfo 继承的字段
`description, name`

构造方法摘要
`ModelMBeanAttributeInfo(ModelMBeanAttributeInfo inInfo)` 根据此 ModelMBeanAttributeInfo Object 构造新的 ModelMBeanAttributeInfo 对象。
`ModelMBeanAttributeInfo(String name, String description, Method getter, Method setter)` 构造具有默认描述符的 ModelMBeanAttributeInfo 对象。
`ModelMBeanAttributeInfo(String name, String description, Method getter, Method setter, Descriptor descriptor)` 构造 ModelMBeanAttributeInfo 对象。
`ModelMBeanAttributeInfo(String name, String type, String description, boolean isReadable, boolean isWritable, boolean isIs)` 构造具有默认描述符的 ModelMBeanAttributeInfo 对象。
`ModelMBeanAttributeInfo(String name, String type, String description, boolean isReadable, boolean isWritable, boolean isIs, Descriptor descriptor)` 构造具有默认描述符的 ModelMBeanAttributeInfo 对象。

方法摘要
`Object`	`clone()` 创建并返回新的 ModelMBeanAttributeInfo，它是此 ModelMBeanAttributeInfo 的副本。
`Descriptor`	`getDescriptor()` 获取 ModelMBeanAttributeInfo 的关联 Descriptor 的副本。
`void`	`setDescriptor(Descriptor inDescriptor)` 设置 ModelMBeanAttributeDescriptor 的关联 Descriptor（完全取代）。
`String`	`toString()` 返回 ModelMBeanAttributeInfo 实例的可读版本。

从类 javax.management.MBeanAttributeInfo 继承的方法
`equals, getType, hashCode, isIs, isReadable, isWritable`

从类 javax.management.MBeanFeatureInfo 继承的方法
`getDescription, getName`

从类 java.lang.Object 继承的方法
`finalize, getClass, notify, notifyAll, wait, wait, wait`

构造方法详细信息

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

构造具有默认描述符的 ModelMBeanAttributeInfo 对象。已构造对象的 Descriptor 包括 Method 对象（包含 DescriptorKey 元注释）生成的字段。

参数：: name - 属性名称。; description - 属性的可读描述。它是可选的。; getter - 用于读取属性值的方法。如果该属性是只写的，则此参数可以为 null。; setter - 用于写入属性值的方法。如果该属性是只读的，则此参数可以为 null。

抛出：

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

ModelMBeanAttributeInfo

public ModelMBeanAttributeInfo(String name,
                               String description,
                               Method getter,
                               Method setter,
                               Descriptor descriptor)
                        throws IntrospectionException

构造 ModelMBeanAttributeInfo 对象。已构造对象的 Descriptor 包括 Method 对象（包含 DescriptorKey 元注释）生成的字段。

参数：: name - 属性名称。; description - 属性的可读描述。它是可选的。; getter - 用于读取属性值的方法。如果该属性是只写的，则此参数可以为 null。; setter - 用于写入属性值的方法。如果该属性是只读的，则此参数可以为 null。; descriptor - 包含此 Attribute 实例的适当元数据的 Descriptor 的实例。如果此参数为 null，则将创建默认描述符。如果描述符不包含 "displayName" 字段，则用默认值将此字段添加到描述符中。

抛出：

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

RuntimeOperationsException - 包装一个 IllegalArgumentException。描述符无效，或者描述符 "name" 字段不等于 name 参数，或者描述符字段 "DescriptorType" 不等于 "attribute"。

ModelMBeanAttributeInfo

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

构造具有默认描述符的 ModelMBeanAttributeInfo 对象。

参数：: name - 属性名称; type - 属性的类型名称或类名称; description - 属性的可读描述。; isReadable - 如果属性有获取方法，则该参数为 true，否则为 false。; isWritable - 如果属性有设置方法，则该参数为 true，否则为 false。; isIs - 如果属性有一个 "is" 获取方法，则该参数为 true，否则为 false。

ModelMBeanAttributeInfo

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

构造具有默认描述符的 ModelMBeanAttributeInfo 对象。

参数：: name - 属性名称; type - 属性的类型名称或类名称; description - 属性的可读描述。; isReadable - 如果属性有获取方法，则该参数为 true，否则为 false。; isWritable - 如果属性有设置方法，则该参数为 true，否则为 false。; isIs - 如果属性有一个 "is" 获取方法，则为 true，否则为 false。; descriptor - 包含此 Attribute 实例的适当元数据的 Descriptor 的一个实例。如果它为 null，则将创建默认描述符。如果描述符不包含 "displayName" 字段，则用默认值将此字段添加到描述符中。

抛出：

ModelMBeanAttributeInfo

public ModelMBeanAttributeInfo(ModelMBeanAttributeInfo inInfo)

根据此 ModelMBeanAttributeInfo Object 构造新的 ModelMBeanAttributeInfo 对象。这将创建一个默认描述符。

参数：: inInfo - 将被复制的 ModelMBeanAttributeInfo

方法详细信息

getDescriptor

public Descriptor getDescriptor()

获取 ModelMBeanAttributeInfo 的关联 Descriptor 的副本。

指定者：: 接口 DescriptorRead 中的 getDescriptor
覆盖：: 类 MBeanFeatureInfo 中的 getDescriptor

返回：: 与 ModelMBeanAttributeInfo 对象关联的 Descriptor。
另请参见：: setDescriptor(javax.management.Descriptor)

setDescriptor

public void setDescriptor(Descriptor inDescriptor)

设置 ModelMBeanAttributeDescriptor 的关联 Descriptor（完全取代）。如果新 Descriptor 为 null，则关联的 Descriptor 恢复为默认描述符。在分配 Descriptor 之前验证它。如果新 Descriptor 无效，则抛出一个包装 IllegalArgumentException 的 RuntimeOperationsException。

指定者：: 接口 DescriptorAccess 中的 setDescriptor

参数：: inDescriptor - 替换与 ModelMBeanAttributeInfo 关联的 Descriptor
抛出：: RuntimeOperationsException - 包装无效 Descriptor 的 IllegalArgumentException
另请参见：: getDescriptor()

clone

public Object clone()

创建并返回新的 ModelMBeanAttributeInfo，它是此 ModelMBeanAttributeInfo 的副本。

覆盖：: 类 MBeanAttributeInfo 中的 clone

返回：: 此实例的一个副本。
抛出：: RuntimeOperationsException - 如果 Names 或 Values 字段的值为非法值。如果因为某种原因导致描述符构造失败，则将抛出此异常。
另请参见：: Cloneable

toString

public String toString()

返回 ModelMBeanAttributeInfo 实例的可读版本。

覆盖：: 类 MBeanAttributeInfo 中的 toString

返回：: 该对象的字符串表示形式。

概述

软件包

类

使用

树

已过时

索引

帮助

Java^TM 2 Platform
Standard Ed. 6

上一个类 下一个类

框架 无框架

摘要：嵌套 | 字段 | 构造方法 | 方法

详细信息：字段 | 构造方法 | 方法

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

javax.management.modelmbean 类 ModelMBeanAttributeInfo

ModelMBeanAttributeInfo

ModelMBeanAttributeInfo

ModelMBeanAttributeInfo

ModelMBeanAttributeInfo

ModelMBeanAttributeInfo

getDescriptor

setDescriptor

clone

toString

javax.management.modelmbean
类 ModelMBeanAttributeInfo