meka.gui.core

Class SortableAndSearchableWrapperTableModel

java.lang.Object

javax.swing.table.AbstractTableModel

meka.gui.core.SortableAndSearchableWrapperTableModel

All Implemented Interfaces:

Serializable, EventListener, TableModelListener, TableModel, SearchableTableModel, SortableTableModel

public class SortableAndSearchableWrapperTableModel
extends AbstractTableModel
implements TableModelListener, SortableTableModel, SearchableTableModel

Wraps around any table model and makes them automatically sortable and searchable.

Version:

$Revision: 10824 $

Author:

fracpete (fracpete at waikato dot ac dot nz)

See Also:

Serialized Form

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	SortableAndSearchableWrapperTableModel.SortContainer Helper class for sorting the columns.

Field Summary

Fields

Modifier and Type	Field and Description
protected boolean[]	m_ColumnIsNumeric whether a column is numeric.
protected gnu.trove.list.array.TIntArrayList	m_DisplayIndices the indices of the rows to display that match a search string.
protected TableModel	m_Model the actual table model.
protected MouseListener	m_MouseListener the mouse listener in use.
protected boolean	m_RegExpSearch whether the search was a regular expression based one.
protected String	m_SearchString the string that was searched for.
protected boolean	m_SortAscending whether sorting is ascending or descending.
protected int	m_SortColumn the sort column.
protected int[]	m_SortedIndices the mapping between displayed and actual index.

Fields inherited from class javax.swing.table.AbstractTableModel

listenerList

Constructor Summary

Constructors

Constructor and Description
SortableAndSearchableWrapperTableModel() initializes with no model.
SortableAndSearchableWrapperTableModel(TableModel model) initializes with the given model.

Method Summary

Modifier and Type	Method and Description
void	addMouseListenerToHeader(JTable table) Adds a mouselistener to the header: left-click on the header sorts in ascending manner, using shift-left-click in descending manner.
int	getActualRow(int visibleRow) Returns the actual underlying row the given visible one represents.
int	getActualRowCount() Returns the actual row count in the model.
Class	getColumnClass(int columnIndex) Returns the most specific superclass for all the cell values in the column.
protected Class	getColumnClassForComparison(int columnIndex) Returns the class of the column.
int	getColumnCount() Returns the number of columns in the model.
String	getColumnName(int columnIndex) Returns the name of the column at columnIndex.
int	getDisplayRow(int internalRow) Returns the "visible" row derived from row in the actual table model.
MouseListener	getHeaderMouseListener() Returns the mouse listener that got assigned to the header, if any.
int	getRowCount() Returns the number of rows in the model.
String	getSeachString() Returns the current search string.
int	getSortColumn() Returns the sort column.
TableModel	getUnsortedModel() returns the underlying model, can be null.
Object	getValueAt(int rowIndex, int columnIndex) Returns the value for the cell at columnIndex and rowIndex.
protected Object	getValueForComparison(int row, int column) Returns the value used in the comparison.
protected void	initialize() Initializes indices etc.
protected void	initializeColumnTypes() Determines which column is a numeric one (skipped in search).
protected void	initializeSortIndices() (re-)initializes the indices.
boolean	isAscending() Returns whether sorting is ascending or not.
boolean	isCellEditable(int rowIndex, int columnIndex) Returns true if the cell at rowIndex and columnIndex is editable.
protected boolean	isColumnNumeric(int colIndex) Returns whether the specified column is numeric.
protected boolean	isInitialized() whether the model is initialized.
boolean	isRegExpSearch() Returns whether the last search was a regular expression based one.
boolean	isSearchMatch(SearchParameters params, int row) Tests whether the search matches the specified row.
boolean	isSorted() returns whether the table was sorted.
void	search(String searchString, boolean regexp) Performs a search for the given string.
void	setUnsortedModel(TableModel value) Sets the model to use.
void	setUnsortedModel(TableModel value, boolean restoreSorting) Sets the model to use.
void	setValueAt(Object aValue, int rowIndex, int columnIndex) Sets the value in the cell at columnIndex and rowIndex to aValue.
void	sort(int columnIndex) sorts the table over the given column (ascending).
void	sort(int columnIndex, boolean ascending) sorts the table over the given column, either ascending or descending.
void	tableChanged(TableModelEvent e) This fine grain notification tells listeners the exact range of cells, rows, or columns that changed.

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

