| |||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
DefaultTableModel dm = new DefaultTableModel();
Based on 60 examples
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: DefaultTableModel
returns a
column class of Object
. When
DefaultTableModel
is used with a
TableRowSorter
this will result in extensive use of
toString
, which for non-String
data types
is expensive. If you use DefaultTableModel
with a
TableRowSorter
you are strongly encouraged to override
getColumnClass
to return the appropriate type.
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}.
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 | |
---|---|
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[] columnNames, int rowCount) Constructs a DefaultTableModel with as many
columns as there are elements in columnNames
and rowCount 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(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 |
Adds a column to the model. |
void |
Adds a column to the model. |
void |
Adds a column to the model. |
void |
Adds a row to the end of the model. |
void |
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 |
Returns the number of columns in this data table. |
String |
getColumnName(int column) Returns the column name. |
Vector |
Returns the Vector of Vectors
that contains the table's
data values.
|
int |
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 |
Inserts a row at row in the model.
|
void |
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 |
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, getColumnName, getListeners, getTableModelListeners, isCellEditable, removeTableModelListener, setValueAt |
Methods inherited from class java.lang.Object |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Field Detail |
---|
protected Vector columnIdentifiers
Vector
of column identifiers.
protected Vector dataVector
Vector
of Vectors
of
Object
values.
Constructor Detail |
---|
public DefaultTableModel()
DefaultTableModel
which is a table of zero columns and zero rows.
public DefaultTableModel(int rowCount, int columnCount)
DefaultTableModel
with
rowCount
and columnCount
of
null
object values.
rowCount
- the number of rows the table holdscolumnCount
- the number of columns the table holdspublic DefaultTableModel(Object[] columnNames, int rowCount)
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.
columnNames
- array
containing the names
of the new columns; if this is
null
then the model has no columnsrowCount
- the number of rows the table holdspublic DefaultTableModel(Object[][] data, Object[] columnNames)
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.
data
- the data of the tablecolumnNames
- the names of the columnspublic DefaultTableModel(Vector columnNames, int rowCount)
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.
columnNames
- vector
containing the names
of the new columns; if this is
null
then the model has no columnsrowCount
- the number of rows the table holdspublic DefaultTableModel(Vector data, Vector columnNames)
DefaultTableModel
and initializes the table
by passing data
and columnNames
to the setDataVector
method.
data
- the data of the table, a Vector
of Vector
s of Object
valuescolumnNames
- vector
containing the names
of the new columnsMethod Detail |
---|
public void addColumn(Object columnName)
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.
columnName
- the identifier of the column being addedpublic void addColumn(Object columnName, Object[] columnData)
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.
columnName
columnData
public void addColumn(Object columnName, Vector columnData)
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.
columnName
- the identifier of the column being addedcolumnData
- optional data of the column being addedpublic void addRow(Object[] rowData)
null
values unless rowData
is specified.
Notification of the row being added will be generated.
rowData
- optional data of the row being addedpublic void addRow(Vector rowData)
null
values unless rowData
is specified.
Notification of the row being added will be generated.
rowData
- optional data of the row being addedprotected static Vector convertToVector(Object[] anArray)
anArray
- the array to be convertedanArray
is null
,
returns null
protected static Vector convertToVector(Object[][] anArray)
anArray
- the double array to be convertedanArray
is
null
, returns null
public int getColumnCount()
public String getColumnName(int column)
getColumnName
in class AbstractTableModel
column
columnIdentifiers
.
If columnIdentifiers
does not have an entry
for this index, returns the default
name provided by the superclass.public Vector getDataVector()
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);
public int getRowCount()
public Object getValueAt(int row, int column)
row
and column
.
row
- the row whose value is to be queriedcolumn
- the column whose value is to be queriedpublic void insertRow(int row, Object[] rowData)
row
in the model. The new row
will contain null
values unless rowData
is specified. Notification of the row being added will be generated.
row
- the row index of the row to be insertedrowData
- optional data of the row being addedpublic void insertRow(int row, Vector rowData)
row
in the model. The new row
will contain null
values unless rowData
is specified. Notification of the row being added will be generated.
row
- the row index of the row to be insertedrowData
- optional data of the row being addedpublic boolean isCellEditable(int row, int column)
isCellEditable
in class AbstractTableModel
row
- the row whose value is to be queriedcolumn
- the column whose value is to be queriedpublic void moveRow(int start, int end, int to)
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
start
- the starting row index to be movedend
- the ending row index to be movedto
- the destination of the rows to be movedpublic void newDataAvailable(TableModelEvent event)
fireTableChanged
.
event
- the change eventpublic void newRowsAdded(TableModelEvent e)
setSize
method in
Vector
which truncates vectors
which are too long, and appends null
s if they
are too short.
This method also sends out a tableChanged
notification message to all the listeners.
e
- this TableModelEvent
describes
where the rows were added.
If null
it assumes
all the rows were newly addedpublic void removeRow(int row)
row
from the model. Notification
of the row being removed will be sent to all the listeners.
row
- the row index of the row to be removedpublic void rowsRemoved(TableModelEvent event)
fireTableChanged
.
event
- the change eventpublic void setColumnCount(int columnCount)
null
cell values.
If the new size is less than the current size, all columns at index
columnCount
and greater are discarded.
columnCount
- the new number of columns in the modelpublic void setColumnIdentifiers(Object[] newIdentifiers)
newIdentifier
s 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 newIdentifier
s is less than the current
number of columns, all the extra columns at the end of a row are
discarded.
newIdentifiers
- array of column identifiers.
If null
, set
the model to zero columnspublic void setColumnIdentifiers(Vector columnIdentifiers)
newIdentifier
s 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 newIdentifier
s is less than the current
number of columns, all the extra columns at the end of a row are
discarded.
columnIdentifiers
- vector of column identifiers. If
null
, set the model
to zero columnspublic void setDataVector(Object[][] dataVector, Object[] columnIdentifiers)
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.
dataVector
- the new data vectorcolumnIdentifiers
- the names of the columnspublic void setDataVector(Vector dataVector, Vector columnIdentifiers)
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.
dataVector
- the new data vectorcolumnIdentifiers
- the names of the columnspublic void setNumRows(int rowCount)
setRowCount
instead.
rowCount
public void setRowCount(int rowCount)
rowCount
and greater are discarded.
rowCount
public void setValueAt(Object aValue, int row, int column)
column
and
row
. aValue
is the new value. This method
will generate a tableChanged
notification.
setValueAt
in class AbstractTableModel
aValue
- the new value; this can be nullrow
- the row whose value is to be changedcolumn
- the column whose value is to be changed
| |||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |