Класс ArrayType<T>

public ArrayType(int dimension, OpenType<?> elementType) throws OpenDataException

Создаёт экземпляр ArrayType, описывающий значения открытых данных, которые являются массивами с размерностью dimension элементов, имеющих открытый тип elementType.

При вызове метода getClassName на экземпляре ArrayType, он возвращает имя класса экземпляров массива (согласно правилам, определённым методом getName класса java.lang.Class), а не имя класса элементов массива (которое возвращается при вызове метода 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());
 

public ArrayType(SimpleType<?> elementType, boolean primitiveArray) throws OpenDataException

Создаёт экземпляр ArrayType для заданного SimpleType.

Этот конструктор поддерживает создание массивов примитивных типов, когда primitiveArray равно true.

Для примитивных массивов метод getElementOpenType() возвращает SimpleType, соответствующий обернутому типу примитивного типа массива.

При вызове метода getClassName на экземпляре ArrayType, он возвращает имя класса экземпляров массива (согласно правилам, определённым методом 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
 

public int getDimension()

Возвращает размерность массивов, описываемых этим экземпляром ArrayType.

public OpenType<?> getElementOpenType()

Возвращает открытый тип значений элементов, содержащихся в массивах, описываемых этим экземпляром ArrayType.

public boolean isPrimitiveArray()

Возвращает true , если описываемые открытые данные являются примитивными массивами, false в противном случае.

public boolean isValue(Object obj)

Проверяет, является ли obj значением для этого экземпляра ArrayType.

Этот метод возвращает true тогда и только тогда, когда obj не равно null, obj является массивом и выполняется одно из следующих условий:

• если этот экземпляр ArrayType описывает массив элементов SimpleType или их соответствующих примитивных типов, имя класса obj совпадает с полем className, определённым для этого экземпляра ArrayType (т.е. имя класса, возвращаемое методом getClassName, которое включает информацию о размерности),
  
• если этот экземпляр ArrayType описывает массив классов, реализующих интерфейс TabularData или интерфейс CompositeData, obj присваиваем такому массиву, и каждый элемент в {obj либо равен null, либо является допустимым значением для открытого типа элемента, указанного в этом экземпляре ArrayType.

public boolean equals(Object obj)

Сравнивает указанный параметр obj с этим экземпляром ArrayType на равенство.

Два экземпляра ArrayType равны, если и только если они описывают экземпляры массивов с одинаковой размерностью, типом элементов и флагом примитивного массива.

public int hashCode()

Возвращает значение хэш-кода для этого экземпляра ArrayType.

Хэш-код экземпляра ArrayType является суммой хэш-кодов всех элементов информации, используемых в сравнениях equals (т.е. размерность, открытый тип элементов и флаг примитивного массива). Хэш-код примитивного значения - хэш-код соответствующего упакованного объекта (например, хэш-код для true равен Boolean.TRUE.hashCode()). Это гарантирует, что t1.equals(t2) подразумевает, что t1.hashCode()==t2.hashCode() для любых двух экземпляров ArrayType t1 и t2, как требуется общим соглашением метода Object.hashCode().

Поскольку экземпляры ArrayType неизменяемы, хэш-код для этого экземпляра вычисляется один раз при первом вызове hashCode, а затем то же значение возвращается при последующих вызовах.

public String toString()

Возвращает строковое представление этого экземпляра ArrayType.

Строковое представление состоит из имени этого класса (т.е. javax.management.openmbean.ArrayType), имени типа, размерности, открытого типа элементов и флага примитивного массива, определённых для этого экземпляра.

Поскольку экземпляры ArrayType неизменяемы, строковое представление для этого экземпляра вычисляется один раз при первом вызове toString, а затем то же значение возвращается при последующих вызовах.

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
 

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