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

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

JavaTM 2 Platform
Standard Ed. 5.0

javax.management
类 MBeanNotificationInfo

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

public class MBeanNotificationInfo
extends MBeanFeatureInfo
implements Cloneable, Serializable

MBeanNotificationInfo 类用于描述 MBean 为给定的 Java 通知类所发出的不同通知实例的特性。如果 MBean 发出可以是不同 Java 类实例的通知,则该 MBean 的元数据应该为这些 Java 通知类中的每一个提供 MBeanNotificationInfo 对象。

此类的实例是不可变的。子类可以是可变的,但是推荐不这样做。

此类扩展了 javax.management.MBeanFeatureInfo,因此提供了 name 和 description 域。name 字段应该是此列所描述的通知对象的完全限定 Java 类名。

getNotifTypes 方法返回一个 string 数组,其中包含 MBean 可以发出的通知类型。通知类型是一个用点表示的 string,它描述了已发出的通知是关于什么的,不是 Java 通知类。可使用单个一般的通知类来发送多种类型的通知。所有这些类型都以 getNotifTypes 方法所得到的字符串数组形式返回。

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

字段摘要
 
从类 javax.management.MBeanFeatureInfo 继承的字段
description, name
 
构造方法摘要
MBeanNotificationInfo(String[] notifTypes, String name, String description)
          构造一个 MBeanNotificationInfo 对象。
 
方法摘要
 Object clone()
          返回此实例的浅表副本。
 boolean equals(Object o)
          把此 MBeanAttributeInfo 与另一个 MBeanAttributeInfo 进行比较。
 String[] getNotifTypes()
          返回包含 MBean 可发出的通知类型的字符串数组(用点表示)。
 int hashCode()
          返回该对象的哈希码值。
 
从类 javax.management.MBeanFeatureInfo 继承的方法
getDescription, getName
 
从类 java.lang.Object 继承的方法
finalize, getClass, notify, notifyAll, toString, wait, wait, wait
 

构造方法详细信息

MBeanNotificationInfo

public MBeanNotificationInfo(String[] notifTypes,
                             String name,
                             String description)
                      throws IllegalArgumentException
构造一个 MBeanNotificationInfo 对象。

参数:
notifTypes - 包含 MBean 可发出的通知类型的字符串数组(用点表示)。这可以为 null,与零长度数组的效果相同。
name - 所描述通知的完全限定 Java 类名。
description - 数据的可读描述。
抛出:
IllegalArgumentException
方法详细信息

clone

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

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

getNotifTypes

public String[] getNotifTypes()
返回包含 MBean 可发出的通知类型的字符串数组(用点表示)。

返回:
字符串数组。更改返回的数组对此 MBeanNotificationInfo 没有影响。

equals

public boolean equals(Object o)
把此 MBeanAttributeInfo 与另一个 MBeanAttributeInfo 进行比较。

覆盖:
类 MBeanFeatureInfo 中的 equals
参数:
o - 要比较的对象。
返回:
当且仅当 o 是一个 MBeanNotificationInfo,这样其 MBeanFeatureInfo.getName()、MBeanFeatureInfo.getDescription() 和 getNotifTypes() 值与此 MBeanNotificationInfo 的这些值相等时(不必完全一样)才返回 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. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策。