Класс 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 для указанного 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 является массивом и выполняется одно из следующих условий (true):

• если этот экземпляр 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