ilog.views.chart.datax.adapter

Class IlvTableToFlatTableModel

java.lang.Object

ilog.views.chart.datax.flat.table.IlvAbstractFlatTableModel

ilog.views.chart.datax.flat.table.IlvBasicFlatTableModel

ilog.views.chart.datax.flat.table.IlvDefaultFlatTableModel

ilog.views.chart.datax.adapter.IlvTableToFlatTableModel

All Implemented Interfaces:

IlvFlatTableModel, IlvDataConverter, IlvModelWithColumns, IlvBatchable, Cloneable

public class IlvTableToFlatTableModel
extends IlvDefaultFlatTableModel

This class implements an IlvFlatTableModel, based on a Swing TableModel.

Note: This model supports adding and removing rows if and only if the underlying TableModel is an instance of DefaultTableModel.

Since:

JViews 7.5

Field Summary

Fields inherited from interface ilog.views.chart.datax.flat.table.IlvFlatTableModel

BEFORE_COLUMN_REMOVED_MASK, BEFORE_DATA_CHANGE_MASK, BEFORE_ROWS_REMOVED_MASK

Constructor Summary

Constructors

Constructor and Description
IlvTableToFlatTableModel(TableModel model) Creates a model backed by a given TableModel.
IlvTableToFlatTableModel(TableModel model, IlvDataColumnInfo[] columns) Creates a model backed by a given TableModel, with the given columns.
IlvTableToFlatTableModel(TableModel model, IlvDataColumnInfo[] columns, int eventsMaskHint) Creates a model backed by a given TableModel, with the given columns.
IlvTableToFlatTableModel(TableModel model, int eventsMaskHint) Creates a model backed by a given TableModel.

Method Summary

Modifier and Type	Method and Description
Object	clone() Returns a copy of this object.
protected ilog.views.chart.datax.flat.internal.storage.IlvColumnStorage	createColumnStorage(IlvDataColumnInfo column) Creates the backing storage for column values.
void	disconnect() Drops references to objects to help garbage collection.
void	dispose() Cleans up this model and drops references to objects to help garbage collection.
double	getDoubleAt(int rowIndex, int columnIndex) Returns the value for the cell at columnIndex and rowIndex, as a numeric value.
int	getRowCount() Returns the number of rows in the model.
int	getSupportedEventsMask() Returns a bit mask denoting the optional kinds of events that are guaranteed to be sent by this model to the registered listeners.
Object	getValueAt(int rowIndex, int columnIndex) Returns the value for the cell at columnIndex and rowIndex.
void	insertColumn(int columnIndex, IlvDataColumnInfo column) Adds a column to the model at a given index.
void	insertColumn(int columnIndex, IlvDataColumnInfo column, double[] data) Adds a column with given data to the model at a given index.
void	insertColumn(int columnIndex, IlvDataColumnInfo column, Object[] data) Adds a column with given data to the model at a given index.
void	insertRow(int rowIndex, Object[] rowData) Adds a row to the model at a given index.
void	insertRows(int rowIndex, int count) Adds some rows to the model at a given index.
protected boolean	isColumnComputed(int columnIndex) Returns true if setValueAtInternal and setDoubleAtInternal have no effect on a given column.
void	removeColumn(int columnIndex) Removes a column from the model.
void	removeRows(int rowIndex, int count) Removes some rows from the model.
void	setColumnCount(int columnCount) Sets the number of columns in the model.
void	setDoubleAt(double value, int rowIndex, int columnIndex) Sets the value in the cell at columnIndex and rowIndex to the given value.
protected boolean	setDoubleAtInternal(double value, int rowIndex, int columnIndex, boolean forReal) Does the equivalent of a setDoubleAt().
void	setRowCount(int rowCount) Sets the number of rows in the model.
void	setValueAt(Object value, int rowIndex, int columnIndex) Sets the value in the cell at columnIndex and rowIndex to the given value.
protected boolean	setValueAtInternal(Object value, int rowIndex, int columnIndex, boolean forReal) Does the equivalent of a setValueAt().

Methods inherited from class ilog.views.chart.datax.flat.table.IlvDefaultFlatTableModel

addRow, addRow, insertRow, removeRow

Methods inherited from class ilog.views.chart.datax.flat.table.IlvBasicFlatTableModel

addColumn, addColumn, addColumn, fireModelEvent, getColumn, getColumnCount, getColumns, setColumn, setColumns

Methods inherited from class ilog.views.chart.datax.flat.table.IlvAbstractFlatTableModel

