org.jfree.data.xy

Class DefaultHighLowDataset

Implemented Interfaces:
Cloneable, Dataset, EventListener, ObjectInputValidation, OHLCDataset, Serializable, SeriesChangeListener, SeriesDataset, XYDataset

public class DefaultHighLowDataset
extends AbstractXYDataset
implements OHLCDataset

A simple implementation of the OHLCDataset interface. See also the DefaultOHLCDataset class, which provides another implementation that is very similar.

Constructor Summary

DefaultHighLowDataset(Comparable seriesKey, Date[] date, double[] high, double[] low, double[] open, double[] close, double[] volume)
Constructs a new high/low/open/close dataset.

Method Summary

static Number[]
createNumberArray(double[] data)
Constructs an array of Number objects from an array of doubles.
boolean
equals(Object obj)
Tests this dataset for equality with an arbitrary instance.
Number
getClose(int series, int item)
Returns the close-value for one item in a series.
double
getCloseValue(int series, int item)
Returns the close-value (as a double primitive) for an item within a series.
Number
getHigh(int series, int item)
Returns the high-value for one item in a series.
double
getHighValue(int series, int item)
Returns the high-value (as a double primitive) for an item within a series.
int
getItemCount(int series)
Returns the number of items in the specified series.
Number
getLow(int series, int item)
Returns the low-value for one item in a series.
double
getLowValue(int series, int item)
Returns the low-value (as a double primitive) for an item within a series.
Number
getOpen(int series, int item)
Returns the open-value for one item in a series.
double
getOpenValue(int series, int item)
Returns the open-value (as a double primitive) for an item within a series.
int
getSeriesCount()
Returns the number of series in the dataset.
Comparable
getSeriesKey(int series)
Returns the key for the series stored in this dataset.
Number
getVolume(int series, int item)
Returns the volume-value for one item in a series.
double
getVolumeValue(int series, int item)
Returns the volume-value (as a double primitive) for an item within a series.
Number
getX(int series, int item)
Returns the x-value for one item in a series.
Date
getXDate(int series, int item)
Returns the x-value for one item in a series, as a Date.
Number
getY(int series, int item)
Returns the y-value for one item in a series.

Methods inherited from class org.jfree.data.xy.AbstractXYDataset

getDomainOrder, getXValue, getYValue

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

getSeriesCount, getSeriesKey, indexOf, seriesChanged

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

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

Constructor Details

DefaultHighLowDataset

public DefaultHighLowDataset(Comparable seriesKey,
                             Date[] date,
                             double[] high,
                             double[] low,
                             double[] open,
                             double[] close,
                             double[] volume)
Constructs a new high/low/open/close dataset.

The current implementation allows only one series in the dataset. This may be extended in a future version.

Parameters:
seriesKey - the key for the series (null not permitted).
date - the dates (null not permitted).
high - the high values (null not permitted).
low - the low values (null not permitted).
open - the open values (null not permitted).
close - the close values (null not permitted).
volume - the volume values (null not permitted).

Method Details

createNumberArray

public static Number[] createNumberArray(double[] data)
Constructs an array of Number objects from an array of doubles.
Parameters:
data - the double values to convert (null not permitted).
Returns:
The data as an array of Number objects.

equals

public boolean equals(Object obj)
Tests this dataset for equality with an arbitrary instance.
Parameters:
obj - the object (null permitted).
Returns:
A boolean.

getClose

public Number getClose(int series,
                       int item)
Returns the close-value for one item in a series.
Specified by:
getClose in interface OHLCDataset
Parameters:
series - the series (zero-based index).
item - the item (zero-based index).
Returns:
The close-value.

getCloseValue

public double getCloseValue(int series,
                            int item)
Returns the close-value (as a double primitive) for an item within a series.
Specified by:
getCloseValue in interface OHLCDataset
Parameters:
series - the series (zero-based index).
item - the item (zero-based index).
Returns:
The close-value.

getHigh

