- java.lang.Object
-
- javax.management.openmbean.OpenType<T>
-
- javax.management.openmbean.ArrayType<T>
-
- All Implemented Interfaces:
-
Serializable
public class ArrayType<T> extends OpenType<T>
所述ArrayType类是开放类型类,其实例描述了作为开放数据值的n维阵列所有打开的数据值。有效的
ArrayType实例的示例有:// 2-dimension array of java.lang.String ArrayType<String[][]> a1 = new ArrayType<String[][]>(2, SimpleType.STRING); // 1-dimension array of int ArrayType<int[]> a2 = new ArrayType<int[]>(SimpleType.INTEGER, true); // 1-dimension array of java.lang.Integer ArrayType<Integer[]> a3 = new ArrayType<Integer[]>(SimpleType.INTEGER, false); // 4-dimension array of int ArrayType<int[][][][]> a4 = new ArrayType<int[][][][]>(3, a2); // 4-dimension array of java.lang.Integer ArrayType<Integer[][][][]> a5 = new ArrayType<Integer[][][][]>(3, a3); // 1-dimension array of java.lang.String ArrayType<String[]> a6 = new ArrayType<String[]>(SimpleType.STRING, false); // 1-dimension array of long ArrayType<long[]> a7 = new ArrayType<long[]>(SimpleType.LONG, true); // 1-dimension array of java.lang.Integer ArrayType<Integer[]> a8 = ArrayType.getArrayType(SimpleType.INTEGER); // 2-dimension array of java.lang.Integer ArrayType<Integer[][]> a9 = ArrayType.getArrayType(a8); // 2-dimension array of int ArrayType<int[][]> a10 = ArrayType.getPrimitiveArrayType(int[][].class); // 3-dimension array of int ArrayType<int[][][]> a11 = ArrayType.getArrayType(a10); // 1-dimension array of float ArrayType<float[]> a12 = ArrayType.getPrimitiveArrayType(float[].class); // 2-dimension array of float ArrayType<float[][]> a13 = ArrayType.getArrayType(a12); // 1-dimension array of javax.management.ObjectName ArrayType<ObjectName[]> a14 = ArrayType.getArrayType(SimpleType.OBJECTNAME); // 2-dimension array of javax.management.ObjectName ArrayType<ObjectName[][]> a15 = ArrayType.getArrayType(a14); // 3-dimension array of java.lang.String ArrayType<String[][][]> a16 = new ArrayType<String[][][]>(3, SimpleType.STRING); // 1-dimension array of java.lang.String ArrayType<String[]> a17 = new ArrayType<String[]>(1, SimpleType.STRING); // 2-dimension array of java.lang.String ArrayType<String[][]> a18 = new ArrayType<String[][]>(1, a17); // 3-dimension array of java.lang.String ArrayType<String[][][]> a19 = new ArrayType<String[][][]>(1, a18);- 从以下版本开始:
- 1.5
- 另请参见:
- Serialized Form
-
-
Field Summary
-
Fields inherited from class javax.management.openmbean.OpenType
ALLOWED_CLASSNAMES, ALLOWED_CLASSNAMES_LIST
-
-
构造方法摘要
构造方法 Constructor 描述 ArrayType(int dimension, OpenType<?> elementType)构造一个描述 开放数据值的ArrayType实例,它是具有 开放类型为 elementType的元素的维度 维度的数组。ArrayType(SimpleType<?> elementType, boolean primitiveArray)为所提供的SimpleType构造一维ArrayType实例。
-
方法摘要
所有方法 静态方法 接口方法 具体的方法 Modifier and Type 方法 描述 booleanequals(Object obj)将指定的obj参数与此ArrayType实例进行比较以获得相等性。static <E> ArrayType<E[]>getArrayType(OpenType<E> elementType)以类型安全的方式创建一个ArrayType实例。intgetDimension()返回此ArrayType实例描述的数组的维数。OpenType<?>getElementOpenType()返回此ArrayType实例描述的阵列中包含的元素值的 打开类型 。static <T> ArrayType<T>getPrimitiveArrayType(Class<T> arrayClass)以类型安全的方式创建一个ArrayType实例。inthashCode()返回此ArrayType实例的哈希码值。booleanisPrimitiveArray()返回true如果此开放类型描述的开放数据值是原始阵列,false否则。booleanisValue(Object obj)测试 obj是否为此ArrayType实例的值。StringtoString()返回此ArrayType实例的字符串表示形式。-
Methods inherited from class java.lang.Object
clone, finalize, getClass, notify, notifyAll, wait, wait, wait
-
Methods inherited from class javax.management.openmbean.OpenType
getClassName, getDescription, getTypeName, isArray
-
-
-
-
构造方法详细信息
-
ArrayType
public ArrayType(int dimension, OpenType<?> elementType) throws OpenDataException构造一个描述开放数据值的ArrayType实例,它是具有开放类型为elementType的元素的维度维度的数组。当在
ArrayType实例上调用时,getClassName方法返回其描述的数组实例的类名(遵循由getName方法定义的规则java.lang.Class),而不是数组元素的类名称(由getElementOpenType().getClassName()调用getElementOpenType().getClassName())。对应于此
ArrayType实例的类型名称的内部字段也将设置为其描述的数组实例的类名。 换句话说,方法getClassName和getTypeName返回相同的字符串值。 对应于该ArrayType实例的描述的内部字段设置为一个字符串值,后面跟随以下模板:- 如果非原始数组:
<dimension>-dimension array of <element_class_name> - 如果原始数组:
<dimension>-dimension array of <primitive_type_of_the_element_class_name>
例如,下面的代码片段:
将产生以下输出:ArrayType<String[][][]> t = new ArrayType<String[][][]>(3, SimpleType.STRING); System.out.println("array class name = " + t.getClassName()); System.out.println("element class name = " + t.getElementOpenType().getClassName()); System.out.println("array type name = " + t.getTypeName()); System.out.println("array type description = " + t.getDescription());并且以下与上面列出的代码相同的代码也将产生相同的输出:array class name = [[[Ljava.lang.String; element class name = java.lang.String array type name = [[[Ljava.lang.String; array type description = 3-dimension array of java.lang.StringArrayType<String[]> t1 = new ArrayType<String[]>(1, SimpleType.STRING); ArrayType<String[][]> t2 = new ArrayType<String[][]>(1, t1); ArrayType<String[][][]> t3 = new ArrayType<String[][][]>(1, t2); System.out.println("array class name = " + t3.getClassName()); System.out.println("element class name = " + t3.getElementOpenType().getClassName()); System.out.println("array type name = " + t3.getTypeName()); System.out.println("array type description = " + t3.getDescription());- 参数
-
dimension- 由ArrayType实例描述的阵列的维数; 必须大于或等于1。 -
elementType- 由ArrayType实例描述的阵列中包含的元素值的开放类型 ; 必须是二者之一的一个实例SimpleType,CompositeType,TabularType或另一ArrayType与SimpleType,CompositeType或TabularType作为其elementType。 - 异常
-
IllegalArgumentException- 如果dimension不是正整数。 -
OpenDataException- 如果 elementType的className不是开放数据的允许的Java类名称之一。
- 如果非原始数组:
-
ArrayType
public ArrayType(SimpleType<?> elementType, boolean primitiveArray) throws OpenDataException
为所提供的SimpleType构造一维ArrayType实例。当
primitiveArray为true时,此构造函数支持创建基本类型的数组。对于原始数组,
getElementOpenType()方法返回对应于数组的原始类型的包装器类型的SimpleType。当被调用的
ArrayType例如,getClassName方法返回它所描述的阵列的实例(以下由定义的规则的类名getName的方法java.lang.Class),而不是数组元素的类名(其通过调用返回到getElementOpenType().getClassName())。与该
ArrayType实例的类型名称相对应的内部字段也将设置为其描述的数组实例的类名。 换句话说,方法getClassName和getTypeName返回相同的字符串值。 对应于该ArrayType实例的描述的内部字段设置为一个字符串值,后面的模板如下:- 如果非原始数组:
1-dimension array of <element_class_name> - 如果是原始数组:
1-dimension array of <primitive_type_of_the_element_class_name>
例如,下面的代码片段:
将产生以下输出:ArrayType<int[]> t = new ArrayType<int[]>(SimpleType.INTEGER, true); System.out.println("array class name = " + t.getClassName()); System.out.println("element class name = " + t.getElementOpenType().getClassName()); System.out.println("array type name = " + t.getTypeName()); System.out.println("array type description = " + t.getDescription());array class name = [I element class name = java.lang.Integer array type name = [I array type description = 1-dimension array of int- 参数
-
elementType-所述SimpleType包含在由该所述阵列中的元素值的ArrayType实例。 -
primitiveArray-true当这个数组描述原始数组。 - 异常
-
IllegalArgumentException- 如果dimension不是正整数。 -
OpenDataException-如果primitiveArray为true和elementType不是有效SimpleType的基本类型。 - 从以下版本开始:
- 1.6
- 如果非原始数组:
-
-
方法详细信息
-
getDimension
public int getDimension()
返回此ArrayType实例描述的数组的维数。- 结果
- 尺寸。
-
getElementOpenType
public OpenType<?> getElementOpenType()
返回此ArrayType实例描述的阵列中包含的元素值的 打开类型 。- 结果
- 元素类型。
-
isPrimitiveArray
public boolean isPrimitiveArray()
返回true如果打开类型的开放数据值描述的是原始数组,否则为false。- 结果
- 如果这是一个原始数组类型,则为true。
- 从以下版本开始:
- 1.6
-
isValue
public boolean isValue(Object obj)
测试obj是否为此ArrayType实例的值。此方法返回
true如果且仅当obj不为空时, obj是一个数组,并且以下任何一个是true:- 如果此
ArrayType实例描述了一个SimpleType元素或它们对应的基元类型的数组,则obj的类名与为此ArrayType实例定义的类名相同(即由getClassName方法返回的类名,其中包含维度信息) , - 如果此
ArrayType实例描述了实现TabularData接口或CompositeData接口的类的数组,则obj可以分配给这样一个声明的数组,并且包含在{ obj中的每个元素都为null或该ArrayType指定的元素的打开类型的ArrayType实例。
- 如果此
-
equals
public boolean equals(Object obj)
将指定的obj参数与此ArrayType实例进行比较以获得相等性。当且仅当它们描述具有相同维度的元素的开放类型和原始数组标志的数组实例时,两个
ArrayType实例是相等的。- Specified by:
-
equals在OpenType<T> - 参数
-
obj- 要与此ArrayType实例相等的对象; 如果obj是null或者不是类ArrayType一个实例,这个方法返回false。 - 结果
-
true如果指定的对象等于这个ArrayType实例。 - 另请参见:
-
Object.hashCode(),HashMap
-
hashCode
public int hashCode()
返回此ArrayType实例的哈希码值。ArrayType实例的散列码是equals比较(即维度,元素的开放类型和原始数组标志)中使用的所有信息元素的哈希码的总和。 原始值的哈希码是相应的盒装对象的哈希true(例如,true的哈希true为Boolean.TRUE.hashCode())。 这确保了t1.equals(t2)意味着t1.hashCode()==t2.hashCode()对于任何两个ArrayType实例t1和t2,所要求的方法的常规合同Object.hashCode()。由于
ArrayType实例是不可变的,因此在第一次调用hashCode,会计算一次此实例的哈希码,然后为后续调用返回相同的值。- Specified by:
-
hashCode在OpenType<T> - 结果
-
这个
ArrayType实例的哈希码值 - 另请参见:
-
Object.equals(java.lang.Object),System.identityHashCode(java.lang.Object)
-
toString
public String toString()
返回此ArrayType实例的字符串表示形式。字符串表示由此类的名称(即
javax.management.openmbean.ArrayType),类型名称,维度,元素的打开类型和为此实例定义的基元数组标志。由于
ArrayType实例是不可变的,所以在第一次调用toString,该实例的字符串表示计算一次,然后为后续调用返回相同的值。
-
getArrayType
public static <E> ArrayType<E[]> getArrayType(OpenType<E> elementType) throws OpenDataException
以类型安全的方式创建一个ArrayType实例。可以通过根据需要调用此方法多次构建多维数组。
使用相同参数调用此方法两次可能会返回相同的对象或两个相等但不相同的对象。
例如,下面的代码片段:
将产生以下输出:ArrayType<String[]> t1 = ArrayType.getArrayType(SimpleType.STRING); ArrayType<String[][]> t2 = ArrayType.getArrayType(t1); ArrayType<String[][][]> t3 = ArrayType.getArrayType(t2); System.out.println("array class name = " + t3.getClassName()); System.out.println("element class name = " + t3.getElementOpenType().getClassName()); System.out.println("array type name = " + t3.getTypeName()); System.out.println("array type description = " + t3.getDescription());array class name = [[[Ljava.lang.String; element class name = java.lang.String array type name = [[[Ljava.lang.String; array type description = 3-dimension array of java.lang.String- 参数类型
-
E- 描述实例必须具有的Java类型 - 参数
-
elementType- 由ArrayType实例描述的阵列中包含的元素值的开放类型 ; 必须是二者之一的一个实例SimpleType,CompositeType,TabularType或另一ArrayType与SimpleType,CompositeType或TabularType作为其elementType。 - 结果
-
一个
ArrayType例子 - 异常
-
OpenDataException- 如果 elementType的className不是开放数据的允许的Java类名称之一。 - 从以下版本开始:
- 1.6
-
getPrimitiveArrayType
public static <T> ArrayType<T> getPrimitiveArrayType(Class<T> arrayClass)
以类型安全的方式创建一个ArrayType实例。使用相同参数调用此方法两次可能会返回相同的对象或两个相等但不相同的对象。
例如,下面的代码片段:
将产生以下输出:ArrayType<int[][][]> t = ArrayType.getPrimitiveArrayType(int[][][].class); System.out.println("array class name = " + t.getClassName()); System.out.println("element class name = " + t.getElementOpenType().getClassName()); System.out.println("array type name = " + t.getTypeName()); System.out.println("array type description = " + t.getDescription());array class name = [[[I element class name = java.lang.Integer array type name = [[[I array type description = 3-dimension array of int- 参数类型
-
T- 描述实例必须具有的Java类型 - 参数
-
arrayClass-基本数组类如int[].class,boolean[][].class等getElementOpenType()返回的方法ArrayType返回SimpleType对应于包装类型基本类型的数组的。 - 结果
-
一个
ArrayType实例 - 异常
-
IllegalArgumentException- 如果 arrayClass不是原始数组。 - 从以下版本开始:
- 1.6
-
-