Java javax.swing Class DefaultRowSorter<M,I>（JDK8）

Constructor Detail

• DefaultRowSorter

  public DefaultRowSorter()

  Creates an empty DefaultRowSorter.

Method Detail

• setModelWrapper

  protected final void setModelWrapper(DefaultRowSorter.ModelWrapper<M,I> modelWrapper)

  Sets the model wrapper providing the data that is being sorted and filtered.

  Parameters:

  modelWrapper - the model wrapper responsible for providing the data that gets sorted and filtered

  Throws:

  IllegalArgumentException - if modelWrapper is null

• getModelWrapper

  protected final DefaultRowSorter.ModelWrapper<M,I> getModelWrapper()

  Returns the model wrapper providing the data that is being sorted and filtered.

  Returns:

  the model wrapper responsible for providing the data that gets sorted and filtered

• getModel

  public final M getModel()

  Returns the underlying model.

  Specified by:

  getModel in class RowSorter<M>

  Returns:

  the underlying model

• setSortable

  public void setSortable(int column,
                          boolean sortable)

  Sets whether or not the specified column is sortable. The specified value is only checked when toggleSortOrder is invoked. It is still possible to sort on a column that has been marked as unsortable by directly setting the sort keys. The default is true.

  Parameters:

  column - the column to enable or disable sorting on, in terms of the underlying model

  sortable - whether or not the specified column is sortable

  Throws:

  IndexOutOfBoundsException - if column is outside the range of the model

  See Also:

  toggleSortOrder(int), setSortKeys(java.util.List<? extends javax.swing.RowSorter.SortKey>)

• isSortable

  public boolean isSortable(int column)

  Returns true if the specified column is sortable; otherwise, false.

  Parameters:

  column - the column to check sorting for, in terms of the underlying model

  Returns:

  true if the column is sortable

  Throws:

  IndexOutOfBoundsException - if column is outside the range of the underlying model

• setSortKeys

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

  Sets the sort keys. This creates a copy of the supplied List; subsequent changes to the supplied List do not effect this DefaultRowSorter. If the sort keys have changed this triggers a sort.

  Specified by:

  setSortKeys in class RowSorter<M>

  Parameters:

  sortKeys - the new SortKeys; null is a shorthand for specifying an empty list, indicating that the view should be unsorted

  Throws:

  IllegalArgumentException - if any of the values in sortKeys are null or have a column index outside the range of the model

• getSortKeys

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

  Returns the current sort keys. This returns an unmodifiable non-null List. If you need to change the sort keys, make a copy of the returned List, mutate the copy and invoke setSortKeys with the new list.

  Specified by:

  getSortKeys in class RowSorter<M>

  Returns:

  the current sort order

• setMaxSortKeys

  public void setMaxSortKeys(int max)

  Sets the maximum number of sort keys. The number of sort keys determines how equal values are resolved when sorting. For example, assume a table row sorter is created and setMaxSortKeys(2) is invoked on it. The user clicks the header for column 1, causing the table rows to be sorted based on the items in column 1. Next, the user clicks the header for column 2, causing the table to be sorted based on the items in column 2; if any items in column 2 are equal, then those particular rows are ordered based on the items in column 1. In this case, we say that the rows are primarily sorted on column 2, and secondarily on column 1. If the user then clicks the header for column 3, then the items are primarily sorted on column 3 and secondarily sorted on column 2. Because the maximum number of sort keys has been set to 2 with setMaxSortKeys, column 1 no longer has an effect on the order.

  The maximum number of sort keys is enforced by toggleSortOrder. You can specify more sort keys by invoking setSortKeys directly and they will all be honored. However if toggleSortOrder is subsequently invoked the maximum number of sort keys will be enforced. The default value is 3.

  Parameters:

  max - the maximum number of sort keys

  Throws:

  IllegalArgumentException - if max < 1

• getMaxSortKeys

  public int getMaxSortKeys()

  Returns the maximum number of sort keys.

  Returns:

  the maximum number of sort keys

