Class DefaultTableModel

Fields

dataVector

protected Vector<Vector> dataVector

The Vector of Vectors of Object values.

columnIdentifiers

protected Vector columnIdentifiers

The Vector of column identifiers.

Constructors

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<? extends 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<? extends java.util.Vector>, java.util.Vector<?>), setValueAt(java.lang.Object, int, int)

DefaultTableModel

public DefaultTableModel(Vector<? extends 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<? extends 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<? extends java.util.Vector>, java.util.Vector<?>)

Methods

getDataVector

public Vector<Vector> getDataVector()

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<? extends java.util.Vector>, java.util.Vector<?>)

setDataVector

public void setDataVector(Vector<? extends Vector> dataVector,
                          Vector<?> columnIdentifiers)

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 the names of the new columns.

Parameters:

dataVector - the new data vector

columnIdentifiers - the names of the columns

See Also:

setDataVector(Vector, Vector)

newDataAvailable

public void newDataAvailable(TableModelEvent event)

Equivalent to fireTableChanged.

Parameters:

event - the change event

newRowsAdded

public void newRowsAdded(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.

Parameters:

e - this TableModelEvent describes where the rows were added. If null it assumes all the rows were newly added

See Also:

getDataVector()

rowsRemoved

public void rowsRemoved(TableModelEvent event)

Equivalent to fireTableChanged.

Parameters:

event - the change event

setNumRows

public void setNumRows(int rowCount)

Obsolete as of Java 2 platform v1.3. Please use setRowCount instead.

Parameters:

rowCount - the new number of rows

setRowCount

public void setRowCount(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.

Parameters:

rowCount - number of rows in the model

Since:

1.3

See Also:

setColumnCount(int)

addRow

public void addRow(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.

Parameters:

rowData - optional data of the row being added

addRow

public void addRow(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.

Parameters:

rowData - optional data of the row being added

insertRow

public void insertRow(int row,
                      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.

Parameters:

row - the row index of the row to be inserted

rowData - optional data of the row being added

Throws:

ArrayIndexOutOfBoundsException - if the row was invalid

insertRow

public void insertRow(int row,
                      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.

Parameters:

row - the row index of the row to be inserted

rowData - optional data of the row being added

Throws:

ArrayIndexOutOfBoundsException - if the row was invalid

moveRow

public 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. 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

Parameters:

start - the starting row index to be moved

end - the ending row index to be moved

to - the destination of the rows to be moved

Throws:

ArrayIndexOutOfBoundsException - if any of the elements would be moved out of the table's range

removeRow

public void removeRow(int row)

Removes the row at row from the model. Notification of the row being removed will be sent to all the listeners.

Parameters:

row - the row index of the row to be removed

Throws:

ArrayIndexOutOfBoundsException - if the row was invalid

setColumnIdentifiers

public void setColumnIdentifiers(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.

Parameters:

columnIdentifiers - vector of column identifiers. If null, set the model to zero columns

See Also:

setNumRows(int)

setColumnIdentifiers

public void setColumnIdentifiers(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.

Parameters:

newIdentifiers - array of column identifiers. If null, set the model to zero columns

See Also:

setNumRows(int)

setColumnCount

public void setColumnCount(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.

Parameters:

columnCount - the new number of columns in the model

Since:

1.3

See Also:

setColumnCount(int)

addColumn

public void addColumn(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.

Parameters:

columnName - the identifier of the column being added

addColumn

public void addColumn(Object columnName,
                      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.

Parameters:

columnName - the identifier of the column being added

columnData - optional data of the column being added

addColumn

public void addColumn(Object columnName,
                      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.

Parameters:

columnName - identifier of the newly created column

columnData - new data to be added to the column

See Also:

addColumn(Object, Vector)

getRowCount

public int getRowCount()

Returns the number of rows in this data table.

Specified by:

getRowCount in interface TableModel

Returns:

the number of rows in the model

See Also:

TableModel.getColumnCount()

getColumnCount

public int getColumnCount()

Returns the number of columns in this data table.

Specified by:

getColumnCount in interface TableModel

Returns:

the number of columns in the model

See Also:

TableModel.getRowCount()

getColumnName

public String getColumnName(int column)

Returns the column name.

Specified by:

getColumnName in interface TableModel

Overrides:

getColumnName in class AbstractTableModel

Parameters:

column - the column being queried

Returns:

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.

isCellEditable

public boolean isCellEditable(int row,
                              int column)

Returns true regardless of parameter values.

Specified by:

isCellEditable in interface TableModel

Overrides:

isCellEditable in class AbstractTableModel

Parameters:

row - the row whose value is to be queried

column - the column whose value is to be queried

Returns:

true

See Also:

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

getValueAt

public Object getValueAt(int row,
                         int column)

Returns an attribute value for the cell at row and column.

Specified by:

getValueAt in interface TableModel

Parameters:

row - the row whose value is to be queried

column - the column whose value is to be queried

Returns:

the value Object at the specified cell

Throws:

ArrayIndexOutOfBoundsException - if an invalid row or column was given

setValueAt

public void setValueAt(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.

Specified by:

setValueAt in interface TableModel

Overrides:

setValueAt in class AbstractTableModel

Parameters:

aValue - the new value; this can be null

row - the row whose value is to be changed

column - the column whose value is to be changed

Throws:

ArrayIndexOutOfBoundsException - if an invalid row or column was given

See Also:

TableModel.getValueAt(int, int), TableModel.isCellEditable(int, int)

convertToVector

protected static Vector<Object> convertToVector(Object[] anArray)

Returns a vector that contains the same objects as the array.

Parameters:

anArray - the array to be converted

Returns:

the new vector; if anArray is null, returns null

convertToVector

protected static Vector<Vector<Object>> convertToVector(Object[][] anArray)

Returns a vector of vectors that contains the same objects as the array.

Parameters:

anArray - the double array to be converted

Returns:

the new vector of vectors; if anArray is null, returns null