Класс AbstractTableModel

java.lang.Object

javax.swing.table.AbstractTableModel

Все реализуемые интерфейсы:: Serializable, TableModel

Прямые известные подклассы:: DefaultTableModel

public abstract class AbstractTableModel extends Object implements TableModel, Serializable

Этот абстрактный класс предоставляет реализации по умолчанию для большинства методов интерфейса TableModel. Он управляет слушателями и предоставляет некоторые удобные средства для создания TableModelEvents и отправки их слушателям. Чтобы создать конкретный TableModel в виде подкласса AbstractTableModel, достаточно реализовать следующие три метода:

 public int getRowCount();
 public int getColumnCount();
 public Object getValueAt(int row, int column);

Предупреждение: Сериализованные объекты этого класса не будут совместимы с будущими выпусками Swing. Текущая поддержка сериализации предназначена для кратковременного хранения или RMI между приложениями, работающими с одной и той же версией Swing. Начиная с версии 1.4, в пакете java.beans добавлена поддержка долговременного хранения всех JavaBeans. См. XMLEncoder.

Краткое описание полей

Модификатор и тип	Поле	Описание
`protected EventListenerList`	`listenerList`	Список слушателей

Краткое описание конструкторов

AbstractTableModel()

Модификатор	Конструктор	Описание
`protected`	Конструктор для вызова из подклассов.

Краткое описание методов

Модификатор и тип	Метод	Описание
`void`	`addTableModelListener(TableModelListener l)`	Добавляет слушателя в список, получающий уведомления при каждом изменении модели данных.
`int`	`findColumn(String columnName)`	Возвращает столбец по его имени.
`void`	`fireTableCellUpdated(int row, int column)`	Уведомляет всех слушателей об обновлении значения ячейки в `[row, column]`.
`void`	`fireTableChanged(TableModelEvent e)`	Пересылает указанное событие уведомления всем `TableModelListeners`, зарегистрировавшимся в качестве слушателей этой модели таблицы.
`void`	`fireTableDataChanged()`	Уведомляет всех слушателей о том, что значения всех ячеек в строках таблицы могли измениться.
`void`	`fireTableRowsDeleted(int firstRow, int lastRow)`	Уведомляет всех слушателей об удалении строк в диапазоне `[firstRow, lastRow]` включительно.
`void`	`fireTableRowsInserted(int firstRow, int lastRow)`	Уведомляет всех слушателей о вставке строк в диапазоне `[firstRow, lastRow]` включительно.
`void`	`fireTableRowsUpdated(int firstRow, int lastRow)`	Уведомляет всех слушателей об обновлении строк в диапазоне `[firstRow, lastRow]` включительно.
`void`	`fireTableStructureChanged()`	Уведомляет всех слушателей об изменении структуры таблицы.
`Class<?>`	`getColumnClass(int columnIndex)`	Возвращает `Object.class` независимо от `columnIndex`.
`String`	`getColumnName(int column)`	Возвращает имя столбца по умолчанию, используя обозначения электронных таблиц: A, B, C, ...
`<T extends EventListener> T[]`	`getListeners(Class<T> listenerType)`	Возвращает массив всех объектов, зарегистрированных в настоящее время как `FooListener` для этого `AbstractTableModel`.
`TableModelListener[]`	`getTableModelListeners()`	Возвращает массив всех слушателей модели таблицы, зарегистрированных в этой модели.
`boolean`	`isCellEditable(int rowIndex, int columnIndex)`	Возвращает false.
`void`	`removeTableModelListener(TableModelListener l)`	Удаляет слушателя из списка, получающего уведомления при каждом изменении модели данных.
`void`	`setValueAt(Object aValue, int rowIndex, int columnIndex)`	Эта пустая реализация предоставлена, чтобы пользователям не приходилось реализовывать этот метод, если их модель данных не допускает редактирования.

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

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Модификатор и тип	Метод	Описание
`protected Object`	`clone()`	Создает и возвращает копию этого объекта.
`boolean`	`equals(Object obj)`	Указывает, равен ли этот объект какому-либо другому объекту.
`protected void`	`finalize()`	Устарело, будет удалено: этот элемент API планируется удалить в будущей версии. Финализация устарела и будет удалена в одном из будущих выпусков.
`final Class<?>`	`getClass()`	Возвращает класс времени выполнения этого `Object`.
`int`	`hashCode()`	Возвращает хеш-код этого объекта.
`final void`	`notify()`	Пробуждает один поток, ожидающий на мониторе этого объекта.
`final void`	`notifyAll()`	Пробуждает все потоки, ожидающие на мониторе этого объекта.
`String`	`toString()`	Возвращает строковое представление объекта.
`final void`	`wait()`	Приостанавливает текущий поток до его пробуждения, обычно в результате получения уведомления или прерывания.
`final void`	`wait(long timeoutMillis)`	Приостанавливает текущий поток до его пробуждения, обычно в результате получения уведомления или прерывания, либо до истечения определенного времени.
`final void`	`wait(long timeoutMillis, int nanos)`	Приостанавливает текущий поток до его пробуждения, обычно в результате получения уведомления или прерывания, либо до истечения определенного времени.

Методы, объявленные в интерфейсе TableModel

getColumnCount, getRowCount, getValueAt

Модификатор и тип	Метод	Описание
`int`	`getColumnCount()`	Возвращает количество столбцов в модели.
`int`	`getRowCount()`	Возвращает количество строк в модели.
`Object`	`getValueAt(int rowIndex, int columnIndex)`	Возвращает значение ячейки в `columnIndex` и `rowIndex`.

Подробное описание полей

listenerList

protected EventListenerList listenerList

Список слушателей

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

AbstractTableModel

protected AbstractTableModel()