Methods inherited from interface javax.swing.table.TableModel

addTableModelListener, removeTableModelListener

Field Detail

m_Model

protected TableModel m_Model

the actual table model.

m_SortedIndices

protected int[] m_SortedIndices

the mapping between displayed and actual index.

m_SortColumn

protected int m_SortColumn

the sort column.

m_SortAscending

protected boolean m_SortAscending

whether sorting is ascending or descending.

m_MouseListener

protected MouseListener m_MouseListener

the mouse listener in use.

m_SearchString

protected String m_SearchString

the string that was searched for.

m_RegExpSearch

protected boolean m_RegExpSearch

whether the search was a regular expression based one.

m_DisplayIndices

protected gnu.trove.list.array.TIntArrayList m_DisplayIndices

the indices of the rows to display that match a search string.

m_ColumnIsNumeric

protected boolean[] m_ColumnIsNumeric

whether a column is numeric.

Constructor Detail

SortableAndSearchableWrapperTableModel

public SortableAndSearchableWrapperTableModel()

initializes with no model.

SortableAndSearchableWrapperTableModel

public SortableAndSearchableWrapperTableModel(TableModel model)

initializes with the given model.

Parameters:

model - the model to initialize the sorted model with

Method Detail

setUnsortedModel

public void setUnsortedModel(TableModel value)

Sets the model to use. Discards any sorting.

Specified by:

setUnsortedModel in interface SortableTableModel

Parameters:

value - the model to use

setUnsortedModel

public void setUnsortedModel(TableModel value,
                             boolean restoreSorting)

Sets the model to use.

Parameters:

value - the model to use

restoreSorting - whether to restore the sorting (if any)

getUnsortedModel

public TableModel getUnsortedModel()

returns the underlying model, can be null.

Specified by:

getUnsortedModel in interface SortableTableModel

Returns:

the current model

initialize

protected void initialize()

Initializes indices etc.

initializeColumnTypes

protected void initializeColumnTypes()

Determines which column is a numeric one (skipped in search).

isColumnNumeric

protected boolean isColumnNumeric(int colIndex)

Returns whether the specified column is numeric.

Parameters:

colIndex - the index of the column

Returns:

true if numeric

See Also:

m_ColumnIsNumeric, initializeColumnTypes()

initializeSortIndices

protected void initializeSortIndices()

(re-)initializes the indices.

isSorted

public boolean isSorted()

returns whether the table was sorted.

Specified by:

isSorted in interface SortableTableModel

Returns:

true if the table was sorted

getSortColumn

public int getSortColumn()

Returns the sort column.

Specified by:

getSortColumn in interface SortableTableModel

Returns:

the sort column

isAscending

public boolean isAscending()

Returns whether sorting is ascending or not.

Specified by:

isAscending in interface SortableTableModel

Returns:

true if ascending

See Also:

isSorted(), getSortColumn()

isInitialized

protected boolean isInitialized()

whether the model is initialized.

Returns:

true if the model is not null and the sort indices match the number of rows

getActualRow

public int getActualRow(int visibleRow)

Returns the actual underlying row the given visible one represents. Useful for retrieving "non-visual" data that is also stored in a TableModel.

Specified by:

getActualRow in interface SearchableTableModel

Specified by:

getActualRow in interface SortableTableModel

Parameters:

visibleRow - the displayed row to retrieve the original row for

Returns:

the original row

getDisplayRow

public int getDisplayRow(int internalRow)

Returns the "visible" row derived from row in the actual table model.

Specified by:

getDisplayRow in interface SortableTableModel

Parameters:

internalRow - the row in the actual model

Returns:

the row in the sorted model, -1 in case of an error

getColumnClass

public Class getColumnClass(int columnIndex)

Returns the most specific superclass for all the cell values in the column.

Specified by:

getColumnClass in interface TableModel

Overrides:

getColumnClass in class AbstractTableModel

Parameters:

columnIndex - the index of the column

Returns:

the class of the specified column

getColumnCount

public int getColumnCount()

Returns the number of columns in the model.

