Класс CompositeType

java.lang.Object

javax.management.openmbean.OpenType<CompositeData>

javax.management.openmbean.CompositeType

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

public class CompositeType extends OpenType<CompositeData>

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

С версии:

1.5

См. также:

Краткое описание полей

Поля, объявленные в классе OpenType

ALLOWED_CLASSNAMES, ALLOWED_CLASSNAMES_LIST

Модификатор и тип	Поле	Описание
`static final String[]`	`ALLOWED_CLASSNAMES`	Устарело. Вместо этого используйте `ALLOWED_CLASSNAMES_LIST`.
`static final List<String>`	`ALLOWED_CLASSNAMES_LIST`	Список полных имен Java-классов, разрешенных для значений открытых данных.

Краткое описание конструкторов

Конструктор	Описание
`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`.

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

getClassName, getDescription, getTypeName, isArray

Модификатор и тип	Метод	Описание
`String`	`getClassName()`	Возвращает полное имя класса Java значений открытых данных, описываемых этим открытым типом.
`String`	`getDescription()`	Возвращает текстовое описание этого экземпляра `OpenType`.
`String`	`getTypeName()`	Возвращает имя этого экземпляра `OpenType`.
`boolean`	`isArray()`	Возвращает `true`, если значения открытых данных, описываемые этим открытым типом, являются массивами, и `false` в противном случае.

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

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

Модификатор и тип	Метод	Описание
`protected Object`	`clone()`	Создает и возвращает копию этого объекта.
`protected void`	`finalize()`	Устарело, предназначено для удаления: этот элемент API может быть удален в будущей версии. Финализация устарела и может быть удалена в одном из будущих выпусков.
`final Class<?>`	`getClass()`	Возвращает класс времени выполнения этого объекта `Object`.
`final void`	`notify()`	Пробуждает один поток, ожидающий на мониторе этого объекта.
`final void`	`notifyAll()`	Пробуждает все потоки, ожидающие на мониторе этого объекта.
`final void`	`wait()`	Заставляет текущий поток ожидать, пока он не будет разбужен, обычно посредством уведомления или прерывания.
`final void`	`wait(long timeoutMillis)`	Заставляет текущий поток ожидать, пока он не будет разбужен, обычно посредством уведомления или прерывания, либо пока не истечет заданное время.
`final void`	`wait(long timeoutMillis, int nanos)`	Заставляет текущий поток ожидать, пока он не будет разбужен, обычно посредством уведомления или прерывания, либо пока не истечет заданное время.

Подробное описание конструкторов

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 — описания элементов, содержащихся в значениях составных данных, описываемых этим экземпляром CompositeType, в том же порядке, что и itemNames; размер должен совпадать с размером itemNames; ни один элемент не может быть null или пустой строкой.; itemTypes — экземпляры открытых типов, описывающие элементы, содержащиеся в значениях составных данных, описываемых этим экземпляром CompositeType, в том же порядке, что и itemNames; размер должен совпадать с размером 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)

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

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

keySet

public Set<String> keySet()

Возвращает немодифицируемое представление Set всех имен элементов, определенных этим экземпляром 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, если у них совпадают имя типа и список имен индексов, а тип строки первого является назначаемым из типа строки второго.

Один 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; если obj равен null, equals возвращает false.

Возвращает:

true, если указанный объект равен этому экземпляру CompositeType.

См. также:

hashCode

public int hashCode()

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

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

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

Переопределяет:

hashCode в классе Object

Возвращает:

хеш-код этого экземпляра CompositeType

См. также:

toString

public String toString()

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

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

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

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

© 1993, 2025, 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.