Класс DefaultTableModel

java.lang.Object

javax.swing.table.AbstractTableModel

javax.swing.table.DefaultTableModel

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

public class DefaultTableModel extends AbstractTableModel implements Serializable

Это реализация TableModel, использующая Vector из Vectors для хранения значений ячеек.

Предупреждение: DefaultTableModel возвращает класс столбца Object. Когда DefaultTableModel используется с TableRowSorter, это приведет к интенсивному использованию toString, что для типов данных, не являющихся String, является дорогостоящим. Если вы используете DefaultTableModel с TableRowSorter, настоятельно рекомендуется переопределить getColumnClass для возврата соответствующего типа.

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

См. также:

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

Модификатор и тип	Поле	Описание
`protected Vector`	`columnIdentifiers`	Список идентификаторов столбцов.
`protected Vector<Vector>`	`dataVector`	Вектор векторов, содержащий значения `Vectors` из `Object`.

Поля, объявленные в классе javax.swing.table.AbstractTableModel

listenerList

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

Конструктор	Описание
`DefaultTableModel()`	Создаёт таблицу по умолчанию с нулём столбцов и нулём строк.
`DefaultTableModel(int rowCount, int columnCount)`	Создаёт таблицу со столбцами и значениями объектов `null`.
`DefaultTableModel(Object[][] data, Object[] columnNames)`	Создаёт таблицу и инициализирует её, передавая `data` и `columnNames` методу `setDataVector`.
`DefaultTableModel(Object[] columnNames, int rowCount)`	Создаёт таблицу с количеством столбцов, равным количеству элементов в `columnNames`, и значениями объектов `null`.
`DefaultTableModel(Vector<?> columnNames, int rowCount)`	Создаёт таблицу с количеством столбцов, равным количеству элементов в `columnNames`, и значениями объектов `null`.
`DefaultTableModel(Vector<? extends Vector> data, Vector<?> columnNames)`	Создаёт таблицу и инициализирует её, передавая `data` и `columnNames` методу `setDataVector`.

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

Модификатор и тип	Метод	Описание
`void`	`addColumn(Object columnName)`	Добавляет столбец в модель.
`void`	`addColumn(Object columnName, Object[] columnData)`	Добавляет столбец в модель.
`void`	`addColumn(Object columnName, Vector<?> columnData)`	Добавляет столбец в модель.
`void`	`addRow(Object[] rowData)`	Добавляет строку в конец модели.
`void`	`addRow(Vector<?> rowData)`	Добавляет строку в конец модели.
`protected static Vector<Object>`	`convertToVector(Object[] anArray)`	Возвращает вектор, содержащий те же объекты, что и массив.
`protected static Vector<Vector<Object>>`	`convertToVector(Object[][] anArray)`	Возвращает вектор векторов, содержащий те же объекты, что и массив.
`int`	`getColumnCount()`	Возвращает количество столбцов в этой таблице данных.
`String`	`getColumnName(int column)`	Возвращает имя столбца.
`Vector<Vector>`	`getDataVector()`	Возвращает вектор `Vectors`, содержащий значения данных таблицы.
`int`	`getRowCount()`	Возвращает количество строк в этой таблице данных.
`Object`	`getValueAt(int row, int column)`	Возвращает значение атрибута для ячейки в строке `row` и столбце `column`.
`void`	`insertRow(int row, Object[] rowData)`	Вставляет строку в модель по индексу `row`.
`void`	`insertRow(int row, Vector<?> rowData)`	Вставляет строку в модель по индексу `row`.
`boolean`	`isCellEditable(int row, int column)`	Возвращает true независимо от значений параметров.
`void`	`moveRow(int start, int end, int to)`	Перемещает одну или несколько строк из диапазона `start` по `end` на позицию `to` в модели.
`void`	`newDataAvailable(TableModelEvent event)`	Эквивалентно `fireTableChanged`.
`void`	`newRowsAdded(TableModelEvent e)`	Обеспечивает, что новые строки имеют правильное количество столбцов.
`void`	`removeRow(int row)`	Удаляет строку по индексу `row` из модели.
`void`	`rowsRemoved(TableModelEvent event)`	Эквивалентно `fireTableChanged`.
`void`	`setColumnCount(int columnCount)`	Устанавливает количество столбцов в модели.
`void`	`setColumnIdentifiers(Object[] newIdentifiers)`	Заменяет идентификаторы столбцов в модели.
`void`	`setColumnIdentifiers(Vector<?> columnIdentifiers)`	Заменяет идентификаторы столбцов в модели.
`void`	`setDataVector(Object[][] dataVector, Object[] columnIdentifiers)`	Заменяет значение в переменной `dataVector` значениями из массива `dataVector`.
`void`	`setDataVector(Vector<? extends Vector> dataVector, Vector<?> columnIdentifiers)`	Заменяет текущую переменную `dataVector` новым вектором строк `dataVector`.
`void`	`setNumRows(int rowCount)`	Устарело начиная с Java 2 platform v1.3.
`void`	`setRowCount(int rowCount)`	Устанавливает количество строк в модели.
`void`	`setValueAt(Object aValue, int row, int column)`	Устанавливает значение объекта для ячейки в строке `column` и столбце `row`.

