Класс TabularDataSupport
- Все реализуемые интерфейсы:
Serializable, Cloneable, Map<Object,Object>, TabularData
public class TabularDataSupport extends Object implements TabularData, Map<Object,Object>, Cloneable, Serializable
TabularDataSupport — это класс открытых данных, реализующий интерфейсы TabularData и Map и основанный внутри на структуре данных хеш-таблицы.- Начиная с:
- 1.5
- См. также:
Краткое описание вложенных классов
Краткое описание конструкторов
| Конструктор | Описание |
|---|---|
TabularDataSupport |
Создает пустой экземпляр TabularDataSupport с открытым типом tabularType; базовая структура HashMap имеет емкость по умолчанию (101) и коэффициент загрузки по умолчанию (0.75). |
TabularDataSupport |
Создает пустой экземпляр TabularDataSupport с открытым типом tabularType; базовая структура HashMap имеет указанную начальную емкость и коэффициент загрузки. |
Краткое описание методов
| Модификатор и тип | Метод | Описание |
|---|---|---|
Object[] |
calculateIndex |
Вычисляет индекс, который будет использоваться в этом экземпляре TabularData для ссылки на указанный параметр составных данных value, если его добавить в этот экземпляр. |
void |
clear() |
Удаляет все строки из этого экземпляра TabularDataSupport. |
Object |
clone() |
Возвращает клон этого экземпляра TabularDataSupport: клон создается вызовом super.clone() с последующим клонированием базовой карты. |
boolean |
containsKey |
Возвращает true тогда и только тогда, когда этот экземпляр TabularData содержит значение CompositeData (то есть строку) с индексом, равным указанному key. |
boolean |
containsKey |
Возвращает true тогда и только тогда, когда этот экземпляр TabularData содержит значение CompositeData (то есть строку) с индексом, равным указанному key. |
boolean |
containsValue |
Возвращает true тогда и только тогда, когда этот экземпляр TabularData содержит указанное значение. |
boolean |
containsValue |
Возвращает true тогда и только тогда, когда этот экземпляр TabularData содержит указанное значение типа CompositeData. |
Set |
entrySet() |
Возвращает представление в виде коллекции соответствий индексов строкам, содержащихся в этом экземпляре TabularDataSupport. |
boolean |
equals |
Сравнивает указанный параметр obj с этим экземпляром TabularDataSupport на равенство. |
Object |
get |
Этот метод просто вызывает get((Object[]) key). |
CompositeData |
get |
Возвращает значение типа CompositeData с индексом key или null, если в этом экземпляре TabularData нет значения, соответствующего key. |
TabularType |
getTabularType() |
Возвращает табличный тип, описывающий этот экземпляр TabularData. |
int |
hashCode() |
Возвращает хеш-код этого экземпляра TabularDataSupport. |
boolean |
isEmpty() |
Возвращает true, если этот экземпляр TabularDataSupport не содержит строк. |
Set |
keySet() |
Возвращает представление в виде множества ключей базовой карты этого экземпляра TabularDataSupport, используемых для индексации строк. |
Object |
put |
Этот метод просто вызывает put((CompositeData) value) и поэтому игнорирует параметр key, который может быть null. |
void |
put |
Добавляет value в этот экземпляр TabularData. |
void |
putAll |
Добавляет все значения из указанной карты t в этот экземпляр TabularData. |
void |
putAll |
Добавляет все элементы из values в этот экземпляр TabularData. |
Object |
remove |
Этот метод просто вызывает remove((Object[]) key). |
CompositeData |
remove |
Удаляет из этого экземпляра TabularData значение типа CompositeData с индексом key и возвращает удаленное значение; если значения с индексом key нет, возвращает null. |
int |
size() |
Возвращает количество строк в этом экземпляре TabularDataSupport. |
String |
toString() |
Возвращает строковое представление этого экземпляра TabularDataSupport. |
Collection |
values() |
Возвращает представление в виде коллекции строк, содержащихся в этом экземпляре TabularDataSupport. |
Методы, объявленные в классе Object
finalize, getClass, notify, notifyAll, wait, wait, wait | Модификатор и тип | Метод | Описание |
|---|---|---|
protected void |
finalize() |
Устарело, будет удалено: этот элемент API может быть удален в будущей версии. Финализация объявлена устаревшей и будет удалена в одном из будущих выпусков. |
final Class |
getClass() |
Возвращает класс времени выполнения этого Object. |
final void |
notify() |
Пробуждает один поток, ожидающий на мониторе этого объекта. |
final void |
notifyAll() |
Пробуждает все потоки, ожидающие на мониторе этого объекта. |
final void |
wait() |
Переводит текущий поток в состояние ожидания до его пробуждения, обычно посредством уведомления или прерывания. |
final void |
wait |
Переводит текущий поток в состояние ожидания до его пробуждения, обычно посредством уведомления или прерывания, либо до истечения заданного промежутка реального времени. |
final void |
wait |
Переводит текущий поток в состояние ожидания до его пробуждения, обычно посредством уведомления или прерывания, либо до истечения заданного промежутка реального времени. |
Методы, объявленные в интерфейсе Map
compute, computeIfAbsent, computeIfPresent, forEach, getOrDefault, merge, putIfAbsent, remove, replace, replace, replaceAll | Модификатор и тип | Метод | Описание |
|---|---|---|
default Object |
compute |
Пытается вычислить соответствие для указанного ключа и текущего связанного с ним значения либо null, если текущего соответствия нет (необязательная операция). |
default Object |
computeIfAbsent |
Если указанный ключ еще не связан со значением (или ему соответствует null), пытается вычислить его значение с помощью заданной функции отображения и добавить его в эту карту, если результатом не является null (необязательная операция). |
default Object |
computeIfPresent |
Если для указанного ключа имеется ненулевое значение, пытается вычислить новое соответствие на основе ключа и текущего связанного с ним значения (необязательная операция). |
default void |
forEach |
Выполняет заданное действие для каждой записи этой карты, пока не будут обработаны все записи или действие не вызовет исключение. |
default Object |
getOrDefault |
Возвращает значение, соответствующее указанному ключу, или defaultValue, если в этой карте нет соответствия для данного ключа. |
default Object |
merge |
Если указанный ключ еще не связан со значением или связан с null, связывает его с заданным ненулевым значением (необязательная операция). |
default Object |
putIfAbsent |
Если указанный ключ еще не связан со значением (или ему соответствует null), связывает его с заданным значением и возвращает null; в противном случае возвращает текущее значение (необязательная операция). |
default boolean |
remove |
Удаляет запись для указанного ключа, только если в данный момент ему соответствует указанное значение (необязательная операция). |
default Object |
replace |
Заменяет запись для указанного ключа, только если в данный момент ему соответствует какое-либо значение (необязательная операция). |
default boolean |
replace |
Заменяет запись для указанного ключа, только если в данный момент ему соответствует указанное значение (необязательная операция). |
default void |
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, если этому key не сопоставлено значение в данном экземпляре TabularData.- Определено в:
-
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)
TabularDataTabularData. Составной тип 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)
TabularData значение CompositeData, индексом которого является key, и возвращает удаленное значение либо возвращает null, если значения с индексом key нет.- Определено в:
-
removeв интерфейсеTabularData - Параметры:
-
key— индекс значения, которое необходимо получить из этого экземпляраTabularData; должен быть допустимым согласно определению типа строк этого экземпляраTabularData; не может быть равен null. - Возвращает:
- предыдущее значение, связанное с указанным ключом, или
null, если для ключа не было соответствия. - Исключения:
-
NullPointerException— если key равенnull -
InvalidKeyException— если key не соответствует определениюTabularTypeэтого экземпляраTabularData
putAll
public void putAll(Map<?,?> 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)
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
size
isEmpty
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) не поддерживаются.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) не поддерживаются.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.
clone
public Object clone()
TabularDataSupport: клон создается вызовом super.clone(), после чего клонируется базовая карта. Создается только поверхностная копия базовой карты, то есть индексы и значения строк не клонируются, поскольку они неизменяемы.equals
public boolean equals(Object 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), но иметь другой хеш-код, если он вычисляется иначе.
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.