Класс 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