Класс TabularDataSupport

java.lang.Object

javax.management.openmbean.TabularDataSupport

Все реализуемые интерфейсы:: Serializable, Cloneable, Map<Object,Object>, TabularData

public class TabularDataSupport extends Object implements TabularData, Map<Object,Object>, Cloneable, Serializable

Класс TabularDataSupport — это класс открытых данных, реализующий интерфейсы TabularData и Map и основанный внутри на структуре данных в виде хеш-таблицы.

Начиная с:

1.5

См. также:

Краткое описание вложенных классов

Вложенные классы/интерфейсы, объявленные в интерфейсе Map

Map.Entry<K,V>

Краткое описание конструкторов

Конструктор	Описание
`TabularDataSupport(TabularType tabularType)`	Создает пустой экземпляр `TabularDataSupport` с типом открытых данных `tabularType`, базовая структура `HashMap` которого имеет начальную емкость по умолчанию (101) и коэффициент загрузки по умолчанию (0.75).
`TabularDataSupport(TabularType tabularType, int initialCapacity, float loadFactor)`	Создает пустой экземпляр `TabularDataSupport` с типом открытых данных `tabularType`, базовая структура `HashMap` которого имеет указанные начальную емкость и коэффициент загрузки.

Краткое описание методов

Модификатор и тип	Метод	Описание
`Object[]`	`calculateIndex(CompositeData value)`	Вычисляет индекс, который использовался бы в этом экземпляре `TabularData` для ссылки на указанный параметр составных данных `value`, если бы он был добавлен в этот экземпляр.
`void`	`clear()`	Удаляет все строки из этого экземпляра `TabularDataSupport`.
`Object`	`clone()`	Возвращает клон этого экземпляра `TabularDataSupport`: клон создается вызовом `super.clone()` с последующим клонированием базовой карты.
`boolean`	`containsKey(Object key)`	Возвращает `true` тогда и только тогда, когда этот экземпляр `TabularData` содержит значение `CompositeData` (то есть строку) с указанным индексом `key`.
`boolean`	`containsKey(Object[] key)`	Возвращает `true` тогда и только тогда, когда этот экземпляр `TabularData` содержит значение `CompositeData` (то есть строку) с указанным индексом `key`.
`boolean`	`containsValue(Object value)`	Возвращает `true` тогда и только тогда, когда этот экземпляр `TabularData` содержит указанное значение.
`boolean`	`containsValue(CompositeData value)`	Возвращает `true` тогда и только тогда, когда этот экземпляр `TabularData` содержит указанное значение `CompositeData`.
`Set<Map.Entry<Object,Object>>`	`entrySet()`	Возвращает представление в виде коллекции сопоставлений индексов и строк, содержащихся в этом экземпляре `TabularDataSupport`.
`boolean`	`equals(Object obj)`	Сравнивает указанный параметр `obj` с этим экземпляром `TabularDataSupport` на равенство.
`Object`	`get(Object key)`	Этот метод просто вызывает `get((Object[]) key)`.
`CompositeData`	`get(Object[] key)`	Возвращает значение `CompositeData` с индексом `key` или `null`, если в этом экземпляре `TabularData` нет значения, соответствующего `key`.
`TabularType`	`getTabularType()`	Возвращает табличный тип, описывающий этот экземпляр `TabularData`.
`int`	`hashCode()`	Возвращает хеш-код этого экземпляра `TabularDataSupport`.
`boolean`	`isEmpty()`	Возвращает `true`, если этот экземпляр `TabularDataSupport` не содержит строк.
`Set<Object>`	`keySet()`	Возвращает представление в виде множества ключей базовой карты этого экземпляра `TabularDataSupport`, используемых для индексации строк.
`Object`	`put(Object key, Object value)`	Этот метод просто вызывает `put((CompositeData) value)` и поэтому игнорирует параметр `key`, который может быть `null`.
`void`	`put(CompositeData value)`	Добавляет `value` в этот экземпляр `TabularData`.
`void`	`putAll(Map<?,?> t)`	Добавляет все значения, содержащиеся в указанной карте `t`, в этот экземпляр `TabularData`.
`void`	`putAll(CompositeData[] values)`	Добавляет все элементы из `values` в этот экземпляр `TabularData`.
`Object`	`remove(Object key)`	Этот метод просто вызывает `remove((Object[]) key)`.
`CompositeData`	`remove(Object[] key)`	Удаляет из этого экземпляра `TabularData` значение `CompositeData` с индексом `key` и возвращает удаленное значение либо возвращает `null`, если значения с индексом `key` нет.
`int`	`size()`	Возвращает количество строк в этом экземпляре `TabularDataSupport`.
`String`	`toString()`	Возвращает строковое представление этого экземпляра `TabularDataSupport`.
`Collection<Object>`	`values()`	Возвращает представление в виде коллекции строк, содержащихся в этом экземпляре `TabularDataSupport`.

