DefaultRowSorter (Java Platform SE 8 )

java.lang.Object
- javax.swing.RowSorter<M>
- - javax.swing.DefaultRowSorter<M,I>

参数类型

M -模型的类型

I -标识符传递给 RowFilter类型

已知直接子类：

TableRowSorter
```
public abstract class DefaultRowSorter<M,I>
extends RowSorter<M>
```
一个实现的 RowSorter提供排序和筛选在基于网格的数据模型。除了创建和安装 RowSorter，你很少需要一个直接的互动。参考 TableRowSorter为 JTable RowSorter的具体实现。
排序是根据目前的SortKeys做为。如果两个对象是相等的（该列的Comparator返回0）下SortKey使用。如果没有SortKeys保持或订单UNSORTED，然后在模型中的行的顺序是。

每一列的排序是通过一个Comparator，您可以指定使用setComparator方法做。如果一个Comparator尚未指定的Comparator返回Collator.getInstance()用于对标的对象调用toString结果。的Comparator是从来不给null。一null值被视为发生non-null值之前，两null值都是相同的。

如果你指定一个Comparator投其参数比其他模型所提供的类型，一个ClassCastException将当数据的排序。

除了排序，DefaultRowSorter提供过滤行的能力。过滤是通过一个RowFilter，使用setRowFilter方法指明了。如果没有指定的筛选器已被指定的所有行。

默认情况下，行在无序的秩序（如模型相同），每一列排序。默认Comparators在类文件（例如，TableRowSorter）。

如果基础模型结构的变化（的modelStructureChanged方法被调用）以下是重置为默认值：Comparators柱，当前的排序顺序，以及每一列是否是合适的。找到默认的Comparators，看到具体的实施（例如，TableRowSorter）。默认的排序顺序是无序的（如模型相同），和列排序的默认。

如果基础模型结构的变化（的modelStructureChanged方法被调用）以下是重置为默认值：Comparators柱，当前的排序顺序和列是否是合适的。

DefaultRowSorter是一个抽象类。具体的子类必须通过调用setModelWrapper提供基础数据，setModelWrapper方法必须后被调用构造函数被调用很快，最好在子类的构造函数。如果你使用一个未定义的行为DefaultRowSorter不指定ModelWrapper结果。

DefaultRowSorter有两形式类型参数。第一类参数对应的模型类，例如DefaultTableModel。第二类型参数对应的标识符传递给RowFilter类。指TableRowSorter和RowFilter对类型参数的更多细节。

从以下版本开始：

一点六

另请参见：

TableRowSorter， DefaultTableModel， Collator

Nested Class Summary

Nested Classes
Modifier and Type	Class and Description
`protected static class`	`DefaultRowSorter.ModelWrapper<M,I>` `DefaultRowSorter.ModelWrapper`负责提供数据，按 `DefaultRowSorter`。

Nested classes/interfaces inherited from class javax.swing.RowSorter
RowSorter.SortKey

构造方法摘要

构造方法
Constructor and Description
`DefaultRowSorter()` 创建一个空的 `DefaultRowSorter`。

方法摘要

