FileDocCategorySizeDatePackage
DefaultTableModel.javaAPI DocJava SE 5 API23889Fri Aug 26 14:58:14 BST 2005javax.swing.table

DefaultTableModel

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 JavaBeansTM has been added to the java.beans package. Please see {@link java.beans.XMLEncoder}.

version
1.39 12/19/03
author
Philip Milne
see
TableModel
see
#getDataVector

Fields Summary
protected Vector
dataVector
The Vector of Vectors of Object values.
protected Vector
columnIdentifiers
The Vector of column identifiers.
Constructors Summary
public DefaultTableModel()
Constructs a default DefaultTableModel which is a table of zero columns and zero rows.

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

param
rowCount the number of rows the table holds
param
columnCount the number of columns the table holds
see
#setValueAt

        this(newVector(columnCount), rowCount); 
    
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.

param
columnNames vector containing the names of the new columns; if this is null then the model has no columns
param
rowCount the number of rows the table holds
see
#setDataVector
see
#setValueAt

        setDataVector(newVector(rowCount), columnNames);
    
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.

param
columnNames array containing the names of the new columns; if this is null then the model has no columns
param
rowCount the number of rows the table holds
see
#setDataVector
see
#setValueAt

        this(convertToVector(columnNames), rowCount);
    
public DefaultTableModel(Vector data, Vector columnNames)
Constructs a DefaultTableModel and initializes the table by passing data and columnNames to the setDataVector method.

param
data the data of the table, a Vector of Vectors of Object values
param
columnNames vector containing the names of the new columns
see
#getDataVector
see
#setDataVector

        setDataVector(data, columnNames);
    
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.

param
data the data of the table
param
columnNames the names of the columns
see
#getDataVector
see
#setDataVector

        setDataVector(data, columnNames);
    
Methods Summary
public voidaddColumn(java.lang.Object columnName)
Adds a column to the model. The new column will have the identifier columnName, which may be null. This method will send a tableChanged notification message to all the listeners. This method is a cover for addColumn(Object, Vector) which uses null as the data vector.

param
columnName the identifier of the column being added

        addColumn(columnName, (Vector)null);
    
public voidaddColumn(java.lang.Object columnName, java.util.Vector columnData)
Adds a column to the model. The new column will have the identifier columnName, which may be null. columnData is the optional vector of data for the column. If it is null the column is filled with null values. Otherwise, the new data will be added to model starting with the first element going to row 0, etc. This method will send a tableChanged notification message to all the listeners.

param
columnName the identifier of the column being added
param
columnData optional data of the column being added

        columnIdentifiers.addElement(columnName); 
	if (columnData != null) { 
            int columnSize = columnData.size(); 
            if (columnSize > getRowCount()) { 
	        dataVector.setSize(columnSize);
            }
	    justifyRows(0, getRowCount()); 
	    int newColumn = getColumnCount() - 1; 
	    for(int i = 0; i < columnSize; i++) { 
		  Vector row = (Vector)dataVector.elementAt(i);
		  row.setElementAt(columnData.elementAt(i), newColumn); 
	    }
	} 
        else { 
	    justifyRows(0, getRowCount()); 
        }

        fireTableStructureChanged();
    
public voidaddColumn(java.lang.Object columnName, java.lang.Object[] columnData)
Adds a column to the model. The new column will have the identifier columnName. columnData is the optional array of data for the column. If it is null the column is filled with null values. Otherwise, the new data will be added to model starting with the first element going to row 0, etc. This method will send a tableChanged notification message to all the listeners.

see
#addColumn(Object, Vector)

        addColumn(columnName, convertToVector(columnData));
    
public voidaddRow(java.util.Vector rowData)
Adds a row to the end of the model. The new row will contain null values unless rowData is specified. Notification of the row being added will be generated.

param
rowData optional data of the row being added

        insertRow(getRowCount(), rowData);
    
public voidaddRow(java.lang.Object[] rowData)
Adds a row to the end of the model. The new row will contain null values unless rowData is specified. Notification of the row being added will be generated.

param
rowData optional data of the row being added

        addRow(convertToVector(rowData));
    
protected static java.util.VectorconvertToVector(java.lang.Object[] anArray)
Returns a vector that contains the same objects as the array.

param
anArray the array to be converted
return
the new vector; if anArray is null, returns null

        if (anArray == null) { 
            return null;
	}
        Vector v = new Vector(anArray.length);
        for (int i=0; i < anArray.length; i++) {
            v.addElement(anArray[i]);
        }
        return v;
    
protected static java.util.VectorconvertToVector(java.lang.Object[][] anArray)
Returns a vector of vectors that contains the same objects as the array.

