Класс 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, таким образом, отсортированные в порядке возрастания лексикографического порядка их имён, для более быстрого получения отдельных значений элементов.

Конструктор проверяет, что все ограничения, указанные ниже для каждого параметра, выполняются, и выбрасывает соответствующее исключение, если они не выполняются.

Параметры:
compositeType - тип составного типа этого экземпляра составных данных; не должен быть null.
itemNames - itemNames должен перечислять, в любом порядке, все имена элементов, определённые в compositeType; порядок, в котором перечислены имена, используется для сопоставления значений в itemValues[]; не должен быть null или пустым.
itemValues - значения элементов, перечисленные в том же порядке, что и их соответствующие имена в itemNames; каждое значение элемента может быть null, но если оно не null, оно должно быть допустимым значением для открытого типа, определённого в compositeType для соответствующего элемента; должен иметь такой же размер, как itemNames; не должен быть null или пустым.
Исключение:
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[]).

Параметры:
compositeType - тип составного типа этого экземпляра составных данных; не должен быть null.
items - отображения всех имён элементов на их значения; items должен содержать все имена элементов, определённые в compositeType; не должен быть null или пустым.
Исключение:
IllegalArgumentException - compositeType равно null, или items равно null или пусто, или один из ключей в items является null или пустой строкой.
OpenDataException - размер items отличается от числа элементов, определённых в compositeType, или один из ключей в items не существует как имя элемента, определённое в compositeType, или одно из значений в items не является допустимым значением для соответствующего элемента, как определено в compositeType.
ArrayStoreException - один или несколько ключей в items не являются экземплярами класса java.lang.String.

Методы

getCompositeType

public CompositeType getCompositeType()

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

Указано в:
getCompositeType в интерфейсе CompositeData
Возвращает:
тип этого CompositeData.

get

public Object get(String key)

Возвращает значение элемента с именем key.

Указано в:
get в интерфейсе CompositeData
Параметры:
key - имя элемента.
Возвращает:
значение, связанное с этим ключом.
Исключения:
IllegalArgumentException - если key является null или пустой строкой.
InvalidKeyException - если key не является существующим именем элемента для этого экземпляра CompositeData.

getAll

public Object[] getAll(String[] keys)

Возвращает массив значений элементов, имена которых указаны в keys, в том же порядке, что и в keys.

Указано в:
getAll в интерфейсе CompositeData
Параметры:
keys - имена элементов.
Возвращает:
значения, соответствующие ключам.
Исключения:
IllegalArgumentException - если элемент в keys является null или пустой строкой.
InvalidKeyException - если элемент в keys не является существующим именем элемента для этого экземпляра CompositeData.

containsKey

public boolean containsKey(String key)

Возвращает true, если и только если этот экземпляр CompositeData содержит элемент с именем key. Если key является null или пустой строкой, этот метод просто возвращает false.

Указано в:
containsKey в интерфейсе CompositeData
Параметры:
key - ключ для проверки.
Возвращает:
true, если этот CompositeData содержит ключ.

containsValue

public boolean containsValue(Object value)

Возвращает true, если и только если этот экземпляр CompositeData содержит элемент со значением value.

Указано в:
containsValue в интерфейсе CompositeData
Параметры:
value - значение для проверки.
Возвращает:
true, если этот CompositeData содержит значение.

values

public Collection<?> values()

Возвращает неизменяемый вид коллекции значений элементов, содержащихся в этом экземпляре CompositeData. Итератор возвращаемой коллекции будет возвращать значения в восходящем лексикографическом порядке соответствующих имён элементов.

Указано в:
values в интерфейсе CompositeData
Возвращает:
значения.

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.

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

hashCode

public int hashCode()

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

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

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

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

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

toString

public String toString()

Возвращает строковое представление этого экземпляра CompositeDataSupport.

Строковое представление состоит из имени этого класса (т.е. javax.management.openmbean.CompositeDataSupport), строкового представления составного типа этого экземпляра и строкового представления содержимого (т.е. перечисление сопоставлений itemName=itemValue).

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

© 1993, 2020, 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/11/docs/api/java.management/javax/management/openmbean/CompositeDataSupport.html

Spec-Zone .ru
спецификации, руководства, описания, API