- 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 方法 描述 boolean
equals(Object obj)
将指定的obj
参数与此ArrayType
实例进行比较以获得相等性。static <E> ArrayType<E[]>
getArrayType(OpenType<E> elementType)
以类型安全的方式创建一个ArrayType
实例。int
getDimension()
返回此ArrayType
实例描述的数组的维数。OpenType<?>
getElementOpenType()
返回此ArrayType
实例描述的阵列中包含的元素值的 打开类型 。static <T> ArrayType<T>
getPrimitiveArrayType(Class<T> arrayClass)
以类型安全的方式创建一个ArrayType
实例。int
hashCode()
返回此ArrayType
实例的哈希码值。boolean
isPrimitiveArray()
返回true
如果此开放类型描述的开放数据值是原始阵列,false
否则。boolean
isValue(Object obj)
测试 obj是否为此ArrayType
实例的值。String
toString()
返回此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.String
ArrayType<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
-
-