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

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

JavaTM 2 Platform
Standard Ed. 5.0

javax.management.openmbean
类 OpenType

java.lang.Object
  继承者 javax.management.openmbean.OpenType
所有已实现的接口:
Serializable
直接已知子类:
ArrayType, CompositeType, SimpleType, TabularType

public abstract class OpenType
extends Object
implements Serializable

OpenType 类是所有类的父抽象类,它描述开放数据值的实际开放类型

开放类型 定义如下:

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

字段摘要
static String[] ALLOWED_CLASSNAMES
          开放数据值允许的 Java 类的完全限定名称的列表。
 
构造方法摘要
protected OpenType(String className, String typeName, String description)
          构造一个 OpenType 实例(实际上是一个子类实例,因为 OpenType 是抽象的),检查给定参数的有效性。
 
方法摘要
abstract  boolean equals(Object obj)
          比较指定的 obj 参数与此开放类型实例的相等性。
 String getClassName()
          返回此开放类型描述的开放数据值的完全限定的 Java 类名。
 String getDescription()
          返回此 OpenType 实例的文本描述。
 String getTypeName()
          返回此 OpenType 实例的名称。
abstract  int hashCode()
          返回该对象的哈希码值。
 boolean isArray()
          如果此开放类型描述的开放数据值是数组,则返回 true,否则返回 false
abstract  boolean isValue(Object obj)
          测试 obj 是否为此开放类型的值。
abstract  String toString()
          返回此开放类型实例的字符串表示形式。
 
从类 java.lang.Object 继承的方法
clone, finalize, getClass, notify, notifyAll, wait, wait, wait
 

字段详细信息

ALLOWED_CLASSNAMES

public static final String[] ALLOWED_CLASSNAMES
开放数据值允许的 Java 类的完全限定名称的列表。这些类的任何一个类的多维数组也是开放数据值允许的数组。
ALLOWED_CLASSNAMES = { 
        "java.lang.Void",
        "java.lang.Boolean",
        "java.lang.Character",
        "java.lang.Byte",
        "java.lang.Short",
        "java.lang.Integer",
"java.lang.Long",
        "java.lang.Float",
        "java.lang.Double",
        "java.lang.String",
        "java.math.BigDecimal",
        "java.math.BigInteger",
        "java.util.Date",
        "javax.management.ObjectName",
        CompositeData.class.getName(),
        TabularData.class.getName() } ;
       

构造方法详细信息

OpenType

protected OpenType(String className,
                   String typeName,
                   String description)
            throws OpenDataException
构造一个 OpenType 实例(实际上是一个子类实例,因为 OpenType 是抽象的),检查给定参数的有效性。下面描述了每个参数的有效性约束。
 

参数:
className - 此开放类型描述的开放数据值的完全限定的 Java 类名。在 ALLOWED_CLASSNAMES 中列出了开放数据值允许的有效 Java 类名。这些类中任何一个类的多维数组也是一个允许的类,在这种情况下,类名遵循 java.lang.ClassgetName() 方法定义的规则。例如,字符串的 3 维数组的类名是 "[[[Ljava.lang.String;"(不带引号)。
 
typeName - 为此实例表示的开放类型给出的名称;不能为 null 或空字符串。
 
description - 此实例表示的开放类型的可读描述;不能为 null 或空字符串。
 
抛出:
IllegalArgumentException - 如果 classNametypeNamedescription 为 null 或空字符串
 
OpenDataException - 如果 className 不是开放数据允许的 Java 类名之一
方法详细信息

getClassName

public String getClassName()
返回此开放类型描述的开放数据值的完全限定的 Java 类名。在 ALLOWED_CLASSNAMES 中仅列出了开放数据值可能的 Java 类名。这些类中任何一个类的多维数组也是一个允许的类,在这种情况下,类名遵循 java.lang.ClassgetName() 方法定义的规则。例如,字符串的 3 维数组的类名是 "[[[Ljava.lang.String;"(不带引号)。

返回:
类名。

getTypeName

public String getTypeName()
返回此 OpenType 实例的名称。

返回:
类型名称。

getDescription

public String getDescription()
返回此 OpenType 实例的文本描述。

返回:
描述。

isArray

public boolean isArray()
如果此开放类型描述的开放数据值是数组,则返回 true,否则返回 false

返回:
如果这是一个数组类型,则返回 true。

isValue

public abstract boolean isValue(Object obj)
测试 obj 是否为此开放类型的值。

参数:
obj - 要测试其有效性的对象。
返回:
如果 obj 是此开放类型的值,则返回 true,否则返回 false

equals

public abstract boolean equals(Object obj)
比较指定的 obj 参数与此开放类型实例的相等性。

覆盖:
Object 中的 equals
参数:
obj - 要比较的对象。
返回:
如果此对象与 obj 相等,则返回 true。
另请参见:
Object.hashCode(), Hashtable

hashCode

public abstract int hashCode()
从类 Object 复制的描述
返回该对象的哈希码值。支持该方法是为哈希表提供一些优点,例如,java.util.Hashtable 提供的哈希表。

hashCode 的常规协定是:

  • 在 Java 应用程序执行期间,在同一对象上多次调用 hashCode 方法时,必须一致地返回相同的整数,前提是对象上 equals 比较中所用的信息没有被修改。从某一应用程序的一次执行到同一应用程序的另一次执行,该整数无需保持一致。
  • 如果根据 equals(Object) 方法,两个对象是相等的,那么在两个对象中的每个对象上调用 hashCode 方法都必须生成相同的整数结果。
  • 以下情况 是必需的:如果根据 Object.equals(java.lang.Object) 方法,两个对象不相等,那么在两个对象中的任一对象上调用 hashCode 方法必定会生成不同的整数结果。但是,程序员应该知道,为不相等的对象生成不同整数结果可以提高哈希表的性能。

实际上,由 Object 类定义的 hashCode 方法确实会针对不同的对象返回不同的整数。(这一般是通过将该对象的内部地址转换成一个整数来实现的,但是 JavaTM 编程语言不需要这种实现技巧。)

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

toString

public abstract String toString()
返回此开放类型实例的字符串表示形式。

覆盖:
Object 中的 toString
返回:
字符串表示形式。

JavaTM 2 Platform
Standard Ed. 5.0

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

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