ilog.views.chart.data

Class IlvDefaultDataSource

java.lang.Object

ilog.views.chart.data.IlvAbstractDataSource

ilog.views.chart.data.IlvDefaultDataSource

All Implemented Interfaces:

IlvDataSource, IlvBatchable, Serializable

public class IlvDefaultDataSource
extends IlvAbstractDataSource

A default data source implementation. This class allows you to modify directly the data source contents by adding/removing data sets.

Since:

JViews 5.0

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor and Description
IlvDefaultDataSource() Creates a new, empty data source.
IlvDefaultDataSource(double[][] values, int xSeriesIdx, String[] names, String[] dataLabels) Creates a new data source and initializes it with the specified data.
IlvDefaultDataSource(IlvDataSet[] dataSets) Creates a new data source and initializes it with the specified data sets.

Method Summary

Modifier and Type	Method and Description
void	addDataSet(IlvDataSet dataSet) Adds a new data set at the end of this data source.
void	addDataSet(int index, IlvDataSet dataSet) Inserts a new data set at the specified position.
IlvDataSet	getDataSetAtPosition(int targetIndex) Returns the data set at a specified target position.
void	setDataSet(int idx, IlvDataSet dataSet) Replaces the data set at the specified position.
void	setDataSetAtPosition(int targetIndex, IlvDataSet dataSet) Sets the data set at a specified target position.
void	setDataSets(IlvDataSet[] dataSets) Initializes this data source with the specified data sets.

Methods inherited from class ilog.views.chart.data.IlvAbstractDataSource

addDataSourceListener, containsDataSet, endBatch, fireDataSourceEvent, getDataSet, getDataSetByName, getDataSetCount, getDataSetIndex, getDataSetIterator, getDataSetList, getDataSets, initDataSets, removeDataSourceListener, startBatch

Methods inherited from class java.lang.Object

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

Constructor Detail

IlvDefaultDataSource

public IlvDefaultDataSource()

Creates a new, empty data source.

IlvDefaultDataSource

public IlvDefaultDataSource(IlvDataSet[] dataSets)

Creates a new data source and initializes it with the specified data sets.

IlvDefaultDataSource

public IlvDefaultDataSource(double[][] values,
                            int xSeriesIdx,
                            String[] names,
                            String[] dataLabels)

Creates a new data source and initializes it with the specified data.

See Also:

IlvDefaultDataSet.create(double[][], int, java.lang.String[], java.lang.String[])

Method Detail

setDataSet

public void setDataSet(int idx,
                       IlvDataSet dataSet)

Replaces the data set at the specified position.

Note: In order to set all data sets using this method, you must perform the invocations of this method in a particular order: with increasing indices.

Specified by:

setDataSet in interface IlvDataSource

Overrides:

setDataSet in class IlvAbstractDataSource

Parameters:

idx - The index of the data set to replace.

dataSet - The new data set. If this parameter is null, the data set at the index idx is removed.

addDataSet

public void addDataSet(IlvDataSet dataSet)

Adds a new data set at the end of this data source.

Specified by:

addDataSet in interface IlvDataSource

Overrides:

addDataSet in class IlvAbstractDataSource

addDataSet

public void addDataSet(int index,
                       IlvDataSet dataSet)

Inserts a new data set at the specified position.

Specified by:

addDataSet in interface IlvDataSource

Overrides:

addDataSet in class IlvAbstractDataSource

setDataSets

public void setDataSets(IlvDataSet[] dataSets)

Initializes this data source with the specified data sets.

Specified by:

setDataSets in interface IlvDataSource

Overrides:

setDataSets in class IlvAbstractDataSource

Parameters:

dataSets - The new data sets. If this parameter is null, all the data sets provided by this data source are removed.

getDataSetAtPosition

public IlvDataSet getDataSetAtPosition(int targetIndex)

Returns the data set at a specified target position.

This method considers only data sets added with setDataSetAtPosition(int, ilog.views.chart.data.IlvDataSet).

Parameters:

targetIndex - The registered target index of the searched data set. This is not necessarily its current index.

Returns:

A data set, or null.

Since:

JViews 8.1

See Also:

setDataSetAtPosition(int, ilog.views.chart.data.IlvDataSet)

setDataSetAtPosition

public void setDataSetAtPosition(int targetIndex,
                                 IlvDataSet dataSet)

Sets the data set at a specified target position.

Unlike setDataSet(int, ilog.views.chart.data.IlvDataSet), this method remembers the target position for each data set; temporarily the index of the data set may be smaller than the target index. Therefore, with this method, it is possible to set all data sets through invocations in an arbitrary order.

Since:

JViews 8.1