addFlatTableModelListener, convertToDouble, endBatch, removeFlatTableModelListener, startBatch

Methods inherited from class java.lang.Object

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

Constructor Detail

IlvTableToFlatTableModel

public IlvTableToFlatTableModel(TableModel model)

Creates a model backed by a given TableModel.

Parameters:

model - The underlying model.

IlvTableToFlatTableModel

public IlvTableToFlatTableModel(TableModel model,
                                int eventsMaskHint)

Creates a model backed by a given TableModel.

Parameters:

model - The underlying model.

eventsMaskHint - Desired events mask. This is just a hint; there is no guarantee that the event types designated by the mask are supported by this model.

Since:

JViews 8.0

IlvTableToFlatTableModel

public IlvTableToFlatTableModel(TableModel model,
                                IlvDataColumnInfo[] columns)

Creates a model backed by a given TableModel, with the given columns.

Parameters:

model - The underlying model.

columns - The detail meta info about the columns should be consistent with the given model.

IlvTableToFlatTableModel

public IlvTableToFlatTableModel(TableModel model,
                                IlvDataColumnInfo[] columns,
                                int eventsMaskHint)

Creates a model backed by a given TableModel, with the given columns.

Parameters:

model - The underlying model.

columns - The detail meta info about the columns should be consistent with the given model.

eventsMaskHint - Desired events mask. This is just a hint; there is no guarantee that the event types designated by the mask are supported by this model.

Since:

JViews 8.0

Method Detail

getRowCount

public int getRowCount()

Returns the number of rows in the model.

Valid row indices range from 0 to getRowCount()-1 (inclusive).

Specified by:

getRowCount in interface IlvFlatTableModel

Overrides:

getRowCount in class IlvDefaultFlatTableModel

getValueAt

public Object getValueAt(int rowIndex,
                         int columnIndex)

Returns the value for the cell at columnIndex and rowIndex.

Specified by:

getValueAt in interface IlvFlatTableModel

Overrides:

getValueAt in class IlvDefaultFlatTableModel

getDoubleAt

public double getDoubleAt(int rowIndex,
                          int columnIndex)

Returns the value for the cell at columnIndex and rowIndex, as a numeric value.

This method should only be used for columns whose type is Double. For other types of columns, this method will do a conversion from the object returned by getValueAt, which may be inefficient or inaccurate or raise exceptions.

Specified by:

getDoubleAt in interface IlvFlatTableModel

Overrides:

getDoubleAt in class IlvDefaultFlatTableModel

setValueAtInternal

protected boolean setValueAtInternal(Object value,
                                     int rowIndex,
                                     int columnIndex,
                                     boolean forReal)

Does the equivalent of a setValueAt(). Instead of notifying it simply returns a boolean indicating whether notification should be done.

If forReal is false, the value is not actually set, but the method still returns the same Boolean, indicating whether the given value is different from the previous one.

Overrides:

setValueAtInternal in class IlvDefaultFlatTableModel

setDoubleAtInternal

protected boolean setDoubleAtInternal(double value,
                                      int rowIndex,
                                      int columnIndex,
                                      boolean forReal)

Does the equivalent of a setDoubleAt(). Instead of notifying it simply returns a boolean indicating whether notification should be done.

If forReal is false, the value is not actually set, but the method still returns the same Boolean, indicating whether the given value is different from the previous one.

Overrides:

setDoubleAtInternal in class IlvDefaultFlatTableModel

isColumnComputed

protected boolean isColumnComputed(int columnIndex)

Returns true if setValueAtInternal and setDoubleAtInternal have no effect on a given column.

Overrides:

isColumnComputed in class IlvBasicFlatTableModel

setValueAt

public void setValueAt(Object value,
                       int rowIndex,
                       int columnIndex)

Sets the value in the cell at columnIndex and rowIndex to the given value.

Specified by:

setValueAt in interface IlvFlatTableModel

Overrides:

setValueAt in class IlvBasicFlatTableModel

Parameters:

value - The new value.

rowIndex - The row containing the cell whose value is to be changed.

columnIndex - The column containing the cell whose value is to be changed.

setDoubleAt

public void setDoubleAt(double value,
                        int rowIndex,
                        int columnIndex)

Sets the value in the cell at columnIndex and rowIndex to the given value.

This method should only be used for columns whose type is Double. For other types of columns, this method will do a conversion to the column type, which may be inefficient or inaccurate or raise exceptions.

Specified by:

setDoubleAt in interface IlvFlatTableModel

Overrides:

setDoubleAt in class IlvBasicFlatTableModel

Parameters:

