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

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

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

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), строкового представления составного типа этого экземпляра и строкового представления его содержимого (то есть списка сопоставлений itemName=itemValue).

Определено в:: 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.