Класс CompositeDataSupport

java.lang.Object

javax.management.openmbean.CompositeDataSupport

Все реализуемые интерфейсы:: Serializable, CompositeData

public class CompositeDataSupport extends Object implements CompositeData, Serializable

Класс CompositeDataSupport — это класс открытых данных, реализующий интерфейс CompositeData.

Начиная с:

1.5

См. также:

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

Конструктор	Описание
`CompositeDataSupport(CompositeType compositeType, String[] itemNames, Object[] itemValues)`	Создает экземпляр `CompositeDataSupport` с указанным `compositeType`, значения элементов которого заданы в `itemValues[]` в том же порядке, что и в `itemNames[]`.
`CompositeDataSupport(CompositeType compositeType, Map<String,?> items)`	Создает экземпляр `CompositeDataSupport` с указанным `compositeType`, имена элементов и соответствующие значения которых заданы отображениями в карте `items`.

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

Модификатор и тип	Метод	Описание
`boolean`	`containsKey(String key)`	Возвращает `true` тогда и только тогда, когда этот экземпляр `CompositeData` содержит элемент с именем `key`.
`boolean`	`containsValue(Object value)`	Возвращает `true` тогда и только тогда, когда этот экземпляр `CompositeData` содержит элемент со значением `value`.
`boolean`	`equals(Object obj)`	Сравнивает указанный параметр `obj` с этим экземпляром `CompositeDataSupport` на равенство.
`Object`	`get(String key)`	Возвращает значение элемента с именем `key`.
`Object[]`	`getAll(String[] keys)`	Возвращает массив значений элементов, имена которых указаны в `keys`, в том же порядке, что и в `keys`.
`CompositeType`	`getCompositeType()`	Возвращает составной тип этого экземпляра составных данных.
`int`	`hashCode()`	Возвращает хеш-код этого экземпляра `CompositeDataSupport`.
`String`	`toString()`	Возвращает строковое представление этого экземпляра `CompositeDataSupport`.
`Collection<?>`	`values()`	Возвращает немодифицируемое представление в виде коллекции значений элементов, содержащихся в этом экземпляре `CompositeData`.

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

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

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

CompositeDataSupport

public CompositeDataSupport(CompositeType compositeType, String[] itemNames, Object[] itemValues) throws OpenDataException

Создает экземпляр CompositeDataSupport с указанным compositeType, значения элементов которого заданы в itemValues[] в том же порядке, что и в itemNames[]. Поскольку CompositeType не задает порядок своих элементов, параметр itemNames[] используется для указания порядка, в котором значения передаются в itemValues[]. Элементы этого экземпляра CompositeDataSupport хранятся внутри в TreeMap и, следовательно, упорядочены по возрастанию в лексикографическом порядке их имен, что ускоряет получение значений отдельных элементов.

Конструктор проверяет выполнение всех перечисленных ниже ограничений для каждого параметра и выбрасывает соответствующее исключение, если они не выполняются.

Параметры:: compositeType — составной тип этого экземпляра составных данных; не должен быть null.; itemNames — itemNames должен содержать в любом порядке все имена элементов, определенные в compositeType; порядок перечисления имен используется для сопоставления значений в itemValues[]; не должен быть null или пустым.; itemValues — значения элементов, перечисленные в том же порядке, что и соответствующие имена в itemNames; значение каждого элемента может быть null, но если оно не null, оно должно быть допустимым значением открытого типа, определенного в compositeType для соответствующего элемента; размер должен совпадать с размером itemNames; не должен быть null или пустым.
Выбрасывает:: IllegalArgumentException — если compositeType равен null, или itemNames[] либо itemValues[] равен null или пуст, или один из элементов в itemNames[] является null или пустой строкой, или itemNames[] и itemValues[] имеют разные размеры.; OpenDataException — если размер itemNames[] или itemValues[] отличается от количества элементов, определенных в compositeType, или один из элементов в itemNames[] не существует как имя элемента, определенное в compositeType, или один из элементов в itemValues[] не является допустимым значением соответствующего элемента, определенного в compositeType.

CompositeDataSupport

public CompositeDataSupport(CompositeType compositeType, Map<String,?> items) throws OpenDataException

Создает экземпляр CompositeDataSupport с указанным compositeType, имена элементов и соответствующие значения которых заданы отображениями в карте items. Этот конструктор преобразует ключи в массив строк, а значения — в массив объектов и вызывает CompositeDataSupport(javax.management.openmbean.CompositeType, java.lang.String[], java.lang.Object[]).