param
anArray the double array to be converted
return
the new vector of vectors; if anArray is null, returns null

        if (anArray == null) {
            return null;
	}
        Vector v = new Vector(anArray.length);
        for (int i=0; i < anArray.length; i++) {
            v.addElement(convertToVector(anArray[i]));
        }
        return v;
    
private static intgcd(int i, int j)

	return (j == 0) ? i : gcd(j, i%j); 
    
public intgetColumnCount()
Returns the number of columns in this data table.

return
the number of columns in the model

        return columnIdentifiers.size();
    
public java.lang.StringgetColumnName(int column)
Returns the column name.

return
a name for this column using the string value of the appropriate member in columnIdentifiers. If columnIdentifiers does not have an entry for this index, returns the default name provided by the superclass

        Object id = null; 
	// This test is to cover the case when 
	// getColumnCount has been subclassed by mistake ... 
	if (column < columnIdentifiers.size()) {  
	    id = columnIdentifiers.elementAt(column); 
	}
        return (id == null) ? super.getColumnName(column) 
                            : id.toString();
    
public java.util.VectorgetDataVector()
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);

return
the vector of vectors containing the tables data values
see
#newDataAvailable
see
#newRowsAdded
see
#setDataVector

        return dataVector;
    
public intgetRowCount()
Returns the number of rows in this data table.

return
the number of rows in the model

        return dataVector.size();
    
public java.lang.ObjectgetValueAt(int row, int column)
Returns an attribute value for the cell at row and column.

param
row the row whose value is to be queried
param
column the column whose value is to be queried
return
the value Object at the specified cell
exception
ArrayIndexOutOfBoundsException if an invalid row or column was given

        Vector rowVector = (Vector)dataVector.elementAt(row);
        return rowVector.elementAt(column);
    
public voidinsertRow(int row, java.util.Vector rowData)
Inserts a row at row in the model. The new row will contain null values unless rowData is specified. Notification of the row being added will be generated.

param
row the row index of the row to be inserted
param
rowData optional data of the row being added
exception
ArrayIndexOutOfBoundsException if the row was invalid

	dataVector.insertElementAt(rowData, row); 
	justifyRows(row, row+1); 
        fireTableRowsInserted(row, row);
    
public voidinsertRow(int row, java.lang.Object[] rowData)
Inserts a row at row in the model. The new row will contain null values unless rowData is specified. Notification of the row being added will be generated.

param
row the row index of the row to be inserted
param
rowData optional data of the row being added
exception
ArrayIndexOutOfBoundsException if the row was invalid

        insertRow(row, convertToVector(rowData));
    
public booleanisCellEditable(int row, int column)
Returns true regardless of parameter values.

param
row the row whose value is to be queried
param
column the column whose value is to be queried
return
true
see
#setValueAt

        return true;
    
private voidjustifyRows(int from, int to)

 
	// Sometimes the DefaultTableModel is subclassed 
	// instead of the AbstractTableModel by mistake. 
	// Set the number of rows for the case when getRowCount 
	// is overridden. 
	dataVector.setSize(getRowCount()); 

        for (int i = from; i < to; i++) { 
	    if (dataVector.elementAt(i) == null) { 
		dataVector.setElementAt(new Vector(), i); 
	    }
	    ((Vector)dataVector.elementAt(i)).setSize(getColumnCount());
	}
    
