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