Методы, объявленные в классе Object

finalize, getClass, notify, notifyAll, wait, wait, wait

Методы, объявленные в интерфейсе Map

compute, computeIfAbsent, computeIfPresent, forEach, getOrDefault, merge, putIfAbsent, remove, replace, replace, replaceAll

Подробное описание конструкторов

TabularDataSupport

public TabularDataSupport(TabularType tabularType)

Создает пустой экземпляр TabularDataSupport, типом с открытой структурой которого является tabularType, а базовая HashMap имеет начальную емкость по умолчанию (101) и коэффициент загрузки по умолчанию (0.75).

Этот конструктор просто вызывает this(tabularType, 101, 0.75f);

Параметры:: tabularType — табличный тип, описывающий этот экземпляр TabularData; не может быть равен null.
Исключения:: IllegalArgumentException — если табличный тип равен null.

TabularDataSupport

public TabularDataSupport(TabularType tabularType, int initialCapacity, float loadFactor)

Создает пустой экземпляр TabularDataSupport, типом с открытой структурой которого является tabularType, а базовая HashMap имеет указанную начальную емкость и коэффициент загрузки.

Параметры:: tabularType — табличный тип, описывающий этот экземпляр TabularData; не может быть равен null.; initialCapacity — начальная емкость HashMap.; loadFactor — коэффициент загрузки HashMap
Исключения:: IllegalArgumentException — если начальная емкость меньше нуля, коэффициент загрузки неположителен или табличный тип равен null.

Подробное описание методов

getTabularType

public TabularType getTabularType()

Возвращает табличный тип, описывающий этот экземпляр TabularData.

Указано в:: getTabularType в интерфейсе TabularData
Возвращает:: табличный тип.

calculateIndex

public Object[] calculateIndex(CompositeData value)

Вычисляет индекс, который использовался бы в этом экземпляре TabularData для ссылки на указанный параметр составных данных value, если бы он был добавлен в этот экземпляр. Этот метод проверяет допустимость типа указанного value, но не проверяет, используется ли уже вычисленный индекс для ссылки на значение в этом экземпляре TabularData.

Указано в:: calculateIndex в интерфейсе TabularData
Параметры:: value — значение составных данных, индекс которого в этом экземпляре TabularData необходимо вычислить; должно иметь тот же составной тип, что и тип строк этого экземпляра; не должно быть равно null.
Возвращает:: индекс, который имело бы указанное value в этом экземпляре TabularData.
Исключения:: NullPointerException — если value равно null.; InvalidOpenTypeException — если value не соответствует определению типа строк этого экземпляра TabularData.

containsKey

public boolean containsKey(Object key)

Возвращает true тогда и только тогда, когда этот экземпляр TabularData содержит значение CompositeData (то есть строку), индексом которого является указанный key. Если key нельзя привести к одномерному массиву экземпляров Object, этот метод просто возвращает false; в противном случае он возвращает результат вызова this.containsKey((Object[]) key).

Указано в:: containsKey в интерфейсе Map<Object,Object>
Параметры:: key — значение индекса, наличие которого в этом экземпляре TabularData проверяется.
Возвращает:: true, если этот TabularData индексирует значение строки с указанным ключом.

containsKey

public boolean containsKey(Object[] key)

Возвращает true тогда и только тогда, когда этот экземпляр TabularData содержит значение CompositeData (то есть строку), индексом которого является указанный key. Если key равен null или не соответствует определению TabularType этого экземпляра TabularData, этот метод просто возвращает false.

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

containsValue

public boolean containsValue(CompositeData value)

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

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

containsValue

