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

public OpenType<?> getElementOpenType()

public boolean isPrimitiveArray()

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