所有方法接口方法具体的方法
Modifier and Type	Method and Description
`void`	`allRowsChanged()` 当调用的底层模型的内容已完全更改时。
`int`	`convertRowIndexToModel(int index)` 返回在底层模型 `index`位置。
`int`	`convertRowIndexToView(int index)` 返回在观方面 `index`位置。
`Comparator<?>`	`getComparator(int column)` 返回指定列的 `Comparator`。
`int`	`getMaxSortKeys()` 返回排序键的最大数目。
`M`	`getModel()` 返回底层模型。
`int`	`getModelRowCount()` 返回底层模型中的行数。
`protected DefaultRowSorter.ModelWrapper<M,I>`	`getModelWrapper()` 返回提供正在被分类和筛选的数据的模型包装器。
`RowFilter<? super M,? super I>`	`getRowFilter()` 返回确定要隐藏的行的筛选器，如果有的话，应该从视图中隐藏。
`List<? extends RowSorter.SortKey>`	`getSortKeys()` 返回当前的排序键。
`boolean`	`getSortsOnUpdates()` 如果在更新相关模型时发生了一个排序，则返回真；否则，返回错误。
`int`	`getViewRowCount()` 返回视图中的行数。
`boolean`	`isSortable(int column)` 如果指定列排序返回true；否则，假。
`void`	`modelStructureChanged()` 当底层模型结构已完全更改时调用。
`void`	`rowsDeleted(int firstRow, int endRow)` 当在指定范围（包含）中已从底层模型中删除行时调用。
`void`	`rowsInserted(int firstRow, int endRow)` 当行已被插入到指定范围（包含）中的底层模型时调用。
`void`	`rowsUpdated(int firstRow, int endRow)` 当在指定范围（包含）之间的基本模型中已更改行时调用。
`void`	`rowsUpdated(int firstRow, int endRow, int column)` 当在指定范围内的基本模型中已更新行中的列时调用。
`void`	`setComparator(int column, Comparator<?> comparator)` 设置要使用的排序时指定的列的 `Comparator`。
`void`	`setMaxSortKeys(int max)` 设置最大排序键数。
`protected void`	`setModelWrapper(DefaultRowSorter.ModelWrapper<M,I> modelWrapper)` 设置提供正在被分类和筛选的数据的模型包装器。
`void`	`setRowFilter(RowFilter<? super M,? super I> filter)` 设置确定要隐藏的行，如果有的话，应该从视图中隐藏的筛选器。
`void`	`setSortable(int column, boolean sortable)` 设置是否指定列排序。
`void`	`setSortKeys(List<? extends RowSorter.SortKey> sortKeys)` 设置排序键。
`void`	`setSortsOnUpdates(boolean sortsOnUpdates)` 如果是真的，指定一个类应该发生时的基本模式是更新（ `rowsUpdated`调用）。
`void`	`sort()` 排序和筛选的列在视图基于列目前正在整理和过滤，排序键的话，这个分类器相关。
`void`	`toggleSortOrder(int column)` 如果指定的列已经是主要的排序列，则将排序顺序从上行到下行（或下降到上行），否则，则将指定的列列为主要的排序列，并具有一个上升的排序顺序。
`protected boolean`	`useToString(int column)` 返回在排序时是否将值转换为字符串的值，并在排序时进行比较。

Methods inherited from class javax.swing.RowSorter
addRowSorterListener, fireRowSorterChanged, fireSortOrderChanged, removeRowSorterListener

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Constructor Detail
  - DefaultRowSorter
```
public DefaultRowSorter()
```
    创建一个空的 DefaultRowSorter。
- 方法详细信息
  - setModelWrapper
```
protected final void setModelWrapper(DefaultRowSorter.ModelWrapper<M,I> modelWrapper)
```
    设置提供正在被分类和筛选的数据的模型包装器。
    
    参数
    
    modelWrapper -模型包装器负责提供数据，排序和过滤
    
    异常
    
    如果是 null modelWrapper IllegalArgumentException
  - getModelWrapper
```
protected final DefaultRowSorter.ModelWrapper<M,I> getModelWrapper()
```
    返回提供正在被分类和筛选的数据的模型包装器。
    
    结果
    
    负责提供对数据进行排序和筛选的模型包装器
  - getModel
```
public final M getModel()
```
    返回底层模型。
    
    Specified by:
    
    getModel 方法重写，继承类 RowSorter<M>
    
    结果
    
    基本模型
  - setSortable
```
public void setSortable(int column,
                        boolean sortable)
```
    设置是否指定列排序。指定的值只检查 toggleSortOrder时调用。它仍然可能是一列被标记为unsortable直接设置排序关键字排序。默认是真的。
    
    参数
    
    column -柱来启用或禁用排序上，在模型的基础上
    
    sortable是否指定列排序
    
    异常
    
    IndexOutOfBoundsException -如果 column是在模型的范围
    
    另请参见：
    
    toggleSortOrder(int)， setSortKeys(java.util.List<? extends javax.swing.RowSorter.SortKey>)
  - isSortable