public boolean containsValue(Object value)

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

Указано в:: containsValue в интерфейсе Map<Object,Object>
Параметры:: value — значение строки, наличие которого в этом экземпляре TabularData проверяется.
Возвращает:: true, если этот экземпляр TabularData содержит указанное значение строки.

get

public Object get(Object key)

Этот метод просто вызывает get((Object[]) key).

Указано в:: get в интерфейсе Map<Object,Object>
Параметры:: key — ключ, значение, связанное с которым, необходимо вернуть
Возвращает:: значение, которому сопоставлен указанный ключ, или null, если эта карта не содержит сопоставления для ключа
Исключения:: NullPointerException — если key равен null; ClassCastException — если тип key не соответствует Object[]; InvalidKeyException — если key не соответствует определению TabularType этого экземпляра TabularData

get

public CompositeData get(Object[] key)

Возвращает значение CompositeData с индексом key или null, если в этом экземпляре TabularData нет значения, сопоставленного с key.

Указано в:: get в интерфейсе TabularData
Параметры:: key — индекс значения, которое нужно получить из этого экземпляра TabularData; должен быть допустимым согласно определению типа строк этого экземпляра TabularData; не должен быть равен null.
Возвращает:: значение, соответствующее key.
Исключения:: NullPointerException — если key равен null; InvalidKeyException — если key не соответствует определению типа TabularType этого экземпляра TabularData.

put

public Object put(Object key, Object value)

Этот метод просто вызывает put((CompositeData) value) и поэтому игнорирует параметр key, который может быть равен null.

Указано в:: put в интерфейсе Map<Object,Object>
Параметры:: key — игнорируемый параметр.; value — значение CompositeData, которое нужно добавить.
Возвращает:: добавленное значение
Исключения:: NullPointerException — если value равно null; ClassCastException — если тип value не соответствует CompositeData; InvalidOpenTypeException — если value не соответствует определению TabularType этого экземпляра TabularData; KeyAlreadyExistsException — если ключ параметра value, вычисленный согласно определению TabularType этого экземпляра TabularData, уже сопоставлен с существующим значением

put

public void put(CompositeData value)

Описание скопировано из интерфейса: TabularData

Добавляет value в этот экземпляр TabularData. Составной тип value должен совпадать с типом строк этого экземпляра (то есть составным типом, возвращаемым методом this.getTabularType().getRowType()), и в этом экземпляре TabularData не должно быть существующего значения с индексом, совпадающим с вычисленным для добавляемого value. Индекс для value вычисляется согласно определению TabularType этого экземпляра TabularData (см. TabularType.getIndexNames()).

Указано в:: put в интерфейсе TabularData
Параметры:: value — значение составных данных, добавляемое в качестве новой строки в этот экземпляр TabularData; должно иметь тот же составной тип, что и тип строк этого экземпляра; не должно быть равно null.

remove

public Object remove(Object key)

Этот метод просто вызывает remove((Object[]) key).

Указано в:: remove в интерфейсе Map<Object,Object>
Параметры:: key — Object[], представляющий удаляемый ключ.
Возвращает:: предыдущее значение, связанное с указанным ключом, или null, если сопоставления для ключа не было.
Исключения:: NullPointerException — если key равен null; ClassCastException — если тип key не соответствует Object[]; InvalidKeyException — если key не соответствует определению TabularType этого экземпляра TabularData

remove

public CompositeData remove(Object[] key)

Удаляет значение CompositeData с индексом key из этого экземпляра TabularData и возвращает удаленное значение либо возвращает null, если значения с индексом key нет.

Указано в:: remove в интерфейсе TabularData
Параметры:: key — индекс значения, которое нужно получить из этого экземпляра TabularData; должен быть допустимым согласно определению типа строк этого экземпляра TabularData; не должен быть равен null.
Возвращает:: предыдущее значение, связанное с указанным ключом, или null, если сопоставления для ключа не было.
Исключения:: NullPointerException — если key равен null; InvalidKeyException — если key не соответствует определению TabularType этого экземпляра TabularData

putAll

public void putAll(Map<?,?> t)

