Java Doc for EnhancedTableModel.java in  » Database-Client » iSQL-Viewer » org » isqlviewer » swing » table » Java Source Code / Java DocumentationJava Source Code and Java Documentation

This implementation of the TableModel interface mainly address the lack of some column oriented methods, also i liked some of the methods provided by the default DefaultTableModel like removeRow addRow, etc.

This is a fairly good table mode to use if you need a fast WORM type table model, i do not recommend using this class if you have to make lots of changes since the data storage is only synchronized when it is set or removed and not read.
author:
   Markus A. Kobold <mkobold at sprintpcs dot com>
version:
   1.0

This makes for easier explicit declarations of what class a column rather than based on what it is.

This method will iterate through the given collection c, and for each row in the underlying data store, the item is added to the each row.

This method will clone the given ArrayList and then add that reference to underlying data collection.

This method will not copy the existing TableModelListeners to the copied TableModel.

This will take the true row count divided by the page size.

This will return true if there is no data in the underlying data collection.

Explicitly declares that the given column is of type clazz, this method a complement to the getColumnClass(int) method.

This will add blanks strings if current column count is less than the given size other wise column items will be removed to fit the given size.

For each row that doesn't meet the given column count an empty Object will be put in place.

This will replace the exisitng column name string with the given name at the specified index.

This data flavor seems to make DnD to native apps like Excel work.

This makes for easier explicit declarations of what class a column rather than based on what it is. This is paticularly useful when used in conjuction of JTable that is basing a renderer on an interface class.

This method will create an empty table model with no columns or rows of any kind.
See Also:   EnhancedTableModel.EnhancedTableModel(String[])

Creates a table model with the following column names initially, The model will have no rows of any kind though.

This will also poll the SystemConfig object to automatically set the preferred paging size based on the KEY_TABLE_PAGE_SIZE property key.
Parameters:
  columns - array of strings to be column names.

This method will iterate through the given collection c, and for each row in the underlying data store, the item is added to the each row. If the collection does not contain the correct number of items which should correspond to the current number of rows, empty object will put in place.

This method will fire a TableStructureChanged() to model listeners.
Parameters:
  c - a collection of data representing a table column.
Parameters:
  name - of the column represting this collection.

This method will clone the given ArrayList and then add that reference to underlying data collection. If the given ArrayList is null this method immediately returns.

There is no requirement for the size of the given list as long as it is >= to specified column size you should not experience any erratic behaviour. So it is ok for the given ArrayList to have a size greater than this TableModel Column size.

a fireRowsInserted() will be fired to model listeners.
Parameters:
  lst - Collection of objects to add as row to this table.

This method should not be confused with the clearAll() method, this will only clear the data, and not the column information.

This will fire a TableDataChanged event to TableModel listeners.
See Also:   EnhancedTableModel.clearAll()

This will fire a TableStructureChanged() when done and this table will be completely empty.
See Also:   EnhancedTableModel.clear()

If you need to clear the data without sending a potentially misleading event extenders will want to use this method versus the public clearAll.
See Also:   EnhancedTableModel.clearAll()

If you need to clear the data without sending a potentially misleading event extenders will want to use this method versus the public clear.
See Also:   EnhancedTableModel.clear()

This method will not copy the existing TableModelListeners to the copied TableModel. However all other members values will copied and cloned.
See Also:   java.lang.Object.clone

This will take the true row count divided by the page size. the number returned will always be >= 1
See Also:   EnhancedTableModel.setPageSize(int) int

This the number of rows that determines a *page* this is the number of rows that will show in a JTable at a given time.
See Also:   EnhancedTableModel.getPageCount() int

This will return true if there is no data in the underlying data collection. the number of columns will not affect the results of this methods returned value. boolean to determine the emptiness of this tablemodel data.

This will change the offset by +1 if it is still < page count afterwards a TableChanged event will be then be fired.
See Also:   EnhancedTableModel.getPageCount()
See Also:   EnhancedTableModel.pageUp() boolean on success of the method.

This will change the offset by -1 if it is still > 0 afterwards a TableChanged event will be then be fired.
See Also:   EnhancedTableModel.getPageCount()
See Also:   EnhancedTableModel.pageDown() boolean on success of the method.

This will also ensure that all the
Parameters:
  columnIndex -

This will remove the specified data declared at rowIndex, if the rowIndex is out of range this method will return normally.

upon succesfull removal a fireTableRowsDeleted() will be notified to model listeners.
Parameters:
  rowIndex - the row to be removed from this table.

Explicitly declares that the given column is of type clazz, this method a complement to the getColumnClass(int) method. This method can help when rendering this model correctly within a JTable. Paticularly if you have configured a custom renderer on an interface class e.g. CLOB/BLOB. The JTable currently doesn't aquire the correct renderer if an object is just an instance of something.

e.g.

 Tablemodel mdl = new EnhancedTableModel();
 JTable tab = new JTabel(mdl);
 tab.setDefaultRenderer(Clob.class, new ClobRenderer());
 mdl.addRow(new ArrayList(Arrays.asList(new MyCLOB[]{new MyClob()})));
 

 mdl.setClassForColumn(0, Clob.class);
 

This will add blanks strings if current column count is less than the given size other wise column items will be removed to fit the given size.

For each row that doesn't meet the given column count an empty Object will be put in place. other wise each row will be trimmed down to the given size.

This will fire a TableStructureChanged to model listeners.
Parameters:
  size - the new desired column count.

This will replace the exisitng column name string with the given name at the specified index. if the index is invalid it will be silently ignored.

This will fire a TableStructedChanged() to model listeners.
Parameters:
  idx - the specidex column index to change
Parameters:
  name - is the new column to use, can be null.

This will clear all the exisiting column information and the new colum count will be the length of the given String array.

If the given String[] is null a NullPointerException will most likely be thrown.

This will fire a TableStructureChanged() to model listeners.
Parameters:
  s - is the new set of Columns names for this model.

If the collection contains an object that cannot be type cast to an ArrayList then the object will be skipped, so Vector and Stacks can be in the given collection since they are sub-class of the ArrayList.

Note this method does not mess with the column data information so if you are adding a bunch of rows, where the column counts are off it won't show till you update the column information

This will fire a TableRowsInserted() for the number of ArrayLists actually added.
Parameters:
  c - is a collection of ArrayLists to be used as the data store for this model.

If the given size is less than the current size this will remove any extra rows to get this table model down to the correct row count.
See Also:   ArrayList.ensureCapacity(int)
See Also:   EnhancedTableModel.setColumnCount(int)
Parameters:
  size - the new desire row count for this table model.