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

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