```
public boolean isSortable(int column)
```
    如果指定列排序返回true；否则，假。
    
    参数
    
    column -列检查排序，在基础模型
    
    结果
    
    如果列排序
    
    异常
    
    IndexOutOfBoundsException如果柱底层模型的范围之外
  - setSortKeys
```
public void setSortKeys(List<? extends RowSorter.SortKey> sortKeys)
```
    设置排序键。这将创建一个副本的提供 List；对所提供的 List后续变化不影响本 DefaultRowSorter。如果排序键改变触发了一种。
    
    Specified by:
    
    setSortKeys 方法重写，继承类 RowSorter<M>
    
    参数
    
    sortKeys -新的 SortKeys； null是指定一个空列表的简写，表明的观点应该是无序的
    
    异常
    
    IllegalArgumentException -如果有任何的价值 sortKeys是null或超出模型范围有一个列的索引
  - getSortKeys
```
public List<? extends RowSorter.SortKey> getSortKeys()
```
    返回当前的排序键。返回一个不可修改的 non-null List。如果需要更改排序键，复制返回的 List，变异复制和调用 setSortKeys与新的列表。
    
    Specified by:
    
    getSortKeys 方法重写，继承类 RowSorter<M>
    
    结果
    
    当前排序顺序
  - setMaxSortKeys
```
public void setMaxSortKeys(int max)
```
    设置最大排序键数。排序键的数量决定排序时如何解决相同的值。例如，假设一个表行选了 setMaxSortKeys(2)调用它。用户单击列1的头，导致基于列1中的项目进行排序的表行。下一步，用户单击列2的头，导致表将根据列2中的项目进行排序；如果列2中的任何项目都是相等的，那么这些特定的行是基于列1中的项目排序的。在这种情况下，我们说行，主要是对2列排序，然后对列1。如果用户点击列3头，那么项目主要是排序的列3次排序的列2。因为排序键的最大数量被设定为2列1 setMaxSortKeys，不再对秩序的影响。
    排序键的最大数量的执行toggleSortOrder。您可以通过调用setSortKeys直接指定排序关键字和他们所有的荣幸。但是如果toggleSortOrder随后调用排序键的最大数量，将强制执行。默认值为3。
    
    参数
    
    max -排序键的最大数量
    
    异常
    
    IllegalArgumentException -如果 max＜1
  - getMaxSortKeys
```
public int getMaxSortKeys()
```
    返回排序键的最大数目。
    
    结果
    
    排序键的最大数目
  - setSortsOnUpdates
```
public void setSortsOnUpdates(boolean sortsOnUpdates)
```
    如果是真的，指定一个类应该发生时的基本模式是更新（ rowsUpdated调用）。例如，如果这是真的，用户编辑一个视图中该项目的位置可能会改变。默认是错误的。
    
    参数
    
    sortsOnUpdates是否更新事件排序
  - getSortsOnUpdates
```
public boolean getSortsOnUpdates()
```
    如果在更新相关模型时发生了一个排序，则返回真；否则，返回错误。
    
    结果
    
    是否对模型进行更新时进行排序
  - setRowFilter
```
public void setRowFilter(RowFilter<? super M,? super I> filter)
```
    设置确定要隐藏的行，如果有的话，应该从视图中隐藏的筛选器。过滤器在分类前应用。一个价值 null表示所有的值从模型中应包括。
    RowFilter的include方法传递一个Entry包裹的基本模型。在Entry列数对应的ModelWrapper列数。标识符来自ModelWrapper以及。
    
    此方法触发一个排序。
    
    参数
    
    filter -用于确定哪些条目过滤器应包括
  - getRowFilter
```
public RowFilter<? super M,? super I> getRowFilter()
```
    返回确定要隐藏的行的筛选器，如果有的话，应该从视图中隐藏。
    
    结果
    
    过滤器
  - toggleSortOrder
