Класс TableRowSorterTableModel>

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

Конструкторы

TableRowSorter

public TableRowSorter()

Создаёт TableRowSorter с пустой моделью.

TableRowSorter

public TableRowSorter(M model)

Создаёт TableRowSorter, используя model в качестве базовой TableModel.

Параметры:

model - базовая TableModel для использования, null рассматривается как пустая модель

Методы

setModel

public void setModel(M model)

Устанавливает TableModel для использования в качестве базовой модели для данного TableRowSorter. Значение null может быть использовано для установки пустой модели.

Параметры:

model - базовая модель для использования, или null

setStringConverter

public void setStringConverter(TableStringConverter stringConverter)

Устанавливает объект, ответственный за преобразование значений из модели в строки. Если не null, используется для преобразования любых значений объекта, для которых не зарегистрирован Comparator, в строки.

Параметры:

stringConverter - объект, ответственный за преобразование значений из модели в строки

getStringConverter

public TableStringConverter getStringConverter()

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

Возвращает:

объект, ответственный за преобразование значений в строки.

getComparator

public Comparator<?> getComparator(int column)

Возвращает Comparator для указанного столбца. Если Comparator не был задан с помощью метода setComparator, будет возвращён Comparator на основе класса столбца (TableModel.getColumnClass) указанного столбца. Если класс столбца равен String, возвращается Collator.getInstance. Если класс столбца реализует Comparable, возвращается внутренний Comparator, вызывающий метод compareTo. В противном случае возвращается Collator.getInstance.

Переопределяет:

getComparator в классе DefaultRowSorter<M extends TableModel,​Integer>

Параметры:

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

Возвращает:

Comparator для указанного столбца

Исключения:

IndexOutOfBoundsException - если столбец выходит за пределы диапазона базовой модели

useToString

protected boolean useToString(int column)

Возвращает, следует ли преобразовывать значение в строку перед выполнением сравнения при сортировке. Если true, используется ModelWrapper.getStringValueAt, в противном случае используется ModelWrapper.getValueAt. Подклассы, такие как TableRowSorter, должны учитывать это значение в своей реализации метода ModelWrapper.

Переопределяет:

useToString в классе DefaultRowSorter<M extends TableModel,​Integer>

Параметры:

column - индекс столбца для проверки, в терминах базовой модели

Возвращает:

true, если значения должны преобразовываться в строки перед выполнением сравнения при сортировке

Исключения:

IndexOutOfBoundsException - если column недействителен