public class TableSorter extends AbstractTableModel
TableSorter is a decorator for TableModels; adding sorting functionality to a supplied TableModel. TableSorter does not store or copy the data in its TableModel; instead it maintains a map from the row indexes of the view to the row indexes of the model. As requests are made of the sorter (like getValueAt(row, col)) they are passed to the underlying model after the row numbers have been translated via the internal mapping array. This way, the TableSorter appears to hold another copy of the table with the rows in a different order.
TableSorter registers itself as a listener to the underlying model, just as the JTable itself would. Events recieved from the model are examined, sometimes manipulated (typically widened), and then passed on to the TableSorter's listeners (typically the JTable). If a change to the model has invalidated the order of TableSorter's rows, a note of this is made and the sorter will resort the rows the next time a value is requested.
When the tableHeader property is set, either by using the setTableHeader() method or the two argument constructor, the table header may be used as a complete UI for TableSorter. The default renderer of the tableHeader is decorated with a renderer that indicates the sorting status of each column. In addition, a mouse listener is installed with the following behavior:
This is a long overdue rewrite of a class of the same name that first appeared in the swing table demos in 1997.
Customized to prevent excessive event widening. Single row insert/deletes will no longer fire a data changed event. Instead, a new insert/delete event will be fired. The view to model map will not be completely recalculated. Instead, after an inset, a binary search will be used to place the new row. After a delete, the removed row will simply be removed from the sort map. Note that events will be widened if sorting is enabled and
| Modifier and Type | Field and Description |
|---|---|
static int |
ASCENDING |
static Comparator |
COMPARABLE_COMAPRATOR |
static int |
DESCENDING |
static Comparator |
LEXICAL_COMPARATOR |
static int |
NOT_SORTED |
protected TableModel |
tableModel |
listenerList| Constructor and Description |
|---|
TableSorter() |
TableSorter(TableModel tableModel) |
TableSorter(TableModel tableModel,
JTableHeader tableHeader) |
| Modifier and Type | Method and Description |
|---|---|
Class |
getColumnClass(int column) |
int |
getColumnCount() |
String |
getColumnName(int column) |
protected Comparator |
getComparator(int column) |
protected Icon |
getHeaderRendererIcon(int column,
int size) |
int |
getRowCount() |
int |
getSortingStatus(int column) |
JTableHeader |
getTableHeader() |
TableModel |
getTableModel() |
Object |
getValueAt(int row,
int column) |
boolean |
isCellEditable(int row,
int column) |
boolean |
isSorting() |
int |
modelIndex(int viewIndex) |
void |
setColumnComparator(Class type,
Comparator comparator) |
void |
setSortingStatus(int column,
int status) |
void |
setTableHeader(JTableHeader tableHeader) |
void |
setTableModel(TableModel tableModel) |
void |
setValueAt(Object aValue,
int row,
int column) |
addTableModelListener, findColumn, fireTableCellUpdated, fireTableChanged, fireTableDataChanged, fireTableRowsDeleted, fireTableRowsInserted, fireTableRowsUpdated, fireTableStructureChanged, getListeners, getTableModelListeners, removeTableModelListenerprotected TableModel tableModel
public static final int DESCENDING
public static final int NOT_SORTED
public static final int ASCENDING
public static final Comparator COMPARABLE_COMAPRATOR
public static final Comparator LEXICAL_COMPARATOR
public TableSorter()
public TableSorter(TableModel tableModel)
public TableSorter(TableModel tableModel, JTableHeader tableHeader)
public TableModel getTableModel()
public void setTableModel(TableModel tableModel)
public JTableHeader getTableHeader()
public void setTableHeader(JTableHeader tableHeader)
public boolean isSorting()
public int getSortingStatus(int column)
public void setSortingStatus(int column,
int status)
protected Icon getHeaderRendererIcon(int column, int size)
public void setColumnComparator(Class type, Comparator comparator)
protected Comparator getComparator(int column)
public int modelIndex(int viewIndex)
public int getRowCount()
public int getColumnCount()
public String getColumnName(int column)
getColumnName in interface TableModelgetColumnName in class AbstractTableModelpublic Class getColumnClass(int column)
getColumnClass in interface TableModelgetColumnClass in class AbstractTableModelpublic boolean isCellEditable(int row,
int column)
isCellEditable in interface TableModelisCellEditable in class AbstractTableModelpublic Object getValueAt(int row, int column)
public void setValueAt(Object aValue, int row, int column)
setValueAt in interface TableModelsetValueAt in class AbstractTableModelCopyright © 2023. All rights reserved.