Класс TableRowSorter<M extends TableModel>

public class TableRowSorter<M extends TableModel> extends DefaultRowSorter<M,Integer>

Реализация интерфейса RowSorter, которая обеспечивает сортировку и фильтрацию с помощью TableModel. Следующий пример демонстрирует добавление сортировки к JTable:

   TableModel myModel = createMyTableModel();
   JTable table = new JTable(myModel);
   table.setRowSorter(new TableRowSorter(myModel));
 

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

Методы класса JTable, относящиеся к строкам, и модель выделения класса JTable относятся к представлению, а не к основной модели. Поэтому необходимо преобразовывать между ними. Например, чтобы получить выделение в терминах myModel, необходимо преобразовать индексы:

   int[] selection = table.getSelectedRows();
   for (int i = 0; i < selection.length; i++) {
     selection[i] = table.convertRowIndexToModel(selection[i]);
   }
 

Аналогично, чтобы выделить строку в JTable на основе координаты из основной модели, выполните обратное преобразование:

   table.setRowSelectionInterval(table.convertRowIndexToView(row),
                                 table.convertRowIndexToView(row));
 

Предыдущий пример предполагает, что фильтрация не включена. Если фильтрация включена, convertRowIndexToView вернёт -1 для расположений, которые не видны в представлении.

TableRowSorter использует Comparator для выполнения сравнений. Следующее определяет, как выбирается Comparator для столбца:

1. Если для столбца был указан Comparator методом setComparator, используйте его.
2. Если класс столбца, возвращаемый методом getColumnClass, является String, используйте Comparator, возвращаемый методом Collator.getInstance().
3. Если класс столбца реализует интерфейс Comparable, используйте Comparator, который вызывает метод compareTo.
4. Если указан TableStringConverter, используйте его для преобразования значений в String, а затем используйте Comparator, возвращаемый методом Collator.getInstance().
5. В противном случае используйте Comparator, возвращаемый методом Collator.getInstance(), по результатам вызова метода toString для объектов.

В дополнение к сортировке, TableRowSorter предоставляет возможность фильтрации. Фильтр задаётся с помощью метода setFilter. Следующий пример покажет только строки, содержащие строку "foo":

   TableModel myModel = createMyTableModel();
   TableRowSorter sorter = new TableRowSorter(myModel);
   sorter.setRowFilter(RowFilter.regexFilter(".*foo.*"));
   JTable table = new JTable(myModel);
   table.setRowSorter(sorter);
 

Если структура основной модели изменяется (вызывается метод modelStructureChanged), сбрасываются следующие значения: Comparator по столбцам, текущий порядок сортировки и сортируемость каждого столбца. По умолчанию порядок сортировки естественный (тот же, что и в модели), а столбцы сортируются по умолчанию.

TableRowSorter имеет один формальный параметр типа: тип модели. Передача типа, точно соответствующего вашей модели, позволяет фильтровать на основе вашей модели без приведения типов. Обратитесь к документации по RowFilter для примера.

ПРЕДУПРЕЖДЕНИЕ: DefaultTableModel возвращает класс столбца типа Object. Поэтому все сравнения будут выполняться с использованием toString. Это может быть излишне дорогостоящим. Если столбец содержит только один тип значения, например, Integer, переопределите метод getColumnClass и верните соответствующий Class. Это значительно повысит производительность этого класса.