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

Методы, объявленные в интерфейсе javax.management.openmbean.TabularData

put

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

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, если нет значения, отображаемого на key, в этом экземпляре TabularData.

Указано в:
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, уже отображает существующее значение

remove

public Object remove(Object key)

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

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

remove

public CompositeData remove(Object[] key)

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

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

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

putAll

public void putAll(CompositeData[] values)

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

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

values

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()

Возвращает представление в виде коллекции отображений индекс-строка, содержащихся в этом TabularDataSupport экземпляре. Каждый элемент в возвращаемой коллекции является 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 экземпляре.

Определено в:
entrySet в интерфейсе Map<Object,​Object>
Возвращает:
представление в виде коллекции (Set<Map.Entry<List<?>,CompositeData>>) отображений, содержащихся в этом отображении.
См. также:
Map.Entry

clone

public Object clone()

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

Переопределяет:
clone в классе Object
Возвращает:
копию этого экземпляра.
См. также:
Cloneable

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 экземпляру.
См. также:
Object.hashCode(), HashMap

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

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

toString

public String toString()

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

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

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

© 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/TabularDataSupport.html

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