Класс TabularDataSupport

public TabularDataSupport(TabularType tabularType)

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

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

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

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

public TabularType getTabularType()

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

public Object[] calculateIndex(CompositeData value)

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

public boolean containsKey(Object key)

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

public boolean containsKey(Object[] key)

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

public boolean containsValue(CompositeData value)

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

public boolean containsValue(Object value)

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

public Object get(Object key)

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

public CompositeData get(Object[] key)

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

public Object put(Object key, Object value)

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

public void put(CompositeData value)

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

public Object remove(Object key)

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

public CompositeData remove(Object[] key)

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

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

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

public void putAll(CompositeData[] values)

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

public void clear()

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

public int size()

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

public boolean isEmpty()

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

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

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

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

public Object clone()

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

public boolean equals(Object obj)

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

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

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

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

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

public String toString()

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

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