Методы, объявленные в классе javax.swing.table.AbstractTableModel

addTableModelListener, findColumn, fireTableCellUpdated, fireTableChanged, fireTableDataChanged, fireTableRowsDeleted, fireTableRowsInserted, fireTableRowsUpdated, fireTableStructureChanged, getColumnClass, getListeners, getTableModelListeners, removeTableModelListener

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

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

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

dataVector

protected Vector<Vector> dataVector

Вектор данных, содержащий значения таблицы.

columnIdentifiers

protected Vector columnIdentifiers

Вектор идентификаторов столбцов.

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

DefaultTableModel

public DefaultTableModel()

Создаёт таблицу с нулём столбцов и нулём строк.

DefaultTableModel

public DefaultTableModel(int rowCount, int columnCount)

Создаёт таблицу с заданным количеством столбцов и строк, заполненную значениями объектов.

Параметры:

rowCount - количество строк в таблице

columnCount - количество столбцов в таблице

См. также:

DefaultTableModel

public DefaultTableModel(Vector<?> columnNames, int rowCount)

Создаёт таблицу с количеством столбцов, равным количеству элементов в векторе имён столбцов, и заданным количеством строк, заполненную значениями объектов. Имена столбцов берутся из переданного вектора.

Параметры:

columnNames - вектор имён новых столбцов; если пустой, модель не имеет столбцов

rowCount - количество строк в таблице

См. также:

DefaultTableModel

public DefaultTableModel(Object[] columnNames, int rowCount)

Создаёт таблицу с количеством столбцов, равным количеству элементов в массиве имён столбцов, и заданным количеством строк, заполненную значениями объектов. Имена столбцов берутся из переданного массива.

Параметры:

columnNames - массив имён новых столбцов; если пустой, модель не имеет столбцов

rowCount - количество строк в таблице

См. также:

DefaultTableModel

public DefaultTableModel(Vector<? extends Vector> data, Vector<?> columnNames)

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

Параметры:

data - данные таблицы, вектор векторов значений

columnNames - имена столбцов

См. также:

DefaultTableModel

public DefaultTableModel(Object[][] data, Object[] columnNames)

Создаёт модель таблицы и инициализирует её данными, передавая двумерный массив данных и массив имён столбцов методу setDataVector. Первый индекс в массиве - индекс строки, второй - индекс столбца.

Параметры:

data - данные таблицы

columnNames - имена столбцов

См. также:

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

getDataVector

public Vector<Vector> getDataVector()

Возвращает вектор векторов, содержащих значения данных таблицы. Внешний вектор представляет строки, внутренние - значения в строках. Например, чтобы получить значение в ячейке строки 1, столбец 5:

Возвращает:

Вектор векторов, содержащий данные таблицы

См. также:

setDataVector

public void setDataVector(Vector<? extends Vector> dataVector, Vector<?> columnIdentifiers)

Заменяет текущие данные таблицы новым вектором строк и вектором имён столбцов. Строки представляются как векторы значений. Первое имя в векторе имён столбцов соответствует столбцу 0. Строки подстраиваются под количество столбцов, либо обрезаются, либо дополняются нулевыми значениями. Передача значения null для векторов может привести к непредсказуемым результатам, или исключениям.

Параметры:

dataVector - новый вектор данных

columnIdentifiers - имена столбцов

См. также:

setDataVector

public void setDataVector(Object[][] dataVector, Object[] columnIdentifiers)

