Module  java.management

Class 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
    • 构造方法详细信息

      • ArrayType

        public ArrayType​(int dimension,
                         OpenType<?> elementType)
                  throws OpenDataException
        构造一个描述开放数据值的ArrayType实例,它是具有开放类型elementType的元素的维度维度的数组。

        当在ArrayType实例上调用时, getClassName方法返回其描述的数组实例的类名(遵循由getName方法定义的规则java.lang.Class ),而不是数组元素的类名称(由getElementOpenType().getClassName()调用getElementOpenType().getClassName() )。

        对应于此ArrayType实例的类型名称的内部字段也将设置为其描述的数组实例的类名。 换句话说,方法getClassNamegetTypeName返回相同的字符串值。 对应于该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实例描述的阵列中包含的元素值的开放类型 ; 必须是二者之一的一个实例SimpleTypeCompositeTypeTabularType或另一ArrayTypeSimpleTypeCompositeTypeTabularType作为其elementType
        异常
        IllegalArgumentException - 如果 dimension不是正整数。
        OpenDataException - 如果 elementType的className不是开放数据的允许的Java类名称之一。
      • ArrayType

        public ArrayType​(SimpleType<?> elementType,
                         boolean primitiveArray)
                  throws OpenDataException
        为所提供的SimpleType构造一维ArrayType实例。

        primitiveArraytrue时,此构造函数支持创建基本类型的数组。

        对于原始数组, getElementOpenType()方法返回对应于数组的原始类型的包装器类型的SimpleType

        当被调用的ArrayType例如, getClassName方法返回它所描述的阵列的实例(以下由定义的规则的类名getName的方法java.lang.Class ),而不是数组元素的类名(其通过调用返回到getElementOpenType().getClassName() )。

        与该ArrayType实例的类型名称相对应的内部字段也将设置为其描述的数组实例的类名。 换句话说,方法getClassNamegetTypeName返回相同的字符串值。 对应于该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 -如果 primitiveArraytrueelementType不是有效 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实例。
        Specified by:
        isValueOpenType<T>
        参数
        obj - 要测试的对象。
        结果
        true如果 obj是此 ArrayType实例的值。
      • equals

        public boolean equals​(Object obj)
        将指定的obj参数与此ArrayType实例进行比较以获得相等性。

        当且仅当它们描述具有相同维度的元素的开放类型和原始数组标志的数组实例时,两个ArrayType实例是相等的。

        Specified by:
        equalsOpenType<T>
        参数
        obj - 要与此ArrayType实例相等的对象; 如果objnull或者不是类ArrayType一个实例,这个方法返回false
        结果
        true如果指定的对象等于这个 ArrayType实例。
        另请参见:
        Object.hashCode()HashMap
      • hashCode

        public int hashCode​()
        返回此ArrayType实例的哈希码值。

        ArrayType实例的散列码是equals比较(即维度,元素的开放类型和原始数组标志)中使用的所有信息元素的哈希码的总和。 原始值的哈希码是相应的盒装对象的哈希true (例如, true的哈希trueBoolean.TRUE.hashCode() )。 这确保了t1.equals(t2)意味着t1.hashCode()==t2.hashCode()对于任何两个ArrayType实例t1t2 ,所要求的方法的常规合同Object.hashCode()

        由于ArrayType实例是不可变的,因此在第一次调用hashCode ,会计算一次此实例的哈希码,然后为后续调用返回相同的值。

        Specified by:
        hashCodeOpenType<T>
        结果
        这个 ArrayType实例的哈希码值
        另请参见:
        Object.equals(java.lang.Object)System.identityHashCode(java.lang.Object)
      • toString

        public String toString​()
        返回此ArrayType实例的字符串表示形式。

        字符串表示由此类的名称(即javax.management.openmbean.ArrayType ),类型名称,维度,元素的打开类型和为此实例定义的基元数组标志。

        由于ArrayType实例是不可变的,所以在第一次调用toString ,该实例的字符串表示计算一次,然后为后续调用返回相同的值。

        Specified by:
        toStringOpenType<T>
        结果
        这个 ArrayType实例的字符串表示形式
      • 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实例描述的阵列中包含的元素值的开放类型 ; 必须是二者之一的一个实例SimpleTypeCompositeTypeTabularType或另一ArrayTypeSimpleTypeCompositeTypeTabularType作为其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[].classboolean[][].classgetElementOpenType()返回的方法ArrayType返回SimpleType对应于包装类型基本类型的数组的。
        结果
        一个 ArrayType实例
        异常
        IllegalArgumentException - 如果 arrayClass不是原始数组。
        从以下版本开始:
        1.6