Класс ArrayType<T>

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

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

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

Этот конструктор поддерживает создание массивов примитивных типов, когда 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
 

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