Класс 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) для массивов примитивных типов.

Specified by:

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

Overrides:

hashCode в классе Object

Returns:

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

See Also:

toString

public String toString()

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

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

Specified by:: toString в интерфейсе CompositeData
Overrides:: toString в классе Object
Returns:: строковое представление этого CompositeDataSupport экземпляра

© 1993, 2023, 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/21/docs/api/java.management/javax/management/openmbean/CompositeDataSupport.html