Spec-Zone.ru › OpenJDK 24

Интерфейс 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.

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

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

toString

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

Строковое представление состоит из имени реализующего класса, строкового представления типа составного объекта этого экземпляра и строкового представления содержимого (т.е. список сопоставлений itemName=itemValue).

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

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

Spec-Zone.ru

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