Specified by:

getColumnCount in interface TableModel

Returns:

the number of columns in the model

getColumnName

public String getColumnName(int columnIndex)

Returns the name of the column at columnIndex.

Specified by:

getColumnName in interface TableModel

Overrides:

getColumnName in class AbstractTableModel

Parameters:

columnIndex - the column to retrieve the name for

Returns:

the name of the specified column

getRowCount

public int getRowCount()

Returns the number of rows in the model.

Specified by:

getRowCount in interface TableModel

Returns:

the number of rows in the model

getValueAt

public Object getValueAt(int rowIndex,
                         int columnIndex)

Returns the value for the cell at columnIndex and rowIndex.

Specified by:

getValueAt in interface TableModel

Parameters:

rowIndex - the row

columnIndex - the column

Returns:

the value of the sepcified cell

isCellEditable

public boolean isCellEditable(int rowIndex,
                              int columnIndex)

Returns true if the cell at rowIndex and columnIndex is editable.

Specified by:

isCellEditable in interface TableModel

Overrides:

isCellEditable in class AbstractTableModel

Parameters:

rowIndex - the row

columnIndex - the column

Returns:

true if the cell is editable

setValueAt

public void setValueAt(Object aValue,
                       int rowIndex,
                       int columnIndex)

Sets the value in the cell at columnIndex and rowIndex to aValue.

Specified by:

setValueAt in interface TableModel

Overrides:

setValueAt in class AbstractTableModel

Parameters:

aValue - the new value of the cell

rowIndex - the row

columnIndex - the column

getColumnClassForComparison

protected Class getColumnClassForComparison(int columnIndex)

Returns the class of the column.

Parameters:

columnIndex - the index of the column

Returns:

the class of the column

sort

public void sort(int columnIndex)

sorts the table over the given column (ascending).

Specified by:

sort in interface SortableTableModel

Parameters:

columnIndex - the column to sort over

sort

public void sort(int columnIndex,
                 boolean ascending)

sorts the table over the given column, either ascending or descending.

Specified by:

sort in interface SortableTableModel

Parameters:

columnIndex - the column to sort over

ascending - ascending if true, otherwise descending

getValueForComparison

protected Object getValueForComparison(int row,
                                       int column)

Returns the value used in the comparison.

Parameters:

row - the row of the cell

column - the column of the cell

Returns:

the cell value

tableChanged

public void tableChanged(TableModelEvent e)

This fine grain notification tells listeners the exact range of cells, rows, or columns that changed.

Specified by:

tableChanged in interface TableModelListener

Parameters:

e - the event

addMouseListenerToHeader

public void addMouseListenerToHeader(JTable table)

Adds a mouselistener to the header: left-click on the header sorts in ascending manner, using shift-left-click in descending manner.

Parameters:

table - the table to add the listener to

getHeaderMouseListener

public MouseListener getHeaderMouseListener()

Returns the mouse listener that got assigned to the header, if any.

Returns:

the listener, can be null

getActualRowCount

public int getActualRowCount()

Returns the actual row count in the model.

Specified by:

getActualRowCount in interface SearchableTableModel

Returns:

the row count in the underlying data

isSearchMatch

public boolean isSearchMatch(SearchParameters params,
                             int row)

Tests whether the search matches the specified row.

Default implementation just checks against the strings that getValueAt(...) returns (using the toString() method of the returned objects). Derived classes should override this method in order to implement a proper/faster search functionality. Skips numeric columns.

Parameters:

params - the search parameters

row - the row of the underlying, unsorted model

Returns:

true if the search matches this row

search

public void search(String searchString,
                   boolean regexp)

Performs a search for the given string. Limits the display of rows to ones containing the search string.

Specified by:

search in interface SearchableTableModel

Parameters:

searchString - the string to search for

regexp - whether to perform regular expression matching or just plain string comparison

getSeachString

public String getSeachString()

Returns the current search string.

Specified by:

getSeachString in interface SearchableTableModel

Returns:

the search string, null if not filtered

isRegExpSearch

public boolean isRegExpSearch()

Returns whether the last search was a regular expression based one.

Specified by:

isRegExpSearch in interface SearchableTableModel

Returns:

true if last search was a reg exp one