Интерфейс CompositeData
- Все известные реализующие классы:
-
CompositeDataSupport,GcInfo
public interface CompositeData
CompositeData определяет поведение специфического типа сложных объектов открытых данных, которые представляют структуры составных данных.- С тех пор:
- 1.5
Краткое описание методов
| Модификатор и тип | Метод | Описание |
|---|---|---|
boolean |
containsKey |
Возвращает true тогда и только тогда, когда этот экземпляр CompositeData содержит элемент с именем key. |
boolean |
containsValue |
Возвращает true тогда и только тогда, когда этот экземпляр CompositeData содержит элемент со значением value. |
boolean |
equals |
Сравнивает указанный параметр obj с этим экземпляром CompositeData на равенство. |
Object |
get |
Возвращает значение элемента с именем key. |
Object[] |
getAll |
Возвращает массив значений элементов, имена которых указаны в 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)
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. - См. также:
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 - См. также:
toString
String toString()
CompositeData. Строковое представление состоит из имени реализуемого класса, строкового представления типа составного объекта этого экземпляра и строкового представления содержимого (т.е. список сопоставлений itemName=itemValue).
- Overrides:
-
toStringв классеObject - Возвращает:
- строковое представление этого экземпляра
CompositeData
© 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/CompositeData.html