Класс CompositeType
- Все реализуемые интерфейсы:
Serializable
public class CompositeType extends OpenType<CompositeData>
CompositeType — это класс открытого типа, экземпляры которого описывают типы значений CompositeData.- С тех пор как:
- 1.5
- См. также:
Краткое описание полей
Поля, объявленные в классе javax.management.openmbean.OpenType
ALLOWED_CLASSNAMES, ALLOWED_CLASSNAMES_LIST
Краткое описание конструкторов
| Конструктор | Описание |
|---|---|
CompositeType |
Создаёт экземпляр CompositeType, проверяя на корректность заданных параметров. |
Краткое описание методов
| Модификатор и тип | Метод | Описание |
|---|---|---|
boolean |
containsKey |
Возвращает true, если этот экземпляр CompositeType определяет элемент с именем itemName. |
boolean |
equals |
Сравнивает указанный параметр obj с этим экземпляром CompositeType на равенство. |
String |
getDescription |
Возвращает описание элемента с именем itemName, или null, если этот экземпляр CompositeType не определяет никакого элемента с именем itemName. |
OpenType |
getType |
Возвращает открытый тип элемента с именем itemName, или null, если этот экземпляр CompositeType не определяет никакого элемента с именем itemName. |
int |
hashCode() |
Возвращает значение хэш-кода для этого экземпляра CompositeType. |
boolean |
isValue |
Проверяет, является ли obj значением, которое может быть описано этим экземпляром CompositeType. |
Set |
keySet() |
Возвращает неизменяемый вид множества всех имён элементов, определённых этим экземпляром CompositeType. |
String |
toString() |
Возвращает строковое представление этого экземпляра CompositeType. |
Методы, объявленные в классе javax.management.openmbean.OpenType
getClassName, getDescription, getTypeName, isArray
Подробное описание конструкторов
CompositeType
public CompositeType(String typeName, String description, String[] itemNames, String[] itemDescriptions, OpenType<?>[] itemTypes) throws OpenDataException
CompositeType, проверяя корректность заданных параметров. Ограничения на корректность для каждого параметра описаны ниже. Обратите внимание, что содержимое трёх массивов itemNames, itemDescriptions и itemTypes копируется внутри, поэтому любые последующие изменения этих массивов вызывающей стороной данного конструктора не повлияют на созданный экземпляр CompositeType.
Имя класса Java для значений составных данных, которые представляет этот тип составных данных (т.е. имя класса, возвращаемое методом getClassName), устанавливается в строковое значение, возвращаемое CompositeData.class.getName().
- Параметры:
-
typeName- Имя, присваиваемое типу составных данных, который представляет этот экземпляр; не может быть null или пустой строкой. -
description- Читабельное описание типа составных данных, который представляет этот экземпляр; не может быть null или пустой строкой. -
itemNames- Имена элементов, содержащихся в значениях составных данных, описываемых этим экземпляромCompositeType; не может быть null и должен содержать как минимум один элемент; ни один элемент не может быть null или пустой строкой. Обратите внимание, что порядок, в котором заданы имена элементов, не важен для различения экземпляровCompositeTypeдруг от друга; имена элементов хранятся внутри в отсортированном по возрастанию алфавитно-цифровомом порядке. -
itemDescriptions- Описания элементов, в том же порядке, что и itemNames, содержащихся в значениях составных данных, описываемых этим экземпляромCompositeType; должен иметь тот же размер, что и itemNames; ни один элемент не может быть null или пустой строкой. -
itemTypes- Экземпляры открытого типа, в том же порядке, что и itemNames, описывающие элементы, содержащиеся в значениях составных данных, описываемых этим экземпляромCompositeType; должен иметь тот же размер, что и itemNames; ни один элемент не может быть null. - Исключения:
-
IllegalArgumentException- Если typeName или description является null или пустой строкой, или itemNames или itemDescriptions или itemTypes является null, или любой элемент itemNames или itemDescriptions является null или пустой строкой, или любой элемент itemTypes является null, или itemNames или itemDescriptions или itemTypes не имеют одинаковый размер. -
OpenDataException- Если itemNames содержит дубликаты имён элементов (чувствительно к регистру, но ведущие и хвостовые пробелы удаляются).
Подробное описание методов
containsKey
public boolean containsKey(String itemName)
true, если этот экземпляр CompositeType определяет элемент с именем itemName.- Параметры:
-
itemName- имя элемента. - Возвращает:
- true, если элемент с данным именем присутствует.
getDescription
public String getDescription(String itemName)
null, если этот экземпляр CompositeType не определяет элемента с именем itemName.- Параметры:
-
itemName- имя элемента. - Возвращает:
- описание.
getType
public OpenType<?> getType(String itemName)
null, если этот экземпляр CompositeType не определяет элемента с именем itemName.- Параметры:
-
itemName- имя элемента. - Возвращает:
- тип.
keySet
public Set<String> keySet()
CompositeType. Итератор набора вернёт имена элементов в порядке возрастания.- Возвращает:
- a
SetofString.
isValue
public boolean isValue(Object obj)
CompositeType. Если obj равно null или не является экземпляром javax.management.openmbean.CompositeData, isValue возвращает false.
Если obj является экземпляром javax.management.openmbean.CompositeData, то пусть ct будет его типом CompositeType, возвращаемым методом CompositeData.getCompositeType(). Результат равен true, если this совместим с ct. Это означает, что:
-
this.getTypeName()равноct.getTypeName(), и - нет имён элементов, присутствующих в
this, которые не присутствуют также вct, и - для каждого элемента в
this, его тип совместим с типом соответствующего элемента вct.
TabularType совместим с другим
TabularType , если у них одинаковые typeName и список имён индексов, а тип строки первого совместим с типом строки второго.
ArrayType совместим с другим
ArrayType , если у них одинаковая размерность; оба являются примитивными массивами или ни один из них не является; и тип элемента первого совместим с типом элемента второго.
Во всех остальных случаях OpenType совместим с другим OpenType только если они равны.
Эти правила означают, что к
CompositeData могут быть добавлены дополнительные элементы, не делая его несовместимым с CompositeType, у которого этих элементов нет.
- Определено в:
-
isValueв классеOpenType<CompositeData> - Параметры:
-
obj- значение, тип которого нужно проверить на совместимость с этим экземпляромCompositeType. - Возвращает:
-
true, если obj является значением для этого типа составных данных,falseв противном случае.
equals
public boolean equals(Object obj)
obj с этим экземпляром CompositeType на равенство. Два экземпляра CompositeType равны тогда и только тогда, когда выполняются все следующие утверждения:
- их имена типа равны
- их имена и типы элементов равны
- Определено в:
-
equalsв классеOpenType<CompositeData> - Параметры:
-
obj- объект, который необходимо сравнить на равенство с этим экземпляромCompositeType; если obj равноnull,equalsвозвращаетfalse. - Возвращает:
-
true, если указанный объект равен этому экземпляруCompositeType. - См. также:
hashCode
public int hashCode()
CompositeType . Хэш-код экземпляра CompositeType - это сумма хэш-кодов всех элементов информации, используемых в сравнениях equals (т.е. имя, имена элементов, типы элементов). Это гарантирует, что t1.equals(t2) подразумевает, что t1.hashCode()==t2.hashCode() для любых двух экземпляров CompositeType t1 и t2, как требуется общим контрактом метода Object.hashCode().
Так как экземпляры CompositeType неизменяемы, хэш-код для этого экземпляра вычисляется один раз при первом вызове hashCode, а затем возвращается то же значение для последующих вызовов.
- Переопределяет:
-
hashCodeв классеObject - Возвращает:
- значение хэш-кода для этого экземпляра
CompositeType - См. также:
toString
public String toString()
CompositeType . Строковое представление состоит из имени этого класса (т.е. javax.management.openmbean.CompositeType), имени типа для этого экземпляра и списка имён элементов и строкового представления типов этого экземпляра.
Так как экземпляры CompositeType неизменяемы, строковое представление для этого экземпляра вычисляется один раз при первом вызове toString, а затем возвращается то же значение для последующих вызовов.
- Определено в:
-
toStringв классеOpenType<CompositeData> - Возвращает:
- строковое представление этого экземпляра
CompositeType
© 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/CompositeType.html