Spec-Zone.ru › OpenJDK 8

Класс CompositeDataSupport

  • java.lang.Object
    • javax.management.openmbean.CompositeDataSupport
Все реализуемые интерфейсы:
Serializable, CompositeData

public class CompositeDataSupport
extends Object
implements CompositeData, Serializable

Класс CompositeDataSupport является классом открытых данных, который реализует интерфейс CompositeData.

С:
1.5
См. также:
Форматированный вывод сериализации

Конструкторы

Конструктор и описание
CompositeDataSupport(CompositeType compositeType, Map<String,?> items)

Создаёт экземпляр CompositeDataSupport с указанным compositeType, имена элементов и соответствующие значения которого заданы отображениями в карте items.

CompositeDataSupport(CompositeType compositeType, String[] itemNames, Object[] itemValues)

Создаёт экземпляр CompositeDataSupport с указанным compositeType, значения элементов которого заданы itemValues[], в том же порядке, что и в itemNames[].

Методы

Модификатор и тип Метод и описание
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, имена и соответствующие значения элементов которого заданы отображениями в map 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.

Spec-Zone.ru

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