javax.swing.table
Class DefaultTableModel

java.lang.Object   
  javax.swing.table.AbstractTableModel   
      javax.swing.table.DefaultTableModel

All Implemented Interfaces:

Serializable , TableModel

public class DefaultTableModel
extends AbstractTableModel   
implements Serializable   

This is an implementation of TableModel that uses a Vector of Vectors to store the cell value objects.

Warning: Serialized objects of this class will not be compatible with future Swing releases. The current serialization support is appropriate for short term storage or RMI between applications running the same version of Swing. As of 1.4, support for long term storage of all JavaBeans^TM has been added to the java.beans package. Please see XMLEncoder .

See Also:

TableModel , getDataVector() , Serialized Form

Field Summary

protected Vector	columnIdentifiers The Vector of column identifiers.
protected Vector	dataVector The Vector of Vectors of Object values.

Fields inherited from class javax.swing.table.AbstractTableModel

listenerList

Constructor Summary

DefaultTableModel ()
Constructs a default DefaultTableModel which is a table of zero columns and zero rows.

DefaultTableModel (int rowCount, int columnCount)
Constructs a DefaultTableModel with rowCount and columnCount of null object values.

DefaultTableModel (Object [][] data, Object [] columnNames)
Constructs a DefaultTableModel and initializes the table by passing data and columnNames to the setDataVector method.

DefaultTableModel (Object [] columnNames, int rowCount)
Constructs a DefaultTableModel with as many columns as there are elements in columnNames and rowCount of null object values.

DefaultTableModel (Vector columnNames, int rowCount)
Constructs a DefaultTableModel with as many columns as there are elements in columnNames and rowCount of null object values.

DefaultTableModel (Vector data, Vector columnNames)
Constructs a DefaultTableModel and initializes the table by passing data and columnNames to the setDataVector method.

Method Summary

void	addColumn (Object columnName) Adds a column to the model.
void	addColumn (Object columnName, Object [] columnData) Adds a column to the model.
void	addColumn (Object columnName, Vector columnData) Adds a column to the model.
void	addRow (Object [] rowData) Adds a row to the end of the model.
void	addRow (Vector rowData) Adds a row to the end of the model.
protected static Vector	convertToVector (Object [] anArray) Returns a vector that contains the same objects as the array.
protected static Vector	convertToVector (Object [][] anArray) Returns a vector of vectors that contains the same objects as the array.
int	getColumnCount () Returns the number of columns in this data table.
String	getColumnName (int column) Returns the column name.
Vector	getDataVector () Returns the Vector of Vectors that contains the table's data values.
int	getRowCount () Returns the number of rows in this data table.
Object	getValueAt (int row, int column) Returns an attribute value for the cell at row and column.
void	insertRow (int row, Object [] rowData) Inserts a row at row in the model.
void	insertRow (int row, Vector rowData) Inserts a row at row in the model.
boolean	isCellEditable (int row, int column) Returns true regardless of parameter values.
void	moveRow (int start, int end, int to) Moves one or more rows from the inclusive range start to end to the to position in the model.
void	newDataAvailable (TableModelEvent event) Equivalent to fireTableChanged.
void	newRowsAdded (TableModelEvent e) Ensures that the new rows have the correct number of columns.
void	removeRow (int row) Removes the row at row from the model.
void	rowsRemoved (TableModelEvent event) Equivalent to fireTableChanged.
void	setColumnCount (int columnCount) Sets the number of columns in the model.
void	setColumnIdentifiers (Object [] newIdentifiers) Replaces the column identifiers in the model.
void	setColumnIdentifiers (Vector columnIdentifiers) Replaces the column identifiers in the model.
void	setDataVector (Object [][] dataVector, Object [] columnIdentifiers) Replaces the value in the dataVector instance variable with the values in the array dataVector.
void	setDataVector (Vector dataVector, Vector columnIdentifiers) Replaces the current dataVector instance variable with the new Vector of rows, dataVector.
void	setNumRows (int rowCount) Obsolete as of Java 2 platform v1.3.
void	setRowCount (int rowCount) Sets the number of rows in the model.
void	setValueAt (Object aValue, int row, int column) Sets the object value for the cell at column and row.

Methods inherited from class javax.swing.table.AbstractTableModel

