net.provision.soap
Class TableSorter

java.lang.Object
  extended by javax.swing.table.AbstractTableModel
      extended by net.provision.soap.TableSorter
All Implemented Interfaces:
java.io.Serializable, javax.swing.table.TableModel

public class TableSorter
extends javax.swing.table.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.

Version:
2.0 02/27/04
Author:
Philip Milne, Brendon McLean, Dan van Enckevort, Parwinder Sekhon
See Also:
Serialized Form

Field Summary
static int ASCENDING
           
static java.util.Comparator COMPARABLE_COMAPRATOR
           
static int DESCENDING
           
static java.util.Comparator LEXICAL_COMPARATOR
           
static int NOT_SORTED
           
protected  javax.swing.table.TableModel tableModel
           
 
Fields inherited from class javax.swing.table.AbstractTableModel
listenerList
 
Constructor Summary
TableSorter()
           
TableSorter(javax.swing.table.TableModel tableModel)
           
TableSorter(javax.swing.table.TableModel tableModel, javax.swing.table.JTableHeader tableHeader)
           
 
Method Summary
 java.lang.Class getColumnClass(int column)
          DOCUMENT ME!
 int getColumnCount()
          DOCUMENT ME!
 java.lang.String getColumnName(int column)
          DOCUMENT ME!
protected  java.util.Comparator getComparator(int column)
          DOCUMENT ME!
protected  javax.swing.Icon getHeaderRendererIcon(int column, int size)
          DOCUMENT ME!
 int getRowCount()
           
 int getSortingStatus(int column)
          DOCUMENT ME!
 javax.swing.table.JTableHeader getTableHeader()
          DOCUMENT ME!
 javax.swing.table.TableModel getTableModel()
          DOCUMENT ME!
 java.lang.Object getValueAt(int row, int column)
          DOCUMENT ME!
 boolean isCellEditable(int row, int column)
          DOCUMENT ME!
 boolean isSorting()
          DOCUMENT ME!
 int modelIndex(int viewIndex)
          DOCUMENT ME!
 void setColumnComparator(java.lang.Class type, java.util.Comparator comparator)
          DOCUMENT ME!
 void setSortingStatus(int column, int status)
          DOCUMENT ME!
 void setTableHeader(javax.swing.table.JTableHeader tableHeader)
          DOCUMENT ME!
 void setTableModel(javax.swing.table.TableModel tableModel)
          DOCUMENT ME!
 void setValueAt(java.lang.Object aValue, int row, int column)
          DOCUMENT ME!
 
Methods inherited from class javax.swing.table.AbstractTableModel
addTableModelListener, findColumn, fireTableCellUpdated, fireTableChanged, fireTableDataChanged, fireTableRowsDeleted, fireTableRowsInserted, fireTableRowsUpdated, fireTableStructureChanged, getListeners, getTableModelListeners, removeTableModelListener
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Field Detail

DESCENDING

public static final int DESCENDING
See Also:
Constant Field Values

NOT_SORTED

public static final int NOT_SORTED
See Also:
Constant Field Values

ASCENDING

public static final int ASCENDING
See Also:
Constant Field Values

COMPARABLE_COMAPRATOR

public static final java.util.Comparator COMPARABLE_COMAPRATOR

LEXICAL_COMPARATOR

public static final java.util.Comparator LEXICAL_COMPARATOR

tableModel

protected javax.swing.table.TableModel tableModel
Constructor Detail

TableSorter

public TableSorter()

TableSorter

public TableSorter(javax.swing.table.TableModel tableModel)

TableSorter

public TableSorter(javax.swing.table.TableModel tableModel,
                   javax.swing.table.JTableHeader tableHeader)
Method Detail

isCellEditable

public boolean isCellEditable(int row,
                              int column)
DOCUMENT ME!

Specified by:
isCellEditable in interface javax.swing.table.TableModel
Overrides:
isCellEditable in class javax.swing.table.AbstractTableModel
Parameters:
row - DOCUMENT ME!
column - DOCUMENT ME!
Returns:
DOCUMENT ME!

getColumnClass

public java.lang.Class getColumnClass(int column)
DOCUMENT ME!

Specified by:
getColumnClass in interface javax.swing.table.TableModel
Overrides:
getColumnClass in class javax.swing.table.AbstractTableModel
Parameters:
column - DOCUMENT ME!
Returns:
DOCUMENT ME!

setColumnComparator

public void setColumnComparator(java.lang.Class type,
                                java.util.Comparator comparator)
DOCUMENT ME!

Parameters:
type - DOCUMENT ME!
comparator - DOCUMENT ME!

getColumnCount

public int getColumnCount()
DOCUMENT ME!

Returns:
DOCUMENT ME!

getColumnName

public java.lang.String getColumnName(int column)
DOCUMENT ME!

Specified by:
getColumnName in interface javax.swing.table.TableModel
Overrides:
getColumnName in class javax.swing.table.AbstractTableModel
Parameters:
column - DOCUMENT ME!
Returns:
DOCUMENT ME!

getRowCount

public int getRowCount()

isSorting

public boolean isSorting()
DOCUMENT ME!

Returns:
DOCUMENT ME!

setSortingStatus

public void setSortingStatus(int column,
                             int status)
DOCUMENT ME!

Parameters:
column - DOCUMENT ME!
status - DOCUMENT ME!

getSortingStatus

public int getSortingStatus(int column)
DOCUMENT ME!

Parameters:
column - DOCUMENT ME!
Returns:
DOCUMENT ME!

setTableHeader

public void setTableHeader(javax.swing.table.JTableHeader tableHeader)
DOCUMENT ME!

Parameters:
tableHeader - DOCUMENT ME!

getTableHeader

public javax.swing.table.JTableHeader getTableHeader()
DOCUMENT ME!

Returns:
DOCUMENT ME!

setTableModel

public void setTableModel(javax.swing.table.TableModel tableModel)
DOCUMENT ME!

Parameters:
tableModel - DOCUMENT ME!

getTableModel

public javax.swing.table.TableModel getTableModel()
DOCUMENT ME!

Returns:
DOCUMENT ME!

setValueAt

public void setValueAt(java.lang.Object aValue,
                       int row,
                       int column)
DOCUMENT ME!

Specified by:
setValueAt in interface javax.swing.table.TableModel
Overrides:
setValueAt in class javax.swing.table.AbstractTableModel
Parameters:
aValue - DOCUMENT ME!
row - DOCUMENT ME!
column - DOCUMENT ME!

getValueAt

public java.lang.Object getValueAt(int row,
                                   int column)
DOCUMENT ME!

Parameters:
row - DOCUMENT ME!
column - DOCUMENT ME!
Returns:
DOCUMENT ME!

modelIndex

public int modelIndex(int viewIndex)
DOCUMENT ME!

Parameters:
viewIndex - DOCUMENT ME!
Returns:
DOCUMENT ME!

getComparator

protected java.util.Comparator getComparator(int column)
DOCUMENT ME!

Parameters:
column - DOCUMENT ME!
Returns:
DOCUMENT ME!

getHeaderRendererIcon

protected javax.swing.Icon getHeaderRendererIcon(int column,
                                                 int size)
DOCUMENT ME!

Parameters:
column - DOCUMENT ME!
size - DOCUMENT ME!
Returns:
DOCUMENT ME!