value - The new value.

rowIndex - The row containing the cell whose value is to be changed.

columnIndex - The column containing the cell whose value is to be changed.

getSupportedEventsMask

public int getSupportedEventsMask()

Returns a bit mask denoting the optional kinds of events that are guaranteed to be sent by this model to the registered listeners.

This implementation returns BEFORE_COLUMN_REMOVED_MASK, intersected with the eventsMaskHint constructor argument. It may need to be overridden in subclasses.

Specified by:

getSupportedEventsMask in interface IlvFlatTableModel

Overrides:

getSupportedEventsMask in class IlvDefaultFlatTableModel

See Also:

IlvFlatTableModel.BEFORE_DATA_CHANGE_MASK, IlvFlatTableModel.BEFORE_ROWS_REMOVED_MASK, IlvFlatTableModel.BEFORE_COLUMN_REMOVED_MASK

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.

Overrides:

setRowCount in class IlvDefaultFlatTableModel

Parameters:

rowCount - The new number of rows.

insertRows

public void insertRows(int rowIndex,
                       int count)

Adds some rows to the model at a given index.

Overrides:

insertRows in class IlvDefaultFlatTableModel

Parameters:

rowIndex - The first new row desired index, must be >= 0 and <= getRowCount().

count - The number of rows to be inserted.

insertRow

public void insertRow(int rowIndex,
                      Object[] rowData)

Adds a row to the model at a given index.

Overrides:

insertRow in class IlvDefaultFlatTableModel

Parameters:

rowIndex - The new row desired index, must be >= 0 and <= getRowCount().

rowData - The initial data of this row, must be an array of getColumnCount() elements.

removeRows

public void removeRows(int rowIndex,
                       int count)

Removes some rows from the model.

Overrides:

removeRows in class IlvDefaultFlatTableModel

Parameters:

rowIndex - The first old row index, must be >= 0 and <= getRowCount() - count.

count - The number of rows to be removed.

createColumnStorage

protected ilog.views.chart.datax.flat.internal.storage.IlvColumnStorage createColumnStorage(IlvDataColumnInfo column)

Description copied from class: IlvBasicFlatTableModel

Creates the backing storage for column values. This method can return null if the methods getValueAt and getDoubleAt do not need backing store.

Overrides:

createColumnStorage in class IlvBasicFlatTableModel

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. If the new size is less than the current size, all columns at index columnCount and greater are discarded.

Overrides:

setColumnCount in class IlvBasicFlatTableModel

Parameters:

columnCount - The new number of columns.

insertColumn

public void insertColumn(int columnIndex,
                         IlvDataColumnInfo column)

Adds a column to the model at a given index.

Overrides:

insertColumn in class IlvBasicFlatTableModel

Parameters:

columnIndex - The new column desired index, must be >= 0 and <= getColumnCount().

column - The metainformation of this column.

insertColumn

public void insertColumn(int columnIndex,
                         IlvDataColumnInfo column,
                         Object[] data)

Adds a column with given data to the model at a given index.

Overrides:

insertColumn in class IlvBasicFlatTableModel

Parameters:

columnIndex - The new column desired index, must be >= 0 and <= getColumnCount().

column - The metainformation of this column.

data - The initial data of this column. This should be an array of at least getRowCount() elements. Unused if the column is a computed column.

insertColumn

public void insertColumn(int columnIndex,
                         IlvDataColumnInfo column,
                         double[] data)

Adds a column with given data to the model at a given index.

Overrides:

insertColumn in class IlvBasicFlatTableModel

Parameters:

columnIndex - The new column desired index, must be >= 0 and <= getColumnCount().

column - The metainformation of this column.

data - The initial data of this column. This should be an array of at least getRowCount() elements. Unused if the column is a computed column.

removeColumn

public void removeColumn(int columnIndex)

Removes a column from the model.

Overrides:

removeColumn in class IlvBasicFlatTableModel

Parameters:

columnIndex - The column index, must be >= 0 and < getColumnCount().

dispose

public void dispose()

Cleans up this model and drops references to objects to help garbage collection.

Note: After calling this function, this model is no longer functional.

Overrides:

dispose in class IlvBasicFlatTableModel

disconnect

public void disconnect()

Drops references to objects to help garbage collection.

Note: After calling this function, and after some changes occurred in the underlying model or columns, this model is no longer functional.

Overrides:

disconnect in class IlvBasicFlatTableModel

Since:

JViews 8.0

clone

public Object clone()

Returns a copy of this object.

Overrides:

clone in class IlvDefaultFlatTableModel