站内搜索: 请输入搜索关键词
当前页面: 在线文档首页 > JavaTM 2 Platform Standard Edition 5.0 API 规范中文版

MBeanOperationInfo (Java 2 Platform SE 5.0) - JavaTM 2 Platform Standard Edition 5.0 API 规范中文版

JavaTM 2 Platform
Standard Ed. 5.0

javax.management
类 MBeanOperationInfo

java.lang.Object
  继承者 javax.management.MBeanFeatureInfo
      继承者 javax.management.MBeanOperationInfo
所有已实现的接口:
Serializable, Cloneable
直接已知子类:
ModelMBeanOperationInfo, OpenMBeanOperationInfoSupport

public class MBeanOperationInfo
extends MBeanFeatureInfo
implements Serializable, Cloneable

描述 MBean 所公开的管理操作。此类的实例是不可变的。子类可以是可变的,但是不推荐此功能。

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

字段摘要
static int ACTION
          指示该操作与写入类似,并将以某种方式修改 MBean,通常是写入某个值或更改某个配置。
static int ACTION_INFO
          指示该操作与读取和写入类似。
static int INFO
          指示该操作与读取类似,主要返回信息。
static int UNKNOWN
          指示操作具有“未知”的特性。
 
从类 javax.management.MBeanFeatureInfo 继承的字段
description, name
 
构造方法摘要
MBeanOperationInfo(String description, Method method)
          构造一个 MBeanOperationInfo 对象。
MBeanOperationInfo(String name, String description, MBeanParameterInfo[] signature, String type, int impact)
          构造一个 MBeanOperationInfo 对象。
 
方法摘要
 Object clone()
          返回此实例的浅表副本。
 boolean equals(Object o)
          比较此 MBeanOperationInfo 与另一个 MBeanOperationInfo。
 int getImpact()
          返回该方法的影响,为 INFOACTIONACTION_INFOUNKNOWN 之一。
 String getReturnType()
          返回该方法的返回值的类型。
 MBeanParameterInfo[] getSignature()
          返回此操作的参数列表。
 int hashCode()
          返回该对象的哈希码值。
 
从类 javax.management.MBeanFeatureInfo 继承的方法
getDescription, getName
 
从类 java.lang.Object 继承的方法
finalize, getClass, notify, notifyAll, toString, wait, wait, wait
 

字段详细信息

INFO

public static final int INFO
指示该操作与读取类似,主要返回信息。

另请参见:
常量字段值

ACTION

public static final int ACTION
指示该操作与写入类似,并将以某种方式修改 MBean,通常是写入某个值或更改某个配置。

另请参见:
常量字段值

ACTION_INFO

public static final int ACTION_INFO
指示该操作与读取和写入类似。

另请参见:
常量字段值

UNKNOWN

public static final int UNKNOWN
指示操作具有“未知”的特性。

另请参见:
常量字段值
构造方法详细信息

MBeanOperationInfo

public MBeanOperationInfo(String description,
                          Method method)
                   throws IllegalArgumentException
构造一个 MBeanOperationInfo 对象。

参数:
method - 描述 MBean 操作的 java.lang.reflect.Method 对象。
description - 该操作的可读描述。
抛出:
IllegalArgumentException

MBeanOperationInfo

public MBeanOperationInfo(String name,
                          String description,
                          MBeanParameterInfo[] signature,
                          String type,
                          int impact)
                   throws IllegalArgumentException
构造一个 MBeanOperationInfo 对象。

参数:
name - 该方法的名称。
description - 该操作的可读描述。
signature - 描述该方法的参数(变量)的 MBeanParameterInfo 对象。这可以为 null,与零长度数组的效果相同。
type - 方法返回值的类型。
impact - 该方法的影响,为 INFO、ACTION、ACTION_INFO、UNKNOWN 之一。
抛出:
IllegalArgumentException
方法详细信息

clone

public Object clone()

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

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

覆盖:
Object 中的 clone
返回:
此实例的一个克隆。
另请参见:
Cloneable

getReturnType

public String getReturnType()
返回该方法的返回值的类型。

返回:
返回类型。

getSignature

public MBeanParameterInfo[] getSignature()

返回此操作的参数列表。每个参数都由一个 MBeanParameterInfo 对象来描述。

返回的数组是内部数组的一个浅表副本,这意味着它是对 MBeanParameterInfo 对象引用的一个内部数组副本,但是未复制每个被引用的 MBeanParameterInfo 对象。

返回:
MBeanParameterInfo 对象的数组。

getImpact

public int getImpact()
返回该方法的影响,为 INFOACTIONACTION_INFOUNKNOWN 之一。

返回:
描述影响的代码。

equals

public boolean equals(Object o)
比较此 MBeanOperationInfo 与另一个 MBeanOperationInfo。

覆盖:
MBeanFeatureInfo 中的 equals
参数:
o - 要比较的对象。
返回:
当且仅当 o 是一个 MBeanOperationInfo,其 MBeanFeatureInfo.getName()getReturnType()MBeanFeatureInfo.getDescription()getImpact()getSignature() 值与此 MBeanOperationInfo 的这些值相等(不必完全一样)时,才返回 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 方法确实会针对不同的对象返回不同的整数。(这一般是通过将该对象的内部地址转换成一个整数来实现的,但是 JavaTM 编程语言不需要这种实现技巧。)

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

JavaTM 2 Platform
Standard Ed. 5.0

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

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