Класс JTable

@JavaBean(defaultProperty="UI",
          description="A component which displays data in a two dimensional grid.")
public class JTable
extends JComponent
implements TableModelListener, Scrollable, TableColumnModelListener, ListSelectionListener, CellEditorListener, Accessible, RowSorterListener

Класс JTable используется для отображения и редактирования обычных двумерных таблиц ячеек. См. Как использовать таблицы в Java Tutorial для пошаговой документации и примеров использования JTable.

Класс JTable имеет множество возможностей для настройки его отрисовки и редактирования, но предоставляет значения по умолчанию для этих функций, чтобы простые таблицы можно было легко настроить. Например, чтобы создать таблицу с 10 строками и 10 столбцами чисел:

TableModel dataModel = new AbstractTableModel() {
          public int getColumnCount() { return 10; }
          public int getRowCount() { return 10;}
          public Object getValueAt(int row, int col) { return Integer.valueOf(row*col); }
      };
      JTable table = new JTable(dataModel);
      JScrollPane scrollpane = new JScrollPane(table);

JTable обычно размещаются внутри JScrollPane. По умолчанию JTable будет изменять свою ширину таким образом, чтобы горизонтальная полоса прокрутки не была необходима. Чтобы разрешить горизонтальную полосу прокрутки, вызовите setAutoResizeMode(int) со значением AUTO_RESIZE_OFF. Обратите внимание, что если вы хотите использовать JTable в автономном представлении (вне JScrollPane) и хотите отобразить заголовок, вы можете получить его с помощью getTableHeader() и отобразить отдельно.

Чтобы включить сортировку и фильтрацию строк, используйте RowSorter. Вы можете настроить сортировщик строк двумя способами:

• Непосредственно задайте RowSorter. Например: table.setRowSorter(new TableRowSorter(model)).
• Установите свойство autoCreateRowSorter в значение true, чтобы JTable создал RowSorter за вас. Например: setAutoCreateRowSorter(true).

При разработке приложений, использующих JTable, стоит уделить пристальное внимание структурам данных, которые будут представлять данные таблицы. Класс DefaultTableModel является реализацией модели, которая использует Vector Vector Object для хранения значений ячеек. Помимо копирования данных из приложения в DefaultTableModel, также можно обернуть данные в методы интерфейса TableModel, чтобы данные можно было передать JTable напрямую, как в примере выше. Это часто приводит к более эффективным приложениям, потому что модель свободна выбирать внутреннее представление, которое лучше всего подходит для данных. Хорошее правило для выбора использования AbstractTableModel или DefaultTableModel заключается в использовании AbstractTableModel в качестве базового класса для создания подклассов и DefaultTableModel при отсутствии необходимости в создании подклассов.

Директория "TableExample" в демонстрационной области исходного дистрибутива предоставляет ряд полных примеров использования JTable, охватывая то, как JTable может использоваться для предоставления редактируемого представления данных, взятых из базы данных, и как изменять столбцы в отображении для использования специализированных рендереров и редакторов.

Класс JTable использует целые числа исключительно для указания строк и столбцов модели, которую он отображает. Класс JTable просто принимает табличный диапазон ячеек и использует getValueAt(int, int) для извлечения значений из модели во время отрисовки. Важно помнить, что индексы столбцов и строк, возвращаемые различными методами JTable, относятся к JTable (представлению) и не обязательно совпадают с индексами, используемыми моделью.

По умолчанию столбцы могут быть переупорядочены в JTable, так что столбцы представления отображаются в другом порядке по сравнению с столбцами модели. Это никак не влияет на реализацию модели: при переупорядочении столбцов JTable сохраняет новый порядок столбцов внутри себя и преобразует свои индексы столбцов перед запросом к модели.

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

Аналогично, при использовании функций сортировки и фильтрации, предоставляемых RowSorter, основная TableModel не должна знать, как выполнять сортировку, а RowSorter будет обрабатывать ее. Преобразования координат необходимы при использовании методов на основе строк JTable с основной TableModel. Все методы JTable на основе строк относятся к RowSorter, что не обязательно совпадает с TableModel. Например, выделение всегда относится к JTable, поэтому при использовании RowSorter вам нужно будет выполнить преобразование с помощью convertRowIndexToView или convertRowIndexToModel. Следующее показывает, как преобразовать координаты из JTable в координаты основной модели:

int[] selection = table.getSelectedRows();
   for (int i = 0; i < selection.length; i++) {
     selection[i] = table.convertRowIndexToModel(selection[i]);
   }
   // selection is now in terms of the underlying TableModel

По умолчанию, если включена сортировка, JTable сохранит выделение и переменные высоты строк в терминах модели при сортировке. Например, если строка 0 (в терминах основной модели) сейчас выделена, после сортировки строка 0 (в терминах основной модели) будет выделена. Визуально выделение может измениться, но в терминах основной модели оно останется неизменным. Единственным исключением является случай, если индекс модели больше не отображается или был удален. Например, если строка 0 (в терминах модели) была отфильтрована, выделение будет пустым после сортировки.

J2SE 5 добавляет методы в JTable для удобного доступа к некоторым общим потребностям печати. Простые новые методы print() позволяют быстро и легко добавить поддержку печати в ваше приложение. Кроме того, доступен новый метод getPrintable(javax.swing.JTable.PrintMode, java.text.MessageFormat, java.text.MessageFormat) для более сложных потребностей печати.

Как и все классы JComponent , вы можете использовать InputMap и ActionMap для ассоциации объекта Action с KeyStroke и выполнения действия при указанных условиях.

Предупреждение: Swing не является потокобезопасным. Для получения дополнительной информации см. Политику потоков Swing.

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