org.jfree.data.category

Class CategoryToPieDataset

Implemented Interfaces:
Cloneable, Dataset, DatasetChangeListener, EventListener, KeyedValues, ObjectInputValidation, PieDataset, Serializable, Values

public class CategoryToPieDataset
extends AbstractDataset
implements PieDataset, DatasetChangeListener

A PieDataset implementation that obtains its data from one row or column of a CategoryDataset.

Constructor Summary

CategoryToPieDataset(CategoryDataset source, TableOrder extract, int index)
An adaptor class that converts any CategoryDataset into a PieDataset, by taking the values from a single row or column.

Method Summary

void
datasetChanged(DatasetChangeEvent event)
Sends a DatasetChangeEvent to all registered listeners, with this (not the underlying) dataset as the source.
boolean
equals(Object obj)
Tests this dataset for equality with an arbitrary object, returning true if obj is a dataset containing the same keys and values in the same order as this dataset.
int
getExtractIndex()
Returns the index of the row or column from which to extract the data.
TableOrder
getExtractType()
Returns the extract type, which determines whether data is read from one row or one column of the underlying dataset.
int
getIndex(Comparable key)
Returns the index for a given key, or -1 if there is no such key.
int
getItemCount()
Returns the number of items (values) in the collection.
Comparable
getKey(int index)
Returns the key at the specified index.
List
getKeys()
Returns the keys for the dataset.
CategoryDataset
getUnderlyingDataset()
Returns the underlying dataset.
Number
getValue(Comparable key)
Returns the value for a given key.
Number
getValue(int item)
Returns a value from the dataset.

Methods inherited from class org.jfree.data.general.AbstractDataset

addChangeListener, clone, fireDatasetChanged, getGroup, hasListener, notifyListeners, removeChangeListener, setGroup, validateObject

Constructor Details

CategoryToPieDataset

public CategoryToPieDataset(CategoryDataset source,
                            TableOrder extract,
                            int index)
An adaptor class that converts any CategoryDataset into a PieDataset, by taking the values from a single row or column.

If source is null, the created dataset will be empty.

Parameters:
source - the source dataset (null permitted).
extract - extract data from rows or columns? (null not permitted).
index - the row or column index.

Method Details

datasetChanged

public void datasetChanged(DatasetChangeEvent event)
Sends a DatasetChangeEvent to all registered listeners, with this (not the underlying) dataset as the source.
Specified by:
datasetChanged in interface DatasetChangeListener
Parameters:
event - the event (ignored, a new event with this dataset as the source is sent to the listeners).

equals

public boolean equals(Object obj)
Tests this dataset for equality with an arbitrary object, returning true if obj is a dataset containing the same keys and values in the same order as this dataset.
Parameters:
obj - the object to test (null permitted).
Returns:
A boolean.

getExtractIndex

public int getExtractIndex()
Returns the index of the row or column from which to extract the data.
Returns:
The extract index.
Since:
1.0.2

getExtractType

public TableOrder getExtractType()
Returns the extract type, which determines whether data is read from one row or one column of the underlying dataset.
Returns:
The extract type.
Since:
1.0.2

getIndex

public int getIndex(Comparable key)
Returns the index for a given key, or -1 if there is no such key.
Specified by:
getIndex in interface KeyedValues
Parameters:
key - the key.
Returns:
The index for the key, or -1.

getItemCount

public int getItemCount()
Returns the number of items (values) in the collection. If the underlying dataset is null, this method returns zero.
Specified by:
getItemCount in interface Values
Returns:
The item count.

getKey

public Comparable getKey(int index)
Returns the key at the specified index.
Specified by:
getKey in interface KeyedValues
Parameters:
index - the item index (in the range 0 to getItemCount() - 1).
Returns:
The key.

getKeys

public List getKeys()
Returns the keys for the dataset.

If the underlying dataset is null, this method returns an empty list.

Specified by:
getKeys in interface KeyedValues
Returns:
The keys.

getUnderlyingDataset

public CategoryDataset getUnderlyingDataset()
Returns the underlying dataset.
Returns:
The underlying dataset (possibly null).
Since:
1.0.2

getValue

public Number getValue(Comparable key)
Returns the value for a given key. If the key is not recognised, the method should return null (but note that null can be associated with a valid key also).
Specified by:
getValue in interface KeyedValues
Parameters:
key - the key.
Returns:
The value (possibly null).

getValue

public Number getValue(int item)
Returns a value from the dataset.
Specified by:
getValue in interface Values
Parameters:
item - the item index (zero-based).
Returns:
The value (possibly null).