Конструктор для вызова из подклассов.

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

getColumnName

public String getColumnName(int column)

Возвращает имя столбца по умолчанию, используя обозначения электронных таблиц: A, B, C, ... Z, AA, AB и т. д. Если column не удается найти, возвращается пустая строка.

Определено в:: getColumnName в интерфейсе TableModel
Параметры:: column — столбец, для которого выполняется запрос
Возвращает:: строку с именем column по умолчанию

findColumn

public int findColumn(String columnName)

Возвращает столбец по его имени. Реализация простая, поэтому этот метод следует переопределить, если он будет вызываться часто. Этот метод не входит в интерфейс TableModel и не используется JTable.

Параметры:: columnName — строка с именем искомого столбца
Возвращает:: столбец с columnName или -1, если он не найден

getColumnClass

public Class<?> getColumnClass(int columnIndex)

Возвращает Object.class независимо от columnIndex.

Определено в:: getColumnClass в интерфейсе TableModel
Параметры:: columnIndex — столбец, для которого выполняется запрос
Возвращает:: Object.class

isCellEditable

public boolean isCellEditable(int rowIndex, int columnIndex)

Возвращает false. Это реализация по умолчанию для всех ячеек.

Определено в:

isCellEditable в интерфейсе TableModel

Параметры:

rowIndex — строка, для которой выполняется запрос

columnIndex — столбец, для которого выполняется запрос

Возвращает:

false

См. также:

setValueAt

public void setValueAt(Object aValue, int rowIndex, int columnIndex)

Эта пустая реализация предоставлена, чтобы пользователям не приходилось реализовывать этот метод, если их модель данных не допускает редактирования.

Определено в:

setValueAt в интерфейсе TableModel

Параметры:

aValue — значение, присваиваемое ячейке

rowIndex — строка ячейки

columnIndex — столбец ячейки

См. также:

addTableModelListener

public void addTableModelListener(TableModelListener l)

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

Определено в:: addTableModelListener в интерфейсе TableModel
Параметры:: l — TableModelListener

removeTableModelListener

public void removeTableModelListener(TableModelListener l)

Удаляет слушателя из списка, получающего уведомления при каждом изменении модели данных.

Определено в:: removeTableModelListener в интерфейсе TableModel
Параметры:: l — TableModelListener

getTableModelListeners

public TableModelListener[] getTableModelListeners()

Возвращает массив всех слушателей модели таблицы, зарегистрированных в этой модели.

Возвращает:

все TableModelListener этой модели или пустой массив, если в данный момент не зарегистрировано ни одного слушателя модели таблицы

Начиная с версии:

1.4

См. также:

fireTableDataChanged

public void fireTableDataChanged()

Уведомляет всех слушателей о том, что значения всех ячеек в строках таблицы могли измениться. Количество строк также могло измениться, поэтому JTable следует перерисовать таблицу с нуля. Предполагается, что структура таблицы (то есть порядок столбцов) осталась прежней.

См. также:

fireTableStructureChanged

public void fireTableStructureChanged()

Уведомляет всех слушателей об изменении структуры таблицы. Количество столбцов таблицы, а также имена и типы новых столбцов могут отличаться от предыдущего состояния. Если JTable получает это событие и его флаг autoCreateColumnsFromModel установлен, он удаляет все имевшиеся столбцы таблицы и создает столбцы по умолчанию в порядке их появления в модели. Это эквивалентно вызову setModel(TableModel) для JTable.

См. также:

fireTableRowsInserted

public void fireTableRowsInserted(int firstRow, int lastRow)

Уведомляет всех слушателей о вставке строк в диапазоне [firstRow, lastRow] включительно.

Параметры:

firstRow — первая строка

lastRow — последняя строка

См. также:

fireTableRowsUpdated

public void fireTableRowsUpdated(int firstRow, int lastRow)

Уведомляет всех слушателей об обновлении строк в диапазоне [firstRow, lastRow] включительно.

Параметры:

firstRow — первая строка

lastRow — последняя строка

См. также:

fireTableRowsDeleted

public void fireTableRowsDeleted(int firstRow, int lastRow)

Уведомляет всех слушателей об удалении строк в диапазоне [firstRow, lastRow] включительно.

Параметры:

firstRow — первая строка

lastRow — последняя строка

См. также:

fireTableCellUpdated

public void fireTableCellUpdated(int row, int column)

Уведомляет всех слушателей об обновлении значения ячейки в [row, column].

Параметры:

row — строка обновленной ячейки

column — столбец обновленной ячейки

См. также:

fireTableChanged

public void fireTableChanged(TableModelEvent e)

Пересылает указанное событие уведомления всем TableModelListeners, зарегистрировавшимся в качестве слушателей этой модели таблицы.

Параметры:

e — пересылаемое событие

См. также:

getListeners

public <T extends EventListener> T[] getListeners(Class<T> listenerType)

Возвращает массив всех объектов, зарегистрированных в данный момент как FooListener для этого AbstractTableModel. Регистрация FooListener выполняется с помощью метода addFooListener.

В аргументе listenerType можно указать литерал класса, например FooListener.class. Например, чтобы получить слушателей модели таблицы модели m, можно использовать следующий код:

TableModelListener[] tmls = (TableModelListener[])(m.getListeners(TableModelListener.class));

Если таких слушателей нет, этот метод возвращает пустой массив.

Параметры типа:

T — тип слушателя

Параметры:

listenerType — тип запрашиваемых слушателей

Возвращает:

массив всех объектов, зарегистрированных в этом компоненте как FooListener, или пустой массив, если такие слушатели не добавлялись

Вызывает:

ClassCastException — если listenerType не указывает класс или интерфейс, реализующий java.util.EventListener

Начиная с версии:

1.3

См. также:

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