Spec-Zone.ru › OpenJDK 25

Интерфейс CompositeData

Все известные классы-реализации:
CompositeDataSupport, GcInfo
public interface CompositeData
Интерфейс CompositeData определяет поведение объектов определённого типа сложных открытых данных, представляющих структуры составных данных.
Начиная с:
1.5

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

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

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

getCompositeType

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

get

Object get(String key)
Возвращает значение элемента с именем key.
Параметры:
key — имя элемента.
Возвращает:
значение, связанное с этим ключом.
Вызывает исключение:
IllegalArgumentException — если key является null или пустой строкой.
InvalidKeyException — если key не является именем существующего элемента этого экземпляра CompositeData.

getAll

Object[] getAll(String[] keys)
Возвращает массив значений элементов, имена которых указаны в keys, в том же порядке, что и keys.
Параметры:
keys — имена элементов.
Возвращает:
значения, соответствующие ключам.
Вызывает исключение:
IllegalArgumentException — если элемент в keys является null или пустой строкой.
InvalidKeyException — если элемент в keys не является именем существующего элемента этого экземпляра CompositeData.

containsKey

boolean containsKey(String key)
Возвращает true тогда и только тогда, когда этот экземпляр CompositeData содержит элемент с именем key. Если key является null или пустой строкой, этот метод просто возвращает false.
Параметры:
key — ключ для проверки.
Возвращает:
true, если этот CompositeData содержит ключ.

containsValue

boolean containsValue(Object value)
Возвращает true тогда и только тогда, когда этот экземпляр CompositeData содержит элемент со значением value.
Параметры:
value — значение для проверки.
Возвращает:
true, если этот CompositeData содержит значение.

values

Collection<?> values()
Возвращает немодифицируемое представление в виде коллекции значений элементов, содержащихся в этом экземпляре CompositeData. Итератор возвращённой коллекции будет возвращать значения в порядке возрастания лексикографического порядка соответствующих имён элементов.
Возвращает:
значения.

equals

boolean equals(Object obj)
Сравнивает указанный параметр obj с этим экземпляром CompositeData на равенство.

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

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

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

Переопределяет:
equals в классе Object
Параметры:
obj — объект, который сравнивается на равенство с этим экземпляром CompositeData.
Возвращает:
true, если указанный объект равен этому экземпляру CompositeData.
См. также:
  • Object.hashCode()
  • HashMap

hashCode

int hashCode()
Возвращает значение хеш-кода этого экземпляра CompositeData.

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

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

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

Переопределяет:
hashCode в классе Object
Возвращает:
значение хеш-кода этого экземпляра CompositeData
См. также:
  • Object.equals(java.lang.Object)
  • System.identityHashCode(Object)

toString

String toString()
Возвращает строковое представление этого экземпляра CompositeData.

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

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

Сообщить об ошибке или предложить улучшение
Дополнительные справочные материалы по API и документацию для разработчиков см. в документации Java SE, содержащей более подробные описания для разработчиков, обзоры концепций, определения терминов, обходные решения и примеры работающего кода. Другие версии.
Java является товарным знаком или зарегистрированным товарным знаком Oracle и/или её дочерних компаний в США и других странах.
Авторские права © 1993, 2025, Oracle и/или её дочерние компании, 500 Oracle Parkway, Redwood Shores, CA 94065 USA.
Все права защищены. Использование регулируется условиями лицензии и политикой распространения документации.

© 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/CompositeData.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API