com.jrefinery.data
Class DefaultCategoryDataset

java.lang.Object
  com.jrefinery.data.AbstractDataset
      com.jrefinery.data.AbstractSeriesDataset
          com.jrefinery.data.DefaultCategoryDataset

All Implemented Interfaces:

CategoryDataset, Dataset, SeriesChangeListener, SeriesDataset

Direct Known Subclasses:

JdbcCategoryDataset

public class DefaultCategoryDataset
extends AbstractSeriesDataset
implements CategoryDataset

A convenience class that provides a default implementation of the CategoryDataset interface.

The standard constructor accepts data in a two dimensional array where the first dimension is the series, and the second dimension is the category.

Field Summary

protected java.lang.Object[]	categories The categories.
protected java.lang.Number[][]	data Storage for the data.
protected java.lang.String[]	seriesNames The series names.

Fields inherited from class com.jrefinery.data.AbstractDataset

listeners

Constructor Summary

DefaultCategoryDataset(double[][] data)

DefaultCategoryDataset(java.lang.Number[][] data)
Constructs a dataset and populates it with data from the array.

DefaultCategoryDataset(java.lang.String[] seriesNames, java.lang.Number[][] data)
Constructs a DefaultCategoryDataset, populates it with data from the array, and uses the supplied names for the series.

DefaultCategoryDataset(java.lang.String[] seriesNames, java.lang.Object[] categories, java.lang.Number[][] data)
Constructs a DefaultCategoryDataset, populates it with data from the array, and uses the supplied names for the series and the supplied objects for the categories.

Method Summary

java.util.List	getCategories() Returns a list of the categories in the dataset.
int	getCategoryCount() Returns the number of categories in the dataset.
int	getSeriesCount() Returns the number of series in the dataset (possibly zero).
java.lang.String	getSeriesName(int series) Returns the name of the specified series.
java.lang.Number	getValue(int series, java.lang.Object category) Returns the data value for one category in a series.
void	setCategories(java.lang.Object[] categories) Sets the categories for the dataset.
void	setSeriesName(int series, java.lang.String name) Sets the name of a series.
void	setSeriesNames(java.lang.String[] seriesNames) Sets the names of all the series in the dataset.
void	setValue(int series, java.lang.Object category, java.lang.Number value) Sets the data value for one category in a series.

Methods inherited from class com.jrefinery.data.AbstractSeriesDataset

getLegendItemCount, getLegendItemLabels, seriesChanged

Methods inherited from class com.jrefinery.data.AbstractDataset

addChangeListener, fireDatasetChanged, notifyListeners, removeChangeListener

Methods inherited from class java.lang.Object

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

Methods inherited from interface com.jrefinery.data.Dataset

addChangeListener, removeChangeListener

Field Detail

seriesNames

protected java.lang.String[] seriesNames

The series names.

categories

protected java.lang.Object[] categories

The categories.

data

protected java.lang.Number[][] data

Storage for the data.

Constructor Detail

DefaultCategoryDataset

public DefaultCategoryDataset(double[][] data)

DefaultCategoryDataset

public DefaultCategoryDataset(java.lang.Number[][] data)

Constructs a dataset and populates it with data from the array.

The array is indexed as data[series][category]. Series and category names are automatically generated - you can change them using the setSeriesName(...) and setCategory(...) methods.

Parameters:

data - The data.

DefaultCategoryDataset

public DefaultCategoryDataset(java.lang.String[] seriesNames,
                              java.lang.Number[][] data)

Constructs a DefaultCategoryDataset, populates it with data from the array, and uses the supplied names for the series.

Category names are generated automatically ("Category 1", "Category 2", etc).

Parameters:

seriesNames - The series names.

data - The data, indexed as data[series][category].

DefaultCategoryDataset

public DefaultCategoryDataset(java.lang.String[] seriesNames,
                              java.lang.Object[] categories,
                              java.lang.Number[][] data)

Constructs a DefaultCategoryDataset, populates it with data from the array, and uses the supplied names for the series and the supplied objects for the categories.

Parameters:

seriesNames - The series names.

categories - The categories.

data - The data, indexed as data[series][category].

Method Detail

getSeriesCount

public int getSeriesCount()

Returns the number of series in the dataset (possibly zero).

Specified by:

getSeriesCount in interface SeriesDataset

Specified by:

getSeriesCount in class AbstractSeriesDataset

Returns:

The number of series in the dataset.

getSeriesName

public java.lang.String getSeriesName(int series)

Returns the name of the specified series.

Specified by:

getSeriesName in interface SeriesDataset

Specified by:

getSeriesName in class AbstractSeriesDataset

Parameters:

series - The index of the required series (zero-based).

setSeriesName

public void setSeriesName(int series,
                          java.lang.String name)

Sets the name of a series.

Parameters:

series - The series (zero-based index).

name - The series name.

setSeriesNames

public void setSeriesNames(java.lang.String[] seriesNames)

Sets the names of all the series in the dataset.

Parameters:

seriesNames - The series names.

getCategoryCount

public int getCategoryCount()

Returns the number of categories in the dataset.

This method is part of the CategoryDataset interface.

Specified by:

getCategoryCount in interface CategoryDataset

Returns:

The number of categories in the dataset.

getCategories

public java.util.List getCategories()

Returns a list of the categories in the dataset.

Supports the CategoryDataset interface.

Specified by:

getCategories in interface CategoryDataset

Returns:

A list of the categories in the dataset.

setCategories

public void setCategories(java.lang.Object[] categories)

Sets the categories for the dataset.

Parameters:

categories - An array of objects representing the categories in the dataset.

getValue

public java.lang.Number getValue(int series,
                                 java.lang.Object category)

Returns the data value for one category in a series.

This method is part of the CategoryDataset interface.

Specified by:

getValue in interface CategoryDataset

Parameters:

series - The required series (zero based index).

category - The required category.

Returns:

The data value for one category in a series (null possible).

setValue

public void setValue(int series,
                     java.lang.Object category,
                     java.lang.Number value)

Sets the data value for one category in a series.

Parameters:

series - The series (zero-based index).

category - The category.

value - The value.