Добавляет все значения, содержащиеся в указанной карте t, в этот экземпляр TabularData. Этот метод преобразует коллекцию значений, содержащихся в этой карте, в массив значений CompositeData, если это возможно, а затем вызывает метод putAll(CompositeData[]). Обратите внимание, что ключи указанной карты t игнорируются. Этот метод, например, позволяет добавить содержимое другого экземпляра TabularData с тем же типом строк (но, возможно, с другими именами индексов) в этот экземпляр.

Указано в:: putAll в интерфейсе Map<Object,Object>
Параметры:: t — карта, значения которой добавляются в качестве новых строк в этот экземпляр TabularData; если t равно null или пуста, метод завершается без выполнения каких-либо действий.
Исключения:: NullPointerException — если значение в t равно null.; ClassCastException — если значение в t не является экземпляром CompositeData.; InvalidOpenTypeException — если значение в t не соответствует определению типа строк этого экземпляра TabularData.; KeyAlreadyExistsException — если индекс значения в t, вычисленный согласно определению TabularType этого экземпляра TabularData, уже сопоставлен с существующим значением в этом экземпляре либо два значения в t имеют одинаковый индекс.

putAll

public void putAll(CompositeData[] values)

Добавляет все элементы values в этот экземпляр TabularData. Если какой-либо элемент values не удовлетворяет ограничениям, определенным в put, или если любые два элемента values имеют одинаковый индекс, вычисленный согласно определению TabularType этого экземпляра TabularData, выбрасывается исключение с описанием ошибки, и ни один элемент values не добавляется, поэтому этот экземпляр TabularData остается без изменений.

Указано в:: putAll в интерфейсе TabularData
Параметры:: values — массив значений составных данных, добавляемых в качестве новых строк в этот экземпляр TabularData; если values равен null или пуст, метод завершается без выполнения каких-либо действий.
Исключения:: NullPointerException — если элемент values равен null; InvalidOpenTypeException — если элемент values не соответствует определению типа строк этого экземпляра TabularData (то есть его определению TabularType); KeyAlreadyExistsException — если индекс элемента values, вычисленный согласно определению TabularType этого экземпляра TabularData, уже сопоставлен с существующим значением в этом экземпляре либо два элемента values имеют одинаковый индекс

clear

public void clear()

Удаляет все строки из этого экземпляра TabularDataSupport.

Указано в:: clear в интерфейсе Map<Object,Object>
Указано в:: clear в интерфейсе TabularData

size

public int size()

Возвращает количество строк в этом экземпляре TabularDataSupport.

Указано в:: size в интерфейсе Map<Object,Object>
Указано в:: size в интерфейсе TabularData
Возвращает:: количество строк в этом экземпляре TabularDataSupport.

isEmpty

public boolean isEmpty()

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

Указано в:: isEmpty в интерфейсе Map<Object,Object>
Указано в:: isEmpty в интерфейсе TabularData
Возвращает:: true, если этот экземпляр TabularDataSupport не содержит строк.

keySet

public Set<Object> keySet()

Возвращает представление в виде множества ключей базовой карты этого экземпляра TabularDataSupport, используемых для индексации строк. Каждый ключ этого Set является неизменяемым List<?>, поэтому возвращаемое представление в виде множества является Set<List<?>>, но для совместимости объявлено как Set<Object>. Множество поддерживается базовой картой этого экземпляра TabularDataSupport, поэтому изменения экземпляра TabularDataSupport отражаются в множестве и наоборот. Множество поддерживает удаление элементов, которое удаляет соответствующую строку из этого экземпляра TabularDataSupport с помощью операций Iterator.remove(), Set.remove(Object), Set.removeAll(Collection), Set.retainAll(Collection) и Set.clear(). Оно не поддерживает операции Set.add(E) или Set.addAll(Collection).

Указано в:: keySet в интерфейсе Map<Object,Object>
Указано в:: keySet в интерфейсе TabularData
Возвращает:: представление в виде множества (Set<List<?>>) ключей, используемых для индексации строк этого экземпляра TabularDataSupport.

values

public Collection<Object> values()

