javax.management
类 MBeanOperationInfo

java.lang.Object
  javax.management.MBeanFeatureInfo
      javax.management.MBeanOperationInfo

所有已实现的接口：

Serializable, Cloneable, DescriptorRead

直接已知子类：

ModelMBeanOperationInfo, OpenMBeanOperationInfoSupport

public class MBeanOperationInfo
extends MBeanFeatureInfo
implements Cloneable

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

从以下版本开始：

1.5

另请参见：

序列化表格

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)

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

参数：

method - 描述 MBean 操作的 java.lang.reflect.Method 对象。

description - 该操作的可读描述。

MBeanOperationInfo

public MBeanOperationInfo(String name,
                          String description,
                          MBeanParameterInfo[] signature,
                          String type,
                          int impact)

构造一个 MBeanOperationInfo 对象。

参数：

name - 该方法的名称。

description - 该操作的可读描述。

signature - 描述该方法的参数（变量）的 MBeanParameterInfo 对象。该参数可以为 null，与零长度数组的效果相同。

type - 方法返回值的类型。

impact - 该方法的影响，为 INFO、ACTION、ACTION_INFO、UNKNOWN 之一。

MBeanOperationInfo

public MBeanOperationInfo(String name,
                          String description,
                          MBeanParameterInfo[] signature,
                          String type,
                          int impact,
                          Descriptor descriptor)

构造一个 MBeanOperationInfo 对象。

参数：

name - 方法名称。

description - 操作的可读描述。

signature - 描述该方法的参数（变量）的 MBeanParameterInfo 对象。该参数可以为 null，与零长度数组的效果相同。

type - 方法返回值的类型。

impact - 该方法的影响，为 INFO、ACTION、ACTION_INFO、UNKNOWN 之一。

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

从以下版本开始：

1.6

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()

返回该方法所产生的影响，为 INFO、ACTION、ACTION_INFO、UNKNOWN 之一。

返回：

描述影响的代码。

toString

public String toString()

从类 Object 复制的描述

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

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

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

覆盖：

类 Object 中的 toString

返回：

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

equals

public boolean equals(Object o)

比较此 MBeanOperationInfo 与另一个 MBeanOperationInfo。

覆盖：

类 MBeanFeatureInfo 中的 equals

参数：

o - 要比较的对象。

返回：

当且仅当 o 是一个 MBeanOperationInfo，其 MBeanFeatureInfo.getName()、getReturnType()、MBeanFeatureInfo.getDescription()、getImpact()、MBeanFeatureInfo.getDescriptor() 和 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 方法确实会针对不同的对象返回不同的整数。（这一般是通过将该对象的内部地址转换成一个整数来实现的，但是 Java^TM 编程语言不需要这种实现技巧。）

覆盖：

类 MBeanFeatureInfo 中的 hashCode

返回：

此对象的一个哈希码值。

另请参见：

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

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