Класс 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

См. также:

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

Вложенные классы/интерфейсы, объявленные в интерфейсе java.util.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)`	Удаляет значение `CompositeData`, индекс которого — `key`, из этого экземпляра `TabularData` и возвращает удаленное значение, или возвращает `null`, если нет значения, индекс которого — `key`.
`int`	`size()`	Возвращает количество строк в этом экземпляре `TabularDataSupport`.
`String`	`toString()`	Возвращает строковое представление этого экземпляра `TabularDataSupport`.
`Collection<Object>`	`values()`	Возвращает представление коллекции строк, содержащихся в этом экземпляре `TabularDataSupport`.

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

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

Методы, объявленные в интерфейсе java.util.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 или не соответствует определению TabularData этого экземпляра TabularType, этот метод просто возвращает 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 не соответствует определению TabularData этого экземпляра TabularType

get

public CompositeData get(Object[] key)

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

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

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 не соответствует определению TabularData этого экземпляра TabularType; KeyAlreadyExistsException - если ключ для параметра value, вычисленный в соответствии с определением TabularData этого экземпляра TabularType, уже сопоставлен с существующим значением

put

public void put(CompositeData value)

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

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

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

удалить

public Object remove(Object key)

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

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

удалить

public CompositeData remove(Object[] key)

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

Определено в:: remove в интерфейсе TabularData
Параметры:: key - индекс значения, которое необходимо получить в этом экземпляре TabularData; должен быть допустим с определением типа строки этого экземпляра TabularData; не должен быть null.
Возвращает:: предыдущее значение, связанное с указанным ключом, или null, если для ключа не было сопоставления.
Исключения:: NullPointerException - если ключ является null; InvalidKeyException - если ключ не соответствует определению типа строки этого экземпляра 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, вычисленный в соответствии с определением типа строки этого экземпляра TabularData, уже сопоставлен с существующим значением в этом экземпляре, или два значения в t имеют один и тот же индекс.

putAll

public void putAll(CompositeData[] values)

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

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

очистить

public void clear()

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

Определено в:: clear в интерфейсе Map<Object,Object>
Определено в:: clear в интерфейсе TabularData

размер

public int size()

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

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

пустой

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(java.lang.Object), Set.removeAll(java.util.Collection<?>), Set.retainAll(java.util.Collection<?>) и Set.clear(). Он не поддерживает операции Set.add(E) или Set.addAll(java.util.Collection<? extends E>).

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

значения

public Collection<Object> values()

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

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

entrySet

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

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

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

Specified by:

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

Returns:

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

See Also:

clone

public Object clone()

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

Overrides:

clone в классе Object

Returns:

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

See Also:

equals

public boolean equals(Object obj)

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

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

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

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

Specified by:

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

Specified by:

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

Overrides:

equals в классе Object

Parameters:

obj - объект для сравнения на равенство с этим экземпляром TabularDataSupport;

Returns:

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

See Also:

hashCode

public int hashCode()

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

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

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

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

Specified by:

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

Specified by:

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

Overrides:

hashCode в классе Object

Returns:

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

See Also:

toString

public String toString()

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

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

Specified by:: toString в интерфейсе TabularData
Overrides:: toString в классе Object
Returns:: строковое представление этого экземпляра 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://download.java.net/java/early_access/jdk24/docs/api/java.management/javax/management/openmbean/TabularDataSupport.html