Класс 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, 2021, 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/17/docs/api/java.management/javax/management/openmbean/CompositeDataSupport.html