addTableModelListener , findColumn , fireTableCellUpdated , fireTableChanged , fireTableDataChanged , fireTableRowsDeleted , fireTableRowsInserted , fireTableRowsUpdated , fireTableStructureChanged , getColumnClass , getListeners , getTableModelListeners , removeTableModelListener

Methods inherited from class java.lang.Object

clone , equals , finalize , getClass , hashCode , notify , notifyAll , toString , wait , wait , wait

Field Detail

dataVector

protected Vector    dataVector

The Vector of Vectors of Object values.

columnIdentifiers

protected Vector    columnIdentifiers

The Vector of column identifiers.

Constructor Detail

DefaultTableModel

public DefaultTableModel()

Constructs a default DefaultTableModel which is a table of zero columns and zero rows.

DefaultTableModel

public DefaultTableModel(int rowCount,
                         int columnCount)

Constructs a DefaultTableModel with rowCount and columnCount of null object values.

Parameters:

rowCount - the number of rows the table holds

columnCount - the number of columns the table holds

See Also:

setValueAt(java.lang.Object, int, int)

DefaultTableModel

public DefaultTableModel(Vector    columnNames,
                         int rowCount)

Constructs a DefaultTableModel with as many columns as there are elements in columnNames and rowCount of null object values. Each column's name will be taken from the columnNames vector.

Parameters:

columnNames - vector containing the names of the new columns; if this is null then the model has no columns

rowCount - the number of rows the table holds

See Also:

setDataVector(java.util.Vector, java.util.Vector) , setValueAt(java.lang.Object, int, int)

DefaultTableModel

public DefaultTableModel(Object   [] columnNames,
                         int rowCount)

Constructs a DefaultTableModel with as many columns as there are elements in columnNames and rowCount of null object values. Each column's name will be taken from the columnNames array.

Parameters:

columnNames - array containing the names of the new columns; if this is null then the model has no columns

rowCount - the number of rows the table holds

See Also:

setDataVector(java.util.Vector, java.util.Vector) , setValueAt(java.lang.Object, int, int)

DefaultTableModel

public DefaultTableModel(Vector    data,
                         Vector    columnNames)

Constructs a DefaultTableModel and initializes the table by passing data and columnNames to the setDataVector method.

Parameters:

data - the data of the table, a Vector of Vectors of Object values

columnNames - vector containing the names of the new columns

See Also:

getDataVector() , setDataVector(java.util.Vector, java.util.Vector)

DefaultTableModel

public DefaultTableModel(Object   [][] data,
                         Object   [] columnNames)

Constructs a DefaultTableModel and initializes the table by passing data and columnNames to the setDataVector method. The first index in the Object[][] array is the row index and the second is the column index.

Parameters:

data - the data of the table

columnNames - the names of the columns

See Also:

getDataVector() , setDataVector(java.util.Vector, java.util.Vector)

Method Detail

getDataVector

public Vector    getDataVector()

Returns the Vector of Vectors that contains the table's data values. The vectors contained in the outer vector are each a single row of values. In other words, to get to the cell at row 1, column 5:

((Vector)getDataVector().elementAt(1)).elementAt(5);

Returns:

the vector of vectors containing the tables data values

See Also:

newDataAvailable(javax.swing.event.TableModelEvent) , newRowsAdded(javax.swing.event.TableModelEvent) , setDataVector(java.util.Vector, java.util.Vector)

setDataVector

public void setDataVector(Vector    dataVector,
                          Vector    columnIdentifiers)

Replaces the current dataVector instance variable with the new Vector of rows, dataVector. Each row is represented in dataVector as a Vector of Object values. columnIdentifiers are the names of the new columns. The first name in columnIdentifiers is mapped to column 0 in dataVector. Each row in dataVector is adjusted to match the number of columns in columnIdentifiers either by truncating the Vector if it is too long, or adding null values if it is too short.

Note that passing in a null value for dataVector results in unspecified behavior, an possibly an exception.

Parameters:

dataVector - the new data vector

columnIdentifiers - the names of the columns

See Also:

getDataVector()

setDataVector

public void setDataVector(Object   [][] dataVector,
                          Object   [] columnIdentifiers)

Replaces the value in the dataVector instance variable with the values in the array dataVector. The first index in the Object[][] array is the row index and the second is the column index. columnIdentifiers are t