Параметры:: compositeType — составной тип этого экземпляра составных данных; не должен быть null.; items — отображения всех имен элементов в их значения; items должна содержать все имена элементов, определенные в compositeType; не должна быть null или пустой.
Выбрасывает:: IllegalArgumentException — если compositeType равен null, или items равен null или пуст, или один из ключей в items является null или пустой строкой.; OpenDataException — если размер items отличается от количества элементов, определенных в compositeType, или один из ключей в items не существует как имя элемента, определенное в compositeType, или одно из значений в items не является допустимым значением соответствующего элемента, определенного в compositeType.; ArrayStoreException — если один или несколько ключей в items не принадлежат к классу java.lang.String.

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

getCompositeType

public CompositeType getCompositeType()

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

Определено в:: getCompositeType в интерфейсе CompositeData
Возвращает:: тип этих CompositeData.

get

public Object get(String key)

Возвращает значение элемента с именем key.

Определено в:: get в интерфейсе CompositeData
Параметры:: key — имя элемента.
Возвращает:: значение, связанное с этим ключом.
Выбрасывает:: IllegalArgumentException — если key является null или пустой строкой.; InvalidKeyException — если key не является существующим именем элемента в этом экземпляре CompositeData.

getAll

public Object[] getAll(String[] keys)

Возвращает массив значений элементов, имена которых указаны в keys, в том же порядке, что и в keys.

Определено в:: getAll в интерфейсе CompositeData
Параметры:: keys — имена элементов.
Возвращает:: значения, соответствующие ключам.
Выбрасывает:: IllegalArgumentException — если элемент в keys является null или пустой строкой.; InvalidKeyException — если элемент в keys не является существующим именем элемента в этом экземпляре CompositeData.

containsKey

public boolean containsKey(String key)

Возвращает true тогда и только тогда, когда этот экземпляр CompositeData содержит элемент с именем key. Если key является null или пустой строкой, этот метод просто возвращает false.

Определено в:: containsKey в интерфейсе CompositeData
Параметры:: key — проверяемый ключ.
Возвращает:: true, если этот CompositeData содержит ключ.

containsValue

public boolean containsValue(Object value)

Возвращает true тогда и только тогда, когда этот экземпляр CompositeData содержит элемент со значением value.

Определено в:: containsValue в интерфейсе CompositeData
Параметры:: value — проверяемое значение.
Возвращает:: true, если этот CompositeData содержит значение.

values

public Collection<?> values()

Возвращает немодифицируемое представление в виде коллекции значений элементов, содержащихся в этом экземпляре CompositeData. Итератор возвращенной коллекции возвращает значения в порядке возрастания имен соответствующих элементов в лексикографическом порядке.

Определено в:: values в интерфейсе CompositeData
Возвращает:: значения.

equals

public boolean equals(Object obj)

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

Возвращает true тогда и только тогда, когда выполняются все следующие условия:

obj не равен null,
obj также реализует интерфейс CompositeData,
их составные типы равны
их содержимое, то есть пары (имя, значение), совпадает. Если значение в содержимом является массивом, сравнение значений выполняется так, как если бы для массивов ссылочных типов объектов вызывался метод deepEquals, или соответствующая перегрузка Arrays.equals(e1,e2) для массивов примитивных типов

Это гарантирует, что метод equals корректно работает с параметрами obj, представляющими собой различные реализации интерфейса CompositeData, с учетом ограничений, указанных в методе equals интерфейса java.util.Collection.

Определено в:

equals в интерфейсе CompositeData

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

equals в классе Object

Параметры:

obj — объект, который сравнивается на равенство с этим экземпляром CompositeDataSupport.

Возвращает:

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

См. также:

hashCode

public int hashCode()

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

Хеш-код экземпляра CompositeDataSupport представляет собой сумму хеш-кодов всех элементов информации, используемых при сравнении equals (то есть его составного типа и всех значений элементов).

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

Хеш-код каждого значения элемента добавляется к возвращаемому хеш-коду. Если значение элемента является массивом, его хеш-код вычисляется так, как если бы для массивов ссылочных типов объектов вызывался метод deepHashCode, или соответствующая перегрузка Arrays.hashCode(e) для массивов примитивных типов.

Определено в:

hashCode в интерфейсе CompositeData

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

hashCode в классе Object

Возвращает:

значение хеш-кода этого экземпляра CompositeDataSupport

См. также:

toString

public String toString()

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

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

Определено в:: toString в интерфейсе CompositeData
Переопределяет:: toString в классе Object
Возвращает:: строковое представление этого экземпляра CompositeDataSupport

© 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.
https://docs.oracle.com/en/java/javase/25/docs/api/java.management/javax/management/openmbean/CompositeDataSupport.html