ilog.views.chart.datax.flat.list

Interface IlvFlatListModel

All Superinterfaces:

IlvBatchable, IlvModelWithColumns, IlvObjectModelWithColumns

All Known Implementing Classes:

IlvAbstractFlatListModel, IlvBasicFlatListModel, IlvBufferFlatListModel, IlvDefaultFlatListModel, IlvFilteredFlatListModel, IlvFilterFlatListModel, IlvFlatSetToFlatListModel, IlvFlatTableToFlatListModel, IlvListToFlatListModel, IlvPropertyBasedFlatListModel, IlvSortedFlatListModel, IlvTreeListToFlatListModel

public interface IlvFlatListModel
extends IlvObjectModelWithColumns, IlvBatchable

This interface represents data that can be viewed through a structured chart in an object-oriented way.

The data consists of an ordered set of objects, each having a value for a given set of attributes. The attributes are called columns; in this perspective, the objects correspond to rows of a table.

The columns have some metainformation, like the column number, name, value type, and so on.

In the implementations of this model that are only connected to the JViews Chart component, you can implement the setValueAt and setDoubleAt methods as empty: these methods are not invoked by the JViews Charts view.

Since:

JViews 7.5

See Also:

IlvDataColumnInfo, IlvAbstractFlatListModel, IlvDefaultFlatListModel, FlatListModelEvent, FlatListModelListener

Field Summary

Fields

Modifier and Type	Field and Description
static int	BEFORE_COLUMN_REMOVED_MASK When returned by getSupportedEventsMask(), this bit mask denotes that a FlatListModelEvent.Type.BEFORE_COLUMN_REMOVED event is guaranteed to be fired before every FlatListModelEvent.Type.COLUMN_REMOVED event.
static int	BEFORE_DATA_CHANGE_MASK When returned by getSupportedEventsMask(), this bit mask denotes that a FlatListModelEvent.Type.BEFORE_DATA_CHANGE event is guaranteed to be fired before every FlatListModelEvent.Type.DATA_CHANGED event.
static int	BEFORE_OBJECTS_REMOVED_MASK When returned by getSupportedEventsMask(), this bit mask denotes that a FlatListModelEvent.Type.BEFORE_OBJECTS_REMOVED event is guaranteed to be fired before every FlatListModelEvent.Type.OBJECTS_REMOVED event.

Method Summary

Modifier and Type	Method and Description
void	addFlatListModelListener(FlatListModelListener listener) Adds a listener.
void	endBatch() Terminates a group of modifications.
IlvDataColumnInfo	getColumn(int columnIndex) Returns metainformation about a column.
int	getColumnCount() Returns the number of columns in the model.
double	getDoubleAt(Object object, int columnIndex) Returns the value for the attribute number columnIndex in the given object.
List<? extends Object>	getObjects() Returns the objects in this 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(Object object, int columnIndex) Returns the value for the attribute number columnIndex in the given object.
void	removeFlatListModelListener(FlatListModelListener listener) Removes a listener.
void	setDoubleAt(double value, Object object, int columnIndex) Sets the value for the attribute number columnIndex in the given object to the given value.
void	setValueAt(Object value, Object object, int columnIndex) Sets the value for the attribute number columnIndex in the given object to the given value.
void	startBatch() Starts a group of modifications.

Field Detail

BEFORE_DATA_CHANGE_MASK

static final int BEFORE_DATA_CHANGE_MASK

When returned by getSupportedEventsMask(), this bit mask denotes that a FlatListModelEvent.Type.BEFORE_DATA_CHANGE event is guaranteed to be fired before every FlatListModelEvent.Type.DATA_CHANGED event.

See Also:

getSupportedEventsMask(), Constant Field Values

BEFORE_OBJECTS_REMOVED_MASK

static final int BEFORE_OBJECTS_REMOVED_MASK

When returned by getSupportedEventsMask(), this bit mask denotes that a FlatListModelEvent.Type.BEFORE_OBJECTS_REMOVED event is guaranteed to be fired before every FlatListModelEvent.Type.OBJECTS_REMOVED event.

See Also:

getSupportedEventsMask(), Constant Field Values

BEFORE_COLUMN_REMOVED_MASK

static final int BEFORE_COLUMN_REMOVED_MASK

When returned by getSupportedEventsMask(), this bit mask denotes that a FlatListModelEvent.Type.BEFORE_COLUMN_REMOVED event is guaranteed to be fired before every FlatListModelEvent.Type.COLUMN_REMOVED event.

See Also:

getSupportedEventsMask(), Constant Field Values

Method Detail

getObjects

List<? extends Object> getObjects()

Returns the objects in this model.

Returns:

An unmodifiable list.

getColumnCount

int getColumnCount()

Returns the number of columns in the model.

Valid column indices range from 0 to getColumnCount()-1 (inclusive).

Specified by:

getColumnCount in interface IlvModelWithColumns

getValueAt

Object getValueAt(Object object,
                  int columnIndex)

Returns the value for the attribute number columnIndex in the given object.

Specified by:

getValueAt in interface IlvObjectModelWithColumns

Parameters:

object - The object (row) in which the value is to be looked up.

columnIndex - The column denoting the attribute whose value is to be looked up.

setValueAt

void setValueAt(Object value,
                Object object,
                int columnIndex)

Sets the value for the attribute number columnIndex in the given object to the given value.

Specified by:

setValueAt in interface IlvObjectModelWithColumns

Parameters:

value - The new value.

object - The object (row) in which the value is to be changed.

columnIndex - The column denoting the attribute whose value is to be changed.

getDoubleAt

double getDoubleAt(Object object,
                   int columnIndex)

Returns the value for the attribute number columnIndex in the given object.

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 IlvObjectModelWithColumns

Parameters:

object - The object (row) in which the value is to be looked up.

columnIndex - The column denoting the attribute whose value is to be looked up.

setDoubleAt

void setDoubleAt(double value,
                 Object object,
                 int columnIndex)

Sets the value for the attribute number columnIndex in the given object 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 IlvObjectModelWithColumns

Parameters:

value - The new value.

object - The object (row) in which the value is to be changed.

columnIndex - The column denoting the attribute whose value is to be changed.

getColumn

IlvDataColumnInfo getColumn(int columnIndex)

Returns metainformation about a column.

Specified by:

getColumn in interface IlvModelWithColumns

Parameters:

columnIndex - The column.

startBatch

void startBatch()

Starts a group of modifications.

Specified by:

startBatch in interface IlvBatchable

endBatch

void endBatch()

Terminates a group of modifications.

Specified by:

endBatch in interface IlvBatchable

addFlatListModelListener

void addFlatListModelListener(FlatListModelListener listener)

Adds a listener. It will be notified each time a change in the data or in the column metainformation occurs.

removeFlatListModelListener

void removeFlatListModelListener(FlatListModelListener listener)

Removes a listener. Unregisters the given listener from the notification list.

getSupportedEventsMask

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.

It is always safe to implement this method by returning 0.

If a given model does not support the events that you need, you can wrap the model in an IlvBufferFlatListModel: the wrapped model will support all events.

See Also:

BEFORE_DATA_CHANGE_MASK, BEFORE_OBJECTS_REMOVED_MASK, BEFORE_COLUMN_REMOVED_MASK