Класс CompositeType

java.lang.Object
- javax.management.openmbean.OpenType<CompositeData>
- - javax.management.openmbean.CompositeType

Все реализованные интерфейсы:: Serializable

public class CompositeType
extends OpenType<CompositeData>

Класс CompositeType — это класс открытого типа, экземпляры которого описывают типы значений CompositeData.

С момента:: 1.5
См. также:: Сериализованная форма

Поля

Поля, объявленные в классе javax.management.openmbean.OpenType

ALLOWED_CLASSNAMES, ALLOWED_CLASSNAMES_LIST

Конструкторы

Конструктор	Описание
`CompositeType(String typeName, String description, String[] itemNames, String[] itemDescriptions, OpenType<?>[] itemTypes)`	Создаёт экземпляр `CompositeType`, проверяя корректность заданных параметров.

Методы

Модификатор и тип	Метод	Описание
`boolean`	`containsKey(String itemName)`	Возвращает `true`, если этот экземпляр `CompositeType` определяет элемент с именем `itemName`.
`boolean`	`equals(Object obj)`	Сравнивает указанный параметр `obj` с этим экземпляром `CompositeType` на равенство.
`String`	`getDescription(String itemName)`	Возвращает описание элемента с именем `itemName`, или `null`, если этот экземпляр `CompositeType` не определяет элемент с именем `itemName`.
`OpenType<?>`	`getType(String itemName)`	Возвращает открытый тип элемента с именем `itemName`, или `null`, если этот экземпляр `CompositeType` не определяет элемент с именем `itemName`.
`int`	`hashCode()`	Возвращает хеш-код для этого экземпляра `CompositeType`.
`boolean`	`isValue(Object obj)`	Проверяет, является ли `obj` значением, которое может быть описано этим экземпляром `CompositeType`.
`Set<String>`	`keySet()`	Возвращает немодифицируемый вид Set всех имён элементов, определённых этим экземпляром `CompositeType`.
`String`	`toString()`	Возвращает строковое представление этого экземпляра `CompositeType`.

Методы, объявленные в классе javax.management.openmbean.OpenType

getClassName, getDescription, getTypeName, isArray

Методы, объявленные в классе java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Конструкторы

CompositeType

public CompositeType(String typeName,
                     String description,
                     String[] itemNames,
                     String[] itemDescriptions,
                     OpenType<?>[] itemTypes)
              throws OpenDataException

Создаёт экземпляр CompositeType, проверяя корректность переданных параметров. Ограничения корректности описаны ниже для каждого параметра.

Обратите внимание, что содержимое трёх массивов itemNames, itemDescriptions и itemTypes копируется внутренне, поэтому любые последующие изменения этих массивов вызывающей стороной конструктора не повлияют на созданный экземпляр CompositeType.

Имя класса Java для значений составных данных, которые представляет этот тип составных данных (т.е. имя класса, возвращаемое методом getClassName), устанавливается в строковое значение, возвращаемое CompositeData.class.getName().

Параметры:: typeName - Имя, присваиваемое типу составных данных, который представляет этот экземпляр; не может быть null или пустой строкой.; description - Читабельное описание типа составных данных, который представляет этот экземпляр; не может быть null или пустой строкой.; itemNames - Имена элементов, содержащихся в значениях составных данных, описываемых этим экземпляром CompositeType; не может быть null и должен содержать как минимум один элемент; ни один элемент не может быть null или пустой строкой. Обратите внимание, что порядок, в котором даются имена элементов, не важен для отличия одного экземпляра CompositeType от другого; имена элементов хранятся внутренне в отсортированном по возрастанию алфавитном порядке.; itemDescriptions - Описания элементов в том же порядке, что и itemNames, содержащихся в значениях составных данных, описываемых этим экземпляром CompositeType instance; должен иметь тот же размер, что и itemNames; ни один элемент не может быть null или пустой строкой.; itemTypes - Экземпляры open type, в том же порядке, что и itemNames, описывающие элементы, содержащиеся в значениях составных данных, описываемых этим экземпляром CompositeType instance; должен иметь тот же размер, что и itemNames; ни один элемент не может быть null.
Исключения:: IllegalArgumentException - Если typeName или description являются null или пустой строкой, или itemNames или itemDescriptions или itemTypes равны null, или любой элемент itemNames или itemDescriptions является null или пустой строкой, или любой элемент itemTypes равен null, или itemNames или itemDescriptions или itemTypes не имеют одинакового размера.; OpenDataException - Если itemNames содержит повторяющиеся имена элементов (чувствительно к регистру, но ведущие и хвостовые пробелы удаляются).

Методы

containsKey