public voidmoveRow(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. After the move, the row that was at index start will be at index to. This method will send a tableChanged notification message to all the listeners.

Examples of moves:

1. moveRow(1,3,5); a|B|C|D|e|f|g|h|i|j|k - before a|e|f|g|h|B|C|D|i|j|k - after

2. moveRow(6,7,1); a|b|c|d|e|f|G|H|i|j|k - before a|G|H|b|c|d|e|f|i|j|k - after

param
start the starting row index to be moved
param
end the ending row index to be moved
param
to the destination of the rows to be moved
exception
ArrayIndexOutOfBoundsException if any of the elements would be moved out of the table's range

 
	int shift = to - start; 
	int first, last; 
	if (shift < 0) { 
	    first = to; 
	    last = end; 
	}
	else { 
	    first = start; 
	    last = to + end - start;  
	}
        rotate(dataVector, first, last + 1, shift); 

        fireTableRowsUpdated(first, last);
    
public voidnewDataAvailable(javax.swing.event.TableModelEvent event)
Equivalent to fireTableChanged.

param
event the change event

        fireTableChanged(event);
    
public voidnewRowsAdded(javax.swing.event.TableModelEvent e)
Ensures that the new rows have the correct number of columns. This is accomplished by using the setSize method in Vector which truncates vectors which are too long, and appends nulls if they are too short. This method also sends out a tableChanged notification message to all the listeners.

param
e this TableModelEvent describes where the rows were added. If null it assumes all the rows were newly added
see
#getDataVector

        justifyRows(e.getFirstRow(), e.getLastRow() + 1); 
        fireTableChanged(e);
    
private static java.util.VectornewVector(int size)

 
	Vector v = new Vector(size); 
	v.setSize(size); 
	return v; 
    
private static java.util.VectornonNullVector(java.util.Vector v)

 
	return (v != null) ? v : new Vector(); 
    
public voidremoveRow(int row)
Removes the row at row from the model. Notification of the row being removed will be sent to all the listeners.

param
row the row index of the row to be removed
exception
ArrayIndexOutOfBoundsException if the row was invalid

        dataVector.removeElementAt(row);
        fireTableRowsDeleted(row, row);
    
private static voidrotate(java.util.Vector v, int a, int b, int shift)

	int size = b - a; 
	int r = size - shift;
	int g = gcd(size, r); 
	for(int i = 0; i < g; i++) {
	    int to = i; 
	    Object tmp = v.elementAt(a + to); 
	    for(int from = (to + r) % size; from != i; from = (to + r) % size) {
		v.setElementAt(v.elementAt(a + from), a + to); 
		to = from; 
	    }
	    v.setElementAt(tmp, a + to); 
	}
    
public voidrowsRemoved(javax.swing.event.TableModelEvent event)
Equivalent to fireTableChanged.

param
event the change event

        fireTableChanged(event);
    
public voidsetColumnCount(int columnCount)
Sets the number of columns in the model. If the new size is greater than the current size, new columns are added to the end of the model with null cell values. If the new size is less than the current size, all columns at index columnCount and greater are discarded.

param
columnCount the new number of columns in the model
see
#setColumnCount

 
	columnIdentifiers.setSize(columnCount); 
	justifyRows(0, getRowCount()); 
	fireTableStructureChanged();
    
public voidsetColumnIdentifiers(java.util.Vector columnIdentifiers)
Replaces the column identifiers in the model. If the number of newIdentifiers is greater than the current number of columns, new columns are added to the end of each row in the model. If the number of newIdentifiers is less than the current number of columns, all the extra columns at the end of a row are discarded.

param
columnIdentifiers vector of column identifiers. If null, set the model to zero columns
see
#setNumRows

	setDataVector(dataVector, columnIdentifiers); 
    
public voidsetColumnIdentifiers(java.lang.Object[] newIdentifiers)
Replaces the column identifiers in the model. If the number of newIdentifiers is greater than the current number of columns, new columns are added to the end of each row in the model. If the number of newIdentifiers is less than the current number of columns, all the extra columns at the end of a row are discarded.

param
newIdentifiers array of column identifiers. If null, set the model to zero columns
see
#setNumRows

        setColumnIdentifiers(convertToVector(newIdentifiers));
    
public voidsetDataVector(java.util.Vector dataVector, java.util.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.

param
dataVector the new data vector
param
columnIdentifiers the names of the columns
see
#getDataVector

        this.dataVector = nonNullVector(dataVector);
        this.columnIdentifiers = nonNullVector(columnIdentifiers); 
	justifyRows(0, getRowCount()); 
        fireTableStructureChanged();
    
public voidsetDataVector(java.lang.Object[][] dataVector, java.lang.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 the names of the new columns.

param
dataVector the new data vector
param
columnIdentifiers the names of the columns
see
#setDataVector(Vector, Vector)

        setDataVector(convertToVector(dataVector), convertToVector(columnIdentifiers));
    
public voidsetNumRows(int rowCount)
Obsolete as of Java 2 platform v1.3. Please use setRowCount instead.

 
        int old = getRowCount();
	if (old == rowCount) { 
	    return; 
	}
	dataVector.setSize(rowCount);
        if (rowCount <= old) {
            fireTableRowsDeleted(rowCount, old-1);
        }
        else {
	    justifyRows(old, rowCount); 
            fireTableRowsInserted(old, rowCount-1);
        }
    
public voidsetRowCount(int rowCount)
Sets the number of rows in the model. If the new size is greater than the current size, new rows are added to the end of the model If the new size is less than the current size, all rows at index rowCount and greater are discarded.

see
#setColumnCount

 
	setNumRows(rowCount); 
    
public voidsetValueAt(java.lang.Object aValue, int row, int column)
Sets the object value for the cell at column and row. aValue is the new value. This method will generate a tableChanged notification.

param
aValue the new value; this can be null
param
row the row whose value is to be changed
param
column the column whose value is to be changed
exception
ArrayIndexOutOfBoundsException if an invalid row or column was given

        Vector rowVector = (Vector)dataVector.elementAt(row);
        rowVector.setElementAt(aValue, column);
        fireTableCellUpdated(row, column);