```
public void toggleSortOrder(int column)
```
    如果指定的列已经是主要的排序列，则将排序顺序从上行到下行（或下降到上行），否则，则将指定的列列为主要的排序列，并具有一个上升的排序顺序。如果指定的列不可排序的，这个方法没有效果。
    
    Specified by:
    
    toggleSortOrder 方法重写，继承类 RowSorter<M>
    
    参数
    
    column索引的列进行初步排序的列，在基础模型
    
    异常
    
    IndexOutOfBoundsException如果柱底层模型的范围之外
    
    另请参见：
    
    setSortable(int,boolean)， setMaxSortKeys(int)
  - convertRowIndexToView
```
public int convertRowIndexToView(int index)
```
    返回在观方面 index位置。即为行 index在底层模型的视图返回的行的索引坐标。
    
    Specified by:
    
    convertRowIndexToView 方法重写，继承类 RowSorter<M>
    
    参数
    
    index在底层模型方面的行索引
    
    结果
    
    在视图中的行索引，或-如果已从视图中筛选出索引，则为1
    
    异常
    
    IndexOutOfBoundsException -如果 index是在模型的范围
  - convertRowIndexToModel
```
public int convertRowIndexToModel(int index)
```
    返回在底层模型 index位置。即为行 index在坐标视图返回在底层模型的行索引。
    
    Specified by:
    
    convertRowIndexToModel 方法重写，继承类 RowSorter<M>
    
    参数
    
    index在底层视角的行索引
    
    结果
    
    在视图中的行索引
    
    异常
    
    IndexOutOfBoundsException -如果 index以外的视野范围
  - sort
```
public void sort()
```
    排序和筛选的列在视图基于列目前正在整理和过滤，排序键的话，这个分类器相关。一个空的 sortKeys名单显示，视图应该排序，作为模型相同。
    
    另请参见：
    
    setRowFilter(javax.swing.RowFilter<? super M, ? super I>)， setSortKeys(java.util.List<? extends javax.swing.RowSorter.SortKey>)
  - useToString
```
protected boolean useToString(int column)
```
    返回在排序时是否将值转换为字符串的值，并在排序时进行比较。如果真的 ModelWrapper.getStringValueAt将使用，否则将使用 ModelWrapper.getValueAt。它是由亚类，如 TableRowSorter，尊重这种价值在他们的 ModelWrapper实施。
    
    参数
    
    column -列的测试指标，在模型的基础上
    
    异常
    
    IndexOutOfBoundsException -如果 column无效
  - setComparator
```
public void setComparator(int column,
                          Comparator<?> comparator)
```
    设置要使用的排序时指定的列的 Comparator。这不会触发一个排序。如果你想在设置你需要显式调用 sort比较器。
    
    参数
    
    column -柱的 Comparator指数是用于，在基础模型
    
    comparator - Comparator使用
    
    异常
    
    IndexOutOfBoundsException -如果 column外底层模型的范围
  - getComparator
```
public Comparator<?> getComparator(int column)
```
    返回指定列的 Comparator。这将返回 null如果 Comparator尚未指定的列。
    
    参数
    
    column -柱取 Comparator，在基础模型
    
    结果
    
    为指定的列的 Comparator
    
    异常
    
    IndexOutOfBoundsException如果柱底层模型的范围之外
  - getViewRowCount
```
public int getViewRowCount()
```
    返回视图中的行数。如果内容已被过滤，这可能与基础模型的行计数有所不同。
    
    Specified by:
    
    getViewRowCount 方法重写，继承类 RowSorter<M>
    
    结果
    
    视图中的行数
    
    另请参见：
    
    RowSorter.getModelRowCount()
  - getModelRowCount
```
public int getModelRowCount()
```
    返回底层模型中的行数。
    
    Specified by:
    
    getModelRowCount 方法重写，继承类 RowSorter<M>
    
    结果
    
    底层模型中的行数
    
    另请参见：
    
    RowSorter.getViewRowCount()
  - modelStructureChanged
```
public void modelStructureChanged()
```
    当底层模型结构已完全更改时调用。例如，如果列数在 TableModel改变，这个方法会被调用。
    您通常不调用此方法。这种方法是公共的，允许视图类调用它。
    
    Specified by:
    
    modelStructureChanged 方法重写，继承类 RowSorter<M>
  - allRowsChanged
