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

Методы, объявленные в классе java.lang.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, поэтому они отсортированы по возрастанию лексикографического порядка их имён для более быстрого извлечения отдельных значений элементов.

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

Parameters:: compositeType - тип составного объекта этого экземпляра составных данных; не должен быть null.; itemNames - itemNames должен перечислять в любом порядке все имена элементов, определённые в compositeType; порядок перечисления имён используется для сопоставления значений с itemValues[]; не должен быть null или пустым.; itemValues - значения элементов, перечисленные в том же порядке, что и соответствующие им имена в itemNames; каждое значение элемента может быть null, но если оно не null, оно должно быть допустимым значением для открытого типа, определённого в compositeType для соответствующего элемента; должно иметь такой же размер, как и itemNames; не должен быть null или пустым.
Throws:: 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[]).

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

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

getCompositeType

public CompositeType getCompositeType()

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

Specified by:: getCompositeType в интерфейсе CompositeData
Returns:: тип этого CompositeData.

get

public Object get(String key)

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

Specified by:: get в интерфейсе CompositeData
Parameters:: key - имя элемента.
Returns:: значение, связанное с этим ключом.
Throws:: IllegalArgumentException - если key имеет значение null или пустая строка.; InvalidKeyException - если key не является существующим именем элемента для этого экземпляра CompositeData.

getAll

public Object[] getAll(String[] keys)

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

Specified by:: getAll в интерфейсе CompositeData
Parameters:: keys - имена элементов.
Returns:: значения, соответствующие ключам.
Throws:: IllegalArgumentException - если элемент в keys имеет значение null или пустая строка.; InvalidKeyException - если элемент в keys не является существующим именем элемента для этого экземпляра CompositeData.

containsKey

public boolean containsKey(String key)

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

Specified by:: containsKey в интерфейсе CompositeData
Parameters:: key - ключ для проверки.
Returns:: true, если этот CompositeData содержит ключ.

containsValue

public boolean containsValue(Object value)

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

Specified by:: containsValue в интерфейсе CompositeData
Parameters:: value - значение для проверки.
Returns:: true, если этот CompositeData содержит значение.

values

public Collection<?> values()

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

Specified by:: values в интерфейсе CompositeData
Returns:: значения.

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.

Specified by:

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

Overrides:

equals в классе Object

Parameters:

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

Returns:

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

See Also:

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.
https://download.java.net/java/early_access/jdk24/docs/api/java.management/javax/management/openmbean/CompositeDataSupport.html