<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. Если для столбца с помощью метода setComparator задан Comparator, используется он.
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. Это значительно повысит производительность данного класса.