Заменяет данные таблицы значениями из массива. Первый индекс массива - индекс строки, второй - индекс столбца. Имена столбцов берутся из переданного массива.

Параметры:

dataVector - новый вектор данных

columnIdentifiers - имена столбцов

См. также:

newDataAvailable

public void newDataAvailable(TableModelEvent event)

Эквивалентно fireTableChanged.

Параметры:: event - событие изменения

newRowsAdded

public void newRowsAdded(TableModelEvent e)

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

Параметры:

e - событие, описывающее добавление строк. Если null, предполагается, что все строки были добавлены

См. также:

rowsRemoved

public void rowsRemoved(TableModelEvent event)

Эквивалентно fireTableChanged.

Параметры:: event - событие изменения

setNumRows

public void setNumRows(int rowCount)

Устарело. Используйте метод setRowCount.

Параметры:: rowCount - новое количество строк

setRowCount

public void setRowCount(int rowCount)

Устанавливает количество строк в модели. Если новое количество больше текущего, добавляются новые строки в конец. Если меньше - удаляются строки с указанного индекса.

Параметры:

rowCount - количество строк в модели

С версии:

1.3

См. также:

addRow

public void addRow(Vector<?> rowData)

Добавляет строку в конец модели. Новая строка будет содержать данные из вектора, если не указан параметр data.

Параметры:: rowData - данные новой строки (опционально)

addRow

public void addRow(Object[] rowData)

Добавляет строку в конец модели. Новая строка будет содержать null значения, если не указано rowData. Будет сгенерировано уведомление о добавлении строки.

Parameters:: rowData - необязательные данные добавляемой строки

insertRow

public void insertRow(int row, Vector<?> rowData)

Вставляет строку в позицию row в модели. Новая строка будет содержать null значения, если не указано rowData. Будет сгенерировано уведомление о добавлении строки.

Parameters:: row - индекс строки для вставки; rowData - необязательные данные добавляемой строки
Throws:: ArrayIndexOutOfBoundsException - если строка была некорректной

insertRow

public void insertRow(int row, Object[] rowData)

Parameters:: row - индекс строки для вставки; rowData - необязательные данные добавляемой строки
Throws:: ArrayIndexOutOfBoundsException - если строка была некорректной

moveRow

public void moveRow(int start, int end, int to)

Перемещает одну или несколько строк из диапазона start по end в позицию to в модели. После перемещения строка, которая была на индексе start, окажется на индексе to. Этот метод отправит уведомление о tableChanged всем слушателям.

  Examples of moves:

  1. moveRow(1,3,5);
          a|B|C|D|e|f|g|h|i|j|k   - before
          a|e|f|g|h|B|C|D|i|j|k   - after

  2. moveRow(6,7,1);
          a|b|c|d|e|f|G|H|i|j|k   - before
          a|G|H|b|c|d|e|f|i|j|k   - after

Parameters:: start - начальный индекс перемещаемой строки; end - конечный индекс перемещаемой строки; to - место назначения перемещаемых строк
Throws:: ArrayIndexOutOfBoundsException - если какой-либо элемент будет перемещён за пределы диапазона таблицы

removeRow

public void removeRow(int row)

Удаляет строку по индексу row из модели. Уведомление об удалении строки будет отправлено всем слушателям.

Parameters:: row - индекс строки для удаления
Throws:: ArrayIndexOutOfBoundsException - если строка была некорректной

setColumnIdentifiers

public void setColumnIdentifiers(Vector<?> columnIdentifiers)

Заменяет идентификаторы столбцов в модели. Если количество newIdentifier больше текущего количества столбцов, новые столбцы добавляются в конец каждой строки модели. Если количество newIdentifier меньше текущего количества столбцов, все лишние столбцы в конце строки удаляются.

Parameters:

columnIdentifiers - вектор идентификаторов столбцов. Если null, устанавливает модель на ноль столбцов

See Also:

setColumnIdentifiers

public void setColumnIdentifiers(Object[] newIdentifiers)

Parameters:

newIdentifiers - массив идентификаторов столбцов. Если null, устанавливает модель на ноль столбцов

See Also:

setColumnCount

public void setColumnCount(int columnCount)

Устанавливает количество столбцов в модели. Если новый размер больше текущего, новые столбцы добавляются в конец модели со значениями ячеек null. Если новый размер меньше текущего, все столбцы с индексом columnCount и выше удаляются.

