javax.swing.table

Класс TableRowSorter <М. расширяет TableModel>

java.lang. Объект

javax.swing. RowSorter<M>

javax.swing. DefaultRowSorter <М., Целое число>

javax.swing.table. TableRowSorter <M>

Введите Параметры:

M - тип модели, которая должна быть реализацией TableModel

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

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

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

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

JTable's основанные на строке методы и JTable's модель выбора обращаются к представлению а не базовой модели. Поэтому, необходимо преобразовать между двумя. Например, чтобы получить выбор с точки зрения 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 использование Comparators для того, чтобы сделать сравнения. Следующее определяет как a Comparator выбирается для столбца:

1. Если a Comparator был определен для столбца setComparator метод, используйте это.
2. Если столбец class как возвращено getColumnClass String, используйте Comparator возвращенный Collator.getInstance().
3. Если столбец class реализует Comparable, используйте a Comparator это вызывает compareTo метод.
4. Если a TableStringConverter был определен, используйте это, чтобы преобразовать значения в Strings и затем используют 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 метод вызывается), следующее сбрасывается к их значениям по умолчанию: Comparators столбцом, текущим порядком сортировки, и является ли каждый столбец поддающимся сортировке. Порядок сортировки по умолчанию является естественным (то же самое как модель), и столбцы являются поддающимися сортировке по умолчанию.

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

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

С тех пор:

1.6

См. Также:

JTable, RowFilter, DefaultTableModel, Collator, Comparator

Вложенная Сводка Класса

Вложенные классы/интерфейсы, наследованные от class javax.swing. DefaultRowSorter

DefaultRowSorter.ModelWrapper<M,I>

Вложенные классы/интерфейсы, наследованные от class javax.swing. RowSorter

RowSorter. SortKey

Сводка конструктора

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

Конструктор и Описание
TableRowSorter() Создает a TableRowSorter с пустой моделью.
TableRowSorter(M model) Создает a TableRowSorter использование model как базовое TableModel.

Сводка метода

Модификатор и Тип	Метод и Описание
Comparator<?>	getComparator(int column) Возвраты Comparator для указанного столбца.
TableStringConverter	getStringConverter() Возвращает объект, ответственный за преобразование значений от модели до строк.
void	setModel(M model) Наборы TableModel использовать в качестве базовой модели для этого TableRowSorter.
void	setStringConverter(TableStringConverter stringConverter) Устанавливает объект, ответственный за преобразование значений от модели до строк.
protected boolean	useToString(int column) Возвраты, преобразовать ли значение в строку прежде, чем сделать сравнения, сортируя.

Методы, наследованные от class javax.swing. DefaultRowSorter

allRowsChanged, convertRowIndexToModel, convertRowIndexToView, getMaxSortKeys, getModel, getModelRowCount, getModelWrapper, getRowFilter, getSortKeys, getSortsOnUpdates, getViewRowCount, isSortable, modelStructureChanged, rowsDeleted, rowsInserted, rowsUpdated, rowsUpdated, setComparator, setMaxSortKeys, setModelWrapper, setRowFilter, setSortable, setSortKeys, setSortsOnUpdates, sort, toggleSortOrder

Методы, наследованные от class javax.swing. RowSorter

addRowSorterListener, fireRowSorterChanged, fireSortOrderChanged, removeRowSorterListener

Методы, наследованные от class java.lang. Объект

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Деталь конструктора

TableRowSorter

public TableRowSorter()

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

TableRowSorter

public TableRowSorter(M model)

Создает a 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 для указанного столбца. Если a Comparator не был определен, используя setComparator метод a Comparator будет возвращен основанный на столбце class (TableModel.getColumnClass) из указанного столбца. Если столбец class String, Collator.getInstance возвращается. Если столбец class реализует Comparable частное Comparator возвращается, который вызывает compareTo метод. Иначе Collator.getInstance возвращается.

Переопределения:

getComparator в class DefaultRowSorter<M extends TableModel,Integer>

Параметры:

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

Возвраты:

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

Броски:

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

useToString

protected boolean useToString(int column)

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

Переопределения:

useToString в class DefaultRowSorter<M extends TableModel,Integer>

Параметры:

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

Броски:

IndexOutOfBoundsException - если column не допустимо