• setSortsOnUpdates

  public void setSortsOnUpdates(boolean sortsOnUpdates)

  If true, specifies that a sort should happen when the underlying model is updated (rowsUpdated is invoked). For example, if this is true and the user edits an entry the location of that item in the view may change. The default is false.

  Parameters:

  sortsOnUpdates - whether or not to sort on update events

• getSortsOnUpdates

  public boolean getSortsOnUpdates()

  Returns true if a sort should happen when the underlying model is updated; otherwise, returns false.

  Returns:

  whether or not to sort when the model is updated

• setRowFilter

  public void setRowFilter(RowFilter<? super M,? super I> filter)

  Sets the filter that determines which rows, if any, should be hidden from the view. The filter is applied before sorting. A value of null indicates all values from the model should be included.

  RowFilter's include method is passed an Entry that wraps the underlying model. The number of columns in the Entry corresponds to the number of columns in the ModelWrapper. The identifier comes from the ModelWrapper as well.

  This method triggers a sort.

  Parameters:

  filter - the filter used to determine what entries should be included

• getRowFilter

  public RowFilter<? super M,? super I> getRowFilter()

  Returns the filter that determines which rows, if any, should be hidden from view.

  Returns:

  the filter

• toggleSortOrder

  public void toggleSortOrder(int column)

  Reverses the sort order from ascending to descending (or descending to ascending) if the specified column is already the primary sorted column; otherwise, makes the specified column the primary sorted column, with an ascending sort order. If the specified column is not sortable, this method has no effect.

  Specified by:

  toggleSortOrder in class RowSorter<M>

  Parameters:

  column - index of the column to make the primary sorted column, in terms of the underlying model

  Throws:

  IndexOutOfBoundsException - if column is outside the range of the underlying model

  See Also:

  setSortable(int,boolean), setMaxSortKeys(int)

• convertRowIndexToView

  public int convertRowIndexToView(int index)

  Returns the location of index in terms of the view. That is, for the row index in the coordinates of the underlying model this returns the row index in terms of the view.

  Specified by:

  convertRowIndexToView in class RowSorter<M>

  Parameters:

  index - the row index in terms of the underlying model

  Returns:

  row index in terms of the view, or -1 if index has been filtered out of the view

  Throws:

  IndexOutOfBoundsException - if index is outside the range of the model

• convertRowIndexToModel

  public int convertRowIndexToModel(int index)

  Returns the location of index in terms of the underlying model. That is, for the row index in the coordinates of the view this returns the row index in terms of the underlying model.

  Specified by:

  convertRowIndexToModel in class RowSorter<M>

  Parameters:

  index - the row index in terms of the underlying view

  Returns:

  row index in terms of the view

  Throws:

  IndexOutOfBoundsException - if index is outside the range of the view

• sort

  public void sort()

  Sorts and filters the rows in the view based on the sort keys of the columns currently being sorted and the filter, if any, associated with this sorter. An empty sortKeys list indicates that the view should unsorted, the same as the model.

  See Also:

  setRowFilter(javax.swing.RowFilter<? super M, ? super I>), setSortKeys(java.util.List<? extends javax.swing.RowSorter.SortKey>)

• useToString

  protected boolean useToString(int column)

  Returns whether or not to convert the value to a string before doing comparisons when sorting. If true ModelWrapper.getStringValueAt will be used, otherwise ModelWrapper.getValueAt will be used. It is up to subclasses, such as TableRowSorter, to honor this value in their ModelWrapper implementation.

  Parameters:

  column - the index of the column to test, in terms of the underlying model

  Throws:

  IndexOutOfBoundsException - if column is not valid

• setComparator

  public void setComparator(int column,
                            Comparator<?> comparator)

  Sets the Comparator to use when sorting the specified column. This does not trigger a sort. If you want to sort after setting the comparator you need to explicitly invoke sort.

  Parameters:

  column - the index of the column the Comparator is to be used for, in terms of the underlying model

  comparator - the Comparator to use

  Throws:

  IndexOutOfBoundsException - if column is outside the range of the underlying model

