站内搜索: 请输入搜索关键词
当前页面: 在线文档首页 > 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,因此提供了 namedescription 域。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. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策