Возвращает представление в виде коллекции строк, содержащихся в этом экземпляре TabularDataSupport. Возвращаемая Collection является Collection<CompositeData>, но для совместимости объявлена как Collection<Object>. Возвращаемую коллекцию можно использовать для перебора значений. Коллекция поддерживается базовой картой, поэтому изменения экземпляра TabularDataSupport отражаются в коллекции и наоборот. Коллекция поддерживает удаление элементов, которое удаляет из этого экземпляра TabularDataSupport соответствующее сопоставление индекса и строки с помощью операций Iterator.remove(), Collection.remove(Object), Collection.removeAll(Collection), Collection.retainAll(Collection) и Collection.clear(). Она не поддерживает операции Collection.add(E) или Collection.addAll(Collection).

Указано в:: values в интерфейсе Map<Object,Object>
Указано в:: values в интерфейсе TabularData
Возвращает:: представление в виде коллекции (Collection<CompositeData>) значений, содержащихся в этом экземпляре TabularDataSupport.

entrySet

public Set<Map.Entry<Object,Object>> entrySet()

Возвращает представление в виде коллекции сопоставлений индексов и строк, содержащихся в этом экземпляре TabularDataSupport. Каждый элемент возвращаемой коллекции является Map.Entry<List<?>,CompositeData>, но для совместимости объявлен как Map.Entry<Object,Object>. Каждый ключ записи карты представляет собой неизменяемый List<?>. Коллекция поддерживается базовой картой этого экземпляра TabularDataSupport, поэтому изменения экземпляра TabularDataSupport отражаются в коллекции и наоборот. Коллекция поддерживает удаление элементов, которое удаляет соответствующее сопоставление из карты с помощью операций Iterator.remove(), Collection.remove(Object), Collection.removeAll(Collection), Collection.retainAll(Collection) и Collection.clear(). Она не поддерживает операции Collection.add(E) или Collection.addAll(Collection).

ВАЖНОЕ УВЕДОМЛЕНИЕ: Не используйте метод setValue элементов Map.Entry, содержащихся в возвращаемом представлении коллекции. Это приведет к повреждению сопоставлений индексов и строк, содержащихся в этом экземпляре TabularDataSupport.

Указано в:

entrySet в интерфейсе Map<Object,Object>

Возвращает:

представление в виде коллекции (Set<Map.Entry<List<?>,CompositeData>>) сопоставлений, содержащихся в этой карте.

См. также:

clone

public Object clone()

Возвращает клон этого экземпляра TabularDataSupport: клон создается вызовом super.clone(), после чего клонируется базовая карта. Создается только поверхностный клон базовой карты, то есть индексы и значения строк не клонируются, поскольку они неизменяемы.

Переопределяет:

clone в классе Object

Возвращает:

клон этого экземпляра.

См. также:

equals

public boolean equals(Object obj)

Сравнивает указанный параметр obj с этим экземпляром TabularDataSupport на равенство.

Возвращает true тогда и только тогда, когда истинны все следующие утверждения:

obj не равен null,
obj также реализует интерфейс TabularData,
их табличные типы равны
их содержимое (то есть все значения CompositeData) равно.

Это гарантирует корректную работу метода equals для параметров obj, представляющих собой различные реализации интерфейса TabularData.

Указано в:

equals в интерфейсе Map<Object,Object>

Указано в:

equals в интерфейсе TabularData

Переопределяет:

equals в классе Object

Параметры:

obj — объект, который сравнивается на равенство с этим экземпляром TabularDataSupport;

Возвращает:

true, если указанный объект равен этому экземпляру TabularDataSupport.

См. также:

hashCode

public int hashCode()

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

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

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

Однако обратите внимание, что другой экземпляр класса, реализующего интерфейс TabularData, может быть равен этому экземпляру TabularDataSupport согласно определению equals(Object), но иметь другой хеш-код, если он вычисляется иначе.

Указано в:

hashCode в интерфейсе Map<Object,Object>

Указано в:

hashCode в интерфейсе TabularData

Переопределяет:

hashCode в классе Object

Возвращает:

значение хеш-кода этого экземпляра TabularDataSupport

См. также:

toString

public String toString()

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

Строковое представление состоит из имени этого класса (то есть javax.management.openmbean.TabularDataSupport), строкового представления табличного типа этого экземпляра и строкового представления содержимого (то есть списка сопоставлений ключ=значение, возвращаемого при вызове dataMap.toString()).

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

© 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://docs.oracle.com/en/java/javase/25/docs/api/java.management/javax/management/openmbean/TabularDataSupport.html