Класс 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. Это значительно повысит производительность данного класса.