Parameters:

columnCount - новое количество столбцов в модели

Since:

1.3

See Also:

addColumn

public void addColumn(Object columnName)

Добавляет столбец в модель. Новый столбец будет иметь идентификатор columnName, который может быть null. Этот метод отправит уведомление о tableChanged всем слушателям. Этот метод является оберткой для addColumn(Object, Vector), который использует null в качестве вектора данных.

Parameters:: columnName - идентификатор добавляемого столбца

addColumn

public void addColumn(Object columnName, Vector<?> columnData)

Добавляет столбец в модель. Новый столбец будет иметь идентификатор columnName, который может быть null. columnData — необязательный вектор данных для столбца. Если он null, столбец заполняется значениями null. В противном случае новые данные будут добавлены в модель, начиная с первого элемента, идущего в строку 0 и т. д. Этот метод отправит уведомление о tableChanged всем слушателям.

Parameters:: columnName - идентификатор добавляемого столбца; columnData - необязательные данные добавляемого столбца

addColumn

public void addColumn(Object columnName, Object[] columnData)

Добавляет столбец в модель. Новый столбец будет иметь идентификатор columnName. columnData — необязательный массив данных для столбца. Если он null, столбец заполняется значениями null. В противном случае новые данные будут добавлены в модель, начиная с первого элемента, идущего в строку 0 и т. д. Этот метод отправит уведомление о tableChanged всем слушателям.

Parameters:

columnName - идентификатор вновь созданного столбца

columnData - новые данные, которые будут добавлены в столбец

See Also:

getRowCount

public int getRowCount()

Возвращает количество строк в этой таблице данных.

Specified by:

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

Returns:

количество строк в модели

See Also:

getColumnCount

public int getColumnCount()

Возвращает количество столбцов в этой таблице данных.

Specified by:

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

Returns:

количество столбцов в модели

See Also:

getColumnName

public String getColumnName(int column)

Возвращает имя столбца.

Specified by:: getColumnName в интерфейсе TableModel
Overrides:: getColumnName в классе AbstractTableModel
Parameters:: column - запрашиваемый столбец
Returns:: имя этого столбца, используя строковое значение соответствующего элемента в columnIdentifiers. Если columnIdentifiers не содержит записи для этого индекса, возвращается имя по умолчанию, заданное родительским классом.

isCellEditable

public boolean isCellEditable(int row, int column)

Возвращает true независимо от значений параметров.

Specified by:

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

Overrides:

isCellEditable в классе AbstractTableModel

Parameters:

row - строка, значение которой необходимо запросить

column - столбец, значение которого необходимо запросить

Returns:

true

See Also:

getValueAt

public Object getValueAt(int row, int column)

Возвращает значение атрибута для ячейки по координатам row и column.

Specified by:: getValueAt в интерфейсе TableModel
Parameters:: row - строка, значение которой необходимо запросить; column - столбец, значение которого необходимо запросить
Returns:: объектное значение в указанной ячейке
Throws:: ArrayIndexOutOfBoundsException - если была указана некорректная строка или столбец

END_OF_DOCUMENT_MARKER

setValueAt

public void setValueAt(Object aValue, int row, int column)

Устанавливает значение объекта для ячейки по координатам column и row. aValue — новое значение. Этот метод сгенерирует уведомление tableChanged.

Specified by:

setValueAt in interface TableModel

Overrides:

setValueAt in class AbstractTableModel

Parameters:

aValue — новое значение; может быть null

row — строка, значение которой нужно изменить

column — столбец, значение которого нужно изменить

Throws:

ArrayIndexOutOfBoundsException — если была указана недопустимая строка или столбец

See Also:

convertToVector

protected static Vector<Object> convertToVector(Object[] anArray)

Возвращает вектор, содержащий те же объекты, что и массив.

Parameters:: anArray — массив для преобразования
Returns:: новый вектор; если anArray равен null, возвращает null

convertToVector

protected static Vector<Vector<Object>> convertToVector(Object[][] anArray)

Возвращает вектор векторов, содержащий те же объекты, что и двумерный массив.

Parameters:: anArray — двумерный массив для преобразования
Returns:: новый вектор векторов; если anArray равен null, возвращает null

© 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.
https://download.java.net/java/early_access/jdk24/docs/api/java.desktop/javax/swing/table/DefaultTableModel.html