• getComparator

  public Comparator<?> getComparator(int column)

  Returns the Comparator for the specified column. This will return null if a Comparator has not been specified for the column.

  Parameters:

  column - the column to fetch the Comparator for, in terms of the underlying model

  Returns:

  the Comparator for the specified column

  Throws:

  IndexOutOfBoundsException - if column is outside the range of the underlying model

• getViewRowCount

  public int getViewRowCount()

  Returns the number of rows in the view. If the contents have been filtered this might differ from the row count of the underlying model.

  Specified by:

  getViewRowCount in class RowSorter<M>

  Returns:

  number of rows in the view

  See Also:

  RowSorter.getModelRowCount()

• getModelRowCount

  public int getModelRowCount()

  Returns the number of rows in the underlying model.

  Specified by:

  getModelRowCount in class RowSorter<M>

  Returns:

  number of rows in the underlying model

  See Also:

  RowSorter.getViewRowCount()

• modelStructureChanged

  public void modelStructureChanged()

  Invoked when the underlying model structure has completely changed. For example, if the number of columns in a TableModel changed, this method would be invoked.

  You normally do not call this method. This method is public to allow view classes to call it.

  Specified by:

  modelStructureChanged in class RowSorter<M>

• allRowsChanged

  public void allRowsChanged()

  Invoked when the contents of the underlying model have completely changed. The structure of the table is the same, only the contents have changed. This is typically sent when it is too expensive to characterize the change in terms of the other methods.

  You normally do not call this method. This method is public to allow view classes to call it.

  Specified by:

  allRowsChanged in class RowSorter<M>

• rowsInserted

  public void rowsInserted(int firstRow,
                           int endRow)

  Invoked when rows have been inserted into the underlying model in the specified range (inclusive).

  The arguments give the indices of the effected range. The first argument is in terms of the model before the change, and must be less than or equal to the size of the model before the change. The second argument is in terms of the model after the change and must be less than the size of the model after the change. For example, if you have a 5-row model and add 3 items to the end of the model the indices are 5, 7.

  You normally do not call this method. This method is public to allow view classes to call it.

  Specified by:

  rowsInserted in class RowSorter<M>

  Parameters:

  firstRow - the first row

  endRow - the last row

  Throws:

  IndexOutOfBoundsException - if either argument is invalid, or firstRow > endRow

• rowsDeleted

  public void rowsDeleted(int firstRow,
                          int endRow)

  Invoked when rows have been deleted from the underlying model in the specified range (inclusive).

  The arguments give the indices of the effected range and are in terms of the model before the change. For example, if you have a 5-row model and delete 3 items from the end of the model the indices are 2, 4.

  You normally do not call this method. This method is public to allow view classes to call it.

  Specified by:

  rowsDeleted in class RowSorter<M>

  Parameters:

  firstRow - the first row

  endRow - the last row

  Throws:

  IndexOutOfBoundsException - if either argument is outside the range of the model before the change, or firstRow > endRow

• rowsUpdated

  public void rowsUpdated(int firstRow,
                          int endRow)

  Invoked when rows have been changed in the underlying model between the specified range (inclusive).

  You normally do not call this method. This method is public to allow view classes to call it.

  Specified by:

  rowsUpdated in class RowSorter<M>

  Parameters:

  firstRow - the first row, in terms of the underlying model

  endRow - the last row, in terms of the underlying model

  Throws:

  IndexOutOfBoundsException - if either argument is outside the range of the underlying model, or firstRow > endRow

• rowsUpdated

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

  Invoked when the column in the rows have been updated in the underlying model between the specified range.

  You normally do not call this method. This method is public to allow view classes to call it.

  Specified by:

  rowsUpdated in class RowSorter<M>

  Parameters:

  firstRow - the first row, in terms of the underlying model

  endRow - the last row, in terms of the underlying model

  column - the column that has changed, in terms of the underlying model

  Throws:

  IndexOutOfBoundsException - if either argument is outside the range of the underlying model after the change, firstRow > endRow, or column is outside the range of the underlying model