```
public void allRowsChanged()
```
    当调用的底层模型的内容已完全更改时。表的结构是相同的，只有内容发生了变化。这通常是发送时，它是太贵了表征的其他方法的变化。
    您通常不调用此方法。这种方法是公共的，允许视图类调用它。
    
    Specified by:
    
    allRowsChanged 方法重写，继承类 RowSorter<M>
  - rowsInserted
```
public void rowsInserted(int firstRow,
                         int endRow)
```
    当行已被插入到指定范围（包含）中的底层模型时调用。
    参数给出了影响范围的指标。第一个参数是在模型的变化之前，必须小于或等于模型的大小之前的变化。第二个参数是在模型的变化后，必须小于模型的大小后的变化。例如，如果你有一个5排模型，加入3项模型的指数是5年底，7。
    
    您通常不调用此方法。这种方法是公共的，允许视图类调用它。
    
    Specified by:
    
    rowsInserted 方法重写，继承类 RowSorter<M>
    
    参数
    
    firstRow -第一排
    
    endRow -最后一排
    
    异常
    
    IndexOutOfBoundsException -如果任一参数无效，或 firstRow > endRow
  - rowsDeleted
```
public void rowsDeleted(int firstRow,
                        int endRow)
```
    当在指定范围（包含）中已从底层模型中删除行时调用。
    争论给影响范围的指标，在模型之前变化。例如，如果你有一个5排模型，从模型的指数是2年底删除3个项目，4。
    
    您通常不调用此方法。这种方法是公共的，允许视图类调用它。
    
    Specified by:
    
    rowsDeleted 方法重写，继承类 RowSorter<M>
    
    参数
    
    firstRow -第一排
    
    endRow -最后一排
    
    异常
    
    IndexOutOfBoundsException如果任一参数是在模型的范围变更前，或 firstRow > endRow
  - rowsUpdated
```
public void rowsUpdated(int firstRow,
                        int endRow)
```
    当在指定范围（包含）之间的基本模型中已更改行时调用。
    您通常不调用此方法。这种方法是公共的，允许视图类调用它。
    
    Specified by:
    
    rowsUpdated 方法重写，继承类 RowSorter<M>
    
    参数
    
    firstRow -第一排，在基础模型
    
    endRow -最后一排，在基础模型
    
    异常
    
    IndexOutOfBoundsException如果任一参数是在底层模型的范围，或 firstRow > endRow
  - rowsUpdated
```
public void rowsUpdated(int firstRow,
                        int endRow,
                        int column)
```
    当在指定范围内的基本模型中已更新行中的列时调用。
    您通常不调用此方法。这种方法是公共的，允许视图类调用它。
    
    Specified by:
    
    rowsUpdated 方法重写，继承类 RowSorter<M>
    
    参数
    
    firstRow -第一排，在基础模型
    
    endRow -最后一排，在基础模型
    
    column -已更改的列，在基础模型
    
    异常
    
    IndexOutOfBoundsException如果任一参数是在底层模型的范围变更后， firstRow > endRow，或 column在底层模型的范围

Submit a bug or feature
For further API reference and developer documentation, see Java SE Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.
Copyright © 1993, 2014, Oracle and/or its affiliates. All rights reserved.

Class DefaultRowSorter<M,I>

Nested Class Summary

Nested classes/interfaces inherited from class javax.swing.RowSorter

构造方法摘要

方法摘要

Methods inherited from class javax.swing.RowSorter

Methods inherited from class java.lang.Object

Constructor Detail

DefaultRowSorter

方法详细信息

setModelWrapper

getModelWrapper

getModel

setSortable

isSortable

setSortKeys

getSortKeys

setMaxSortKeys

getMaxSortKeys

setSortsOnUpdates

getSortsOnUpdates

setRowFilter

getRowFilter

toggleSortOrder

convertRowIndexToView

convertRowIndexToModel

sort

useToString

setComparator

getComparator

getViewRowCount

getModelRowCount

modelStructureChanged

allRowsChanged

rowsInserted

rowsDeleted

rowsUpdated

rowsUpdated