Класс RowSorter<M>

public abstract class RowSorter<M>
extends Object

RowSorter предоставляет основу для сортировки и фильтрации. Помимо создания и установки RowSorter, вам очень редко нужно взаимодействовать с ним напрямую. Обратитесь к TableRowSorter для конкретной реализации RowSorter для JTable.

Основная роль RowSorter заключается в обеспечении сопоставления между двумя системами координат: представлением (например, JTable) и базовым источником данных, как правило, моделью.

Представление вызывает следующие методы у RowSorter:

• toggleSortOrder — Представление вызывает это, когда произошла соответствующая пользовательская жесту, чтобы запустить сортировку. Например, пользователь щелкнул заголовок столбца в таблице.
• Один из методов изменения модели — Представление вызывает метод изменения модели, когда базовая модель изменилась. Может быть зависимость порядка в том, как события доставляются, поэтому RowSorter не должен обновлять свое сопоставление до вызова одного из этих методов.

Поскольку представление широко использует методы convertRowIndexToModel, convertRowIndexToView и getViewRowCount, эти методы должны быть быстрыми.

RowSorter предоставляет уведомления об изменениях с помощью RowSorterListener. Отправляются два типа уведомлений:

• RowSorterEvent.Type.SORT_ORDER_CHANGED — уведомляет слушателей о том, что порядок сортировки изменился. За этим обычно следует уведомление о том, что сортировка изменилась.
• RowSorterEvent.Type.SORTED — уведомляет слушателей о том, что сопоставление, поддерживаемое RowSorter, изменилось каким-либо образом.

Реализации RowSorter обычно не имеют однозначного соответствия с базовой моделью, но могут. Например, если база данных выполняет сортировку, toggleSortOrder может вызвать базу данных (в фоновом потоке) и переопределить методы сопоставления, чтобы вернуть переданный аргумент.

Конкретные реализации RowSorter должны ссылаться на модель, такую ​​как TableModel или ListModel. Классы представления, такие как JTable и JList, также будут иметь ссылку на модель. Чтобы избежать зависимости порядка, реализации RowSorter не должны устанавливать слушателя на модели. Вместо этого класс представления вызовет RowSorter при изменении модели. Например, если строка обновляется в TableModel JTable вызывает rowsUpdated. При изменении модели представление может вызвать любой из следующих методов: modelStructureChanged, allRowsChanged, rowsInserted, rowsDeleted и rowsUpdated.

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

RowSorter

public RowSorter()

Создаёт RowSorter.

Методы

getModel

public abstract M getModel()

Возвращает базовую модель.

Возвращает:

базовую модель

toggleSortOrder

public abstract void toggleSortOrder(int column)

Параметры:

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

Исключения:

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

convertRowIndexToModel

public abstract int convertRowIndexToModel(int index)

Возвращает расположение index в терминах базовой модели. То есть, для строки index в координатах представления эта функция возвращает индекс строки в терминах базовой модели.

Параметры:

index - индекс строки в терминах базового представления

Возвращает:

индекс строки в терминах представления

Исключения:

IndexOutOfBoundsException - если index находится за пределами диапазона представления

convertRowIndexToView

public abstract int convertRowIndexToView(int index)

Возвращает расположение index в терминах представления. То есть, для строки index в координатах базовой модели эта функция возвращает индекс строки в терминах представления.

Параметры:

index - индекс строки в терминах базовой модели

Возвращает:

индекс строки в терминах представления, или -1, если индекс был отфильтрован из представления

Исключения:

IndexOutOfBoundsException - если index находится за пределами диапазона модели

setSortKeys

public abstract void setSortKeys(List<? extends RowSorter.SortKey> keys)

Устанавливает текущие ключи сортировки.

Параметры:

keys - новые SortKeys; null — сокращение для указания пустого списка, означающего, что представление должно быть несортированным

getSortKeys

public abstract List<? extends RowSorter.SortKey> getSortKeys()

Возвращает текущие ключи сортировки. Это должно вернуть non-null List и может вернуть неизменяемый List. Если вам необходимо изменить ключи сортировки, создайте копию возвращённого List, измените копию и вызовите setSortKeys с новым списком.

Возвращает:

текущий порядок сортировки

getViewRowCount

public abstract int getViewRowCount()

Возвращает количество строк в представлении. Если содержимое было отфильтровано, это может отличаться от количества строк базовой модели.

Возвращает:

количество строк в представлении

См. также:

getModelRowCount()

getModelRowCount

public abstract int getModelRowCount()

Возвращает количество строк в базовой модели.

Возвращает:

количество строк в базовой модели

См. также:

getViewRowCount()

modelStructureChanged

public abstract void modelStructureChanged()

allRowsChanged

public abstract void allRowsChanged()

rowsInserted

public abstract void rowsInserted(int firstRow,
                                  int endRow)

Параметры:

firstRow - первая строка

endRow - последняя строка

Исключения:

IndexOutOfBoundsException - если любой из аргументов недействителен или firstRow > endRow

rowsDeleted

public abstract void rowsDeleted(int firstRow,
                                 int endRow)

Параметры:

firstRow - первая строка

endRow - последняя строка

Исключения:

IndexOutOfBoundsException - если любой из аргументов находится вне диапазона модели до изменения или firstRow > endRow

rowsUpdated

public abstract void rowsUpdated(int firstRow,
                                 int endRow)

Параметры:

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

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

Исключения:

IndexOutOfBoundsException - если любой из аргументов находится вне диапазона базовой модели или firstRow > endRow

rowsUpdated

public abstract void rowsUpdated(int firstRow,
                                 int endRow,
                                 int column)

Параметры:

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

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

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

Исключения:

IndexOutOfBoundsException - если любой из аргументов находится за пределами диапазона базовой модели после изменения, firstRow > endRow, или column находится за пределами диапазона базовой модели

addRowSorterListener

public void addRowSorterListener(RowSorterListener l)

Добавляет RowSorterListener для получения уведомлений об этом RowSorter. Если один и тот же слушатель добавляется более одного раза, он получит несколько уведомлений. Если l является null, ничего не происходит.

Параметры:

l - RowSorterListener

removeRowSorterListener

public void removeRowSorterListener(RowSorterListener l)

Удаляет RowSorterListener. Если l является null, ничего не происходит.

Параметры:

l - RowSorterListener

fireSortOrderChanged

protected void fireSortOrderChanged()

Уведомляет слушателей о том, что порядок сортировки изменился.

fireRowSorterChanged

protected void fireRowSorterChanged(int[] lastRowIndexToModel)

Уведомляет слушателя о том, что отображение изменилось.

Параметры:

lastRowIndexToModel - отображение от индексов модели к индексам представления до сортировки, может быть null