public boolean containsKey(String itemName)

Возвращает true, если этот экземпляр CompositeType определяет элемент с именем itemName.

Параметры:: itemName - имя элемента.
Возвращает:: true, если элемент с данным именем присутствует.

getDescription

public String getDescription(String itemName)

Возвращает описание элемента с именем itemName или null, если этот экземпляр CompositeType не определяет элемент с именем itemName.

Параметры:: itemName - имя элемента.
Возвращает:: описание.

getType

public OpenType<?> getType(String itemName)

Возвращает тип open элемента с именем itemName или null, если этот экземпляр CompositeType не определяет элемент с именем itemName.

Параметры:: itemName - имя элемента.
Возвращает:: тип.

keySet

public Set<String> keySet()

Возвращает неизменяемый вид множества всех имён элементов, определённых этим экземпляром CompositeType. Итератор множества будет возвращать имена элементов в порядке возрастания.

Возвращает:: множество Set String.

isValue

public boolean isValue(Object obj)

Проверяет, является ли obj значением, которое может быть описано этим экземпляром CompositeType.

Если obj равно null или не является экземпляром javax.management.openmbean.CompositeData, то isValue возвращает false.

Если obj является экземпляром javax.management.openmbean.CompositeData, то пусть ct будет его типом CompositeType, возвращаемым CompositeData.getCompositeType(). Результатом является true, если this является совместимым с ct. Это означает, что:

this.getTypeName() равно ct.getTypeName(), и
нет имён элементов, присутствующих в this, которые не присутствуют также в ct, и
для каждого элемента в this, его тип совместим с типом соответствующего элемента в ct.

Один тип TabularType совместим с другим TabularType , если у них одинаковые typeName и список имён индексов, и тип строки первого совместим с типом строки второго.

Один тип ArrayType совместим с другим ArrayType , если у них одинаковая размерность; и оба являются примитивными массивами или ни один из них не является; и тип элемента первого совместим с типом элемента второго.

Во всех остальных случаях, тип OpenType совместим с другим OpenType только если они равны.

Эти правила означают, что дополнительные элементы могут быть добавлены в тип CompositeData без потери совместимости с типом CompositeType, которому эти элементы не нужны.

Унаследовано от:: isValue в классе OpenType<CompositeData>
Параметры:: obj - значение, тип которого открыт и проверяется на совместимость с этим экземпляром CompositeType.
Возвращает:: true если obj является значением для этого типа составных данных, false в противном случае.

equals

public boolean equals(Object obj)

Сравнивает указанный параметр obj с этим экземпляром CompositeType на равенство.

Два экземпляра CompositeType равны тогда и только тогда, когда истинны все следующие утверждения:

их имена типов равны
имена и типы их элементов равны

Унаследовано от:: equals в классе OpenType<CompositeData>
Параметры:: obj - объект для сравнения на равенство с этим экземпляром CompositeType instance; если obj равен null, equals возвращает false.
Возвращает:: true если указанный объект равен этому экземпляру CompositeType instance.
См. также:: Object.hashCode(), HashMap

hashCode

public int hashCode()

Возвращает значение хэш-кода для этого экземпляра CompositeType instance.

Хэш-код экземпляра CompositeType — это сумма хэш-кодов всех элементов информации, используемых в сравнениях equals (т.е. имя, имена элементов, типы элементов). Это гарантирует, что t1.equals(t2) подразумевает t1.hashCode()==t2.hashCode() для любых двух экземпляров CompositeType instance t1 и t2, как требуется общим контрактом метода Object.hashCode().

Поскольку экземпляры CompositeType неизменяемы, хэш-код для этого экземпляра вычисляется один раз при первом вызове hashCode, а затем возвращается то же значение для последующих вызовов.

Переопределяет:: hashCode в классе Object
Возвращает:: значение хэш-кода для этого экземпляра CompositeType instance
См. также:: Object.equals(java.lang.Object), System.identityHashCode(java.lang.Object)

toString

public String toString()

Возвращает строковое представление этого экземпляра CompositeType instance.

Строковое представление состоит из имени этого класса (т.е. javax.management.openmbean.CompositeType), имени типа для этого экземпляра и списка строк имён и типов элементов этого экземпляра.

Поскольку экземпляры CompositeType неизменяемы, строковое представление для этого экземпляра вычисляется один раз при первом вызове toString, а затем возвращается то же значение для последующих вызовов.

Унаследовано от:: toString в классе OpenType<CompositeData>
Возвращает:: строковое представление этого экземпляра CompositeType instance

© 1993, 2020, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://docs.oracle.com/en/java/javase/11/docs/api/java.management/javax/management/openmbean/CompositeType.html