public Number getHigh(int series,
                      int item)
Returns the high-value for one item in a series.
Specified by:
getHigh in interface OHLCDataset
Parameters:
series - the series (zero-based index).
item - the item (zero-based index).
Returns:
The high-value.

getHighValue

public double getHighValue(int series,
                           int item)
Returns the high-value (as a double primitive) for an item within a series.
Specified by:
getHighValue in interface OHLCDataset
Parameters:
series - the series (zero-based index).
item - the item (zero-based index).
Returns:
The high-value.

getItemCount

public int getItemCount(int series)
Returns the number of items in the specified series.
Specified by:
getItemCount in interface XYDataset
Parameters:
series - the index (zero-based) of the series.
Returns:
The number of items in the specified series.

getLow

public Number getLow(int series,
                     int item)
Returns the low-value for one item in a series.
Specified by:
getLow in interface OHLCDataset
Parameters:
series - the series (zero-based index).
item - the item (zero-based index).
Returns:
The low-value.

getLowValue

public double getLowValue(int series,
                          int item)
Returns the low-value (as a double primitive) for an item within a series.
Specified by:
getLowValue in interface OHLCDataset
Parameters:
series - the series (zero-based index).
item - the item (zero-based index).
Returns:
The low-value.

getOpen

public Number getOpen(int series,
                      int item)
Returns the open-value for one item in a series.
Specified by:
getOpen in interface OHLCDataset
Parameters:
series - the series (zero-based index).
item - the item (zero-based index).
Returns:
The open-value.

getOpenValue

public double getOpenValue(int series,
                           int item)
Returns the open-value (as a double primitive) for an item within a series.
Specified by:
getOpenValue in interface OHLCDataset
Parameters:
series - the series (zero-based index).
item - the item (zero-based index).
Returns:
The open-value.

getSeriesCount

public int getSeriesCount()
Returns the number of series in the dataset.

This implementation only allows one series.

Specified by:
getSeriesCount in interface SeriesDataset
Overrides:
getSeriesCount in interface AbstractSeriesDataset
Returns:
The number of series.

getSeriesKey

public Comparable getSeriesKey(int series)
Returns the key for the series stored in this dataset.
Specified by:
getSeriesKey in interface SeriesDataset
Overrides:
getSeriesKey in interface AbstractSeriesDataset
Parameters:
series - the index of the series (ignored, this dataset supports only one series and this method always returns the key for series 0).
Returns:
The series key (never null).

getVolume

public Number getVolume(int series,
                        int item)
Returns the volume-value for one item in a series.
Specified by:
getVolume in interface OHLCDataset
Parameters:
series - the series (zero-based index).
item - the item (zero-based index).
Returns:
The volume-value.

getVolumeValue

public double getVolumeValue(int series,
                             int item)
Returns the volume-value (as a double primitive) for an item within a series.
Specified by:
getVolumeValue in interface OHLCDataset
Parameters:
series - the series (zero-based index).
item - the item (zero-based index).
Returns:
The volume-value.

getX

public Number getX(int series,
                   int item)
Returns the x-value for one item in a series. The value returned is a Long instance generated from the underlying Date object. To avoid generating a new object instance, you might prefer to call getXValue(int,int).
Specified by:
getX in interface XYDataset
Parameters:
series - the series (zero-based index).
item - the item (zero-based index).
Returns:
The x-value.

getXDate

public Date getXDate(int series,
                     int item)
Returns the x-value for one item in a series, as a Date.

This method is provided for convenience only.

Parameters:
series - the series (zero-based index).
item - the item (zero-based index).
Returns:
The x-value as a Date.
See Also:
getX(int,int)

getY

public Number getY(int series,
                   int item)
Returns the y-value for one item in a series.

This method (from the XYDataset interface) is mapped to the getCloseValue(int,int) method.

Specified by:
getY in interface XYDataset
Parameters:
series - the series (zero-based index).
item - the item (zero-based index).
Returns:
The y-value.