Module org.jfree.chart

Package org.jfree.data.time

Class TimePeriodValues<S extends Comparable<S>>

java.lang.Object

org.jfree.data.general.Series<S>

org.jfree.data.time.TimePeriodValues<S>

All Implemented Interfaces:

Serializable, Cloneable

public class TimePeriodValues<S extends Comparable<S>>
extends Series<S>
implements Serializable

A structure containing zero, one or many TimePeriodValue instances. The time periods can overlap, and are maintained in the order that they are added to the collection.

This is similar to the TimeSeries class, except that the time periods can have irregular lengths.

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor	Description
TimePeriodValues(S name)	Creates a new (empty) collection of time period values.

Method Summary

Modifier and Type	Method	Description
void	add(TimePeriod period, double value)	Adds a new data item to the series and sends a SeriesChangeEvent to all registered listeners.
void	add(TimePeriod period, Number value)	Adds a new data item to the series and sends a SeriesChangeEvent to all registered listeners.
void	add(TimePeriodValue item)	Adds a data item to the series and sends a SeriesChangeEvent to all registered listeners.
Object	clone()	Returns a clone of the collection.
TimePeriodValues	createCopy(int start, int end)	Creates a new instance by copying a subset of the data in this collection.
void	delete(int start, int end)	Deletes data from start until end index (end inclusive) and sends a SeriesChangeEvent to all registered listeners.
boolean	equals(Object obj)	Tests the series for equality with another object.
TimePeriodValue	getDataItem(int index)	Returns one data item for the series.
int	getItemCount()	Returns the number of items in the series.
int	getMaxEndIndex()	Returns the index of the time period with the maximum end milliseconds.
int	getMaxMiddleIndex()	Returns the index of the time period with the maximum middle milliseconds.
int	getMaxStartIndex()	Returns the index of the time period with the maximum start milliseconds.
int	getMinEndIndex()	Returns the index of the time period with the minimum end milliseconds.
int	getMinMiddleIndex()	Returns the index of the time period with the minimum middle milliseconds.
int	getMinStartIndex()	Returns the index of the time period with the minimum start milliseconds.
TimePeriod	getTimePeriod(int index)	Returns the time period at the specified index.
Number	getValue(int index)	Returns the value at the specified index.
int	hashCode()	Returns a hash code value for the object.
void	update(int index, Number value)	Updates (changes) the value of a data item and sends a SeriesChangeEvent to all registered listeners.

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

addChangeListener, fireSeriesChanged, getKey, getNotify, isEmpty, notifyListeners, removeChangeListener, setNotify

Methods inherited from class java.lang.Object

finalize, getClass, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

TimePeriodValues

public TimePeriodValues(S name)

Creates a new (empty) collection of time period values.

Parameters:

name - the name of the series (null not permitted).

Method Detail

getItemCount

public int getItemCount()

Returns the number of items in the series.

Specified by:

getItemCount in class Series<S extends Comparable<S>>

Returns:

The item count.

getDataItem

public TimePeriodValue getDataItem(int index)

Returns one data item for the series.

Parameters:

index - the item index (in the range 0 to getItemCount() -1).

Returns:

One data item for the series.

getTimePeriod

public TimePeriod getTimePeriod(int index)

Returns the time period at the specified index.

Parameters:

index - the item index (in the range 0 to getItemCount() -1).

Returns:

The time period at the specified index.

See Also:

getDataItem(int)

getValue

public Number getValue(int index)

Returns the value at the specified index.

Parameters:

index - the item index (in the range 0 to getItemCount() -1).

Returns:

The value at the specified index (possibly null).

See Also:

getDataItem(int)

add

public void add(TimePeriodValue item)

Adds a data item to the series and sends a SeriesChangeEvent to all registered listeners.

Parameters:

item - the item (null not permitted).

add

public void add(TimePeriod period,
                double value)

Adds a new data item to the series and sends a SeriesChangeEvent to all registered listeners.

Parameters:

period - the time period (null not permitted).

value - the value.

See Also:

add(TimePeriod, Number)

add

public void add(TimePeriod period,
                Number value)

Adds a new data item to the series and sends a SeriesChangeEvent to all registered listeners.

Parameters:

period - the time period (null not permitted).

value - the value (null permitted).

update

public void update(int index,
                   Number value)

Updates (changes) the value of a data item and sends a SeriesChangeEvent to all registered listeners.

Parameters:

index - the index of the data item to update.

value - the new value (null not permitted).

delete

public void delete(int start,
                   int end)

Deletes data from start until end index (end inclusive) and sends a SeriesChangeEvent to all registered listeners.

Parameters:

start - the index of the first period to delete.

end - the index of the last period to delete.

equals

public boolean equals(Object obj)

Tests the series for equality with another object.

Overrides:

equals in class Series<S extends Comparable<S>>

Parameters:

obj - the object (null permitted).

Returns:

true or false.

hashCode

public int hashCode()

Returns a hash code value for the object.

Overrides:

hashCode in class Series<S extends Comparable<S>>

Returns:

The hashcode

clone

public Object clone()
             throws CloneNotSupportedException

Returns a clone of the collection.

Notes:

• no need to clone the domain and range descriptions, since String object is immutable;
• we pass over to the more general method createCopy(start, end).

Overrides:

clone in class Series<S extends Comparable<S>>

Returns:

A clone of the time series.

Throws:

CloneNotSupportedException - if there is a cloning problem.

createCopy

public TimePeriodValues createCopy(int start,
                                   int end)
                            throws CloneNotSupportedException

Creates a new instance by copying a subset of the data in this collection.

Parameters:

start - the index of the first item to copy.

end - the index of the last item to copy.

Returns:

A copy of a subset of the items.

Throws:

CloneNotSupportedException - if there is a cloning problem.

getMinStartIndex

public int getMinStartIndex()

Returns the index of the time period with the minimum start milliseconds.

Returns:

The index.

getMaxStartIndex

public int getMaxStartIndex()

Returns the index of the time period with the maximum start milliseconds.

Returns:

The index.

getMinMiddleIndex

public int getMinMiddleIndex()

Returns the index of the time period with the minimum middle milliseconds.

Returns:

The index.

getMaxMiddleIndex

public int getMaxMiddleIndex()

Returns the index of the time period with the maximum middle milliseconds.

Returns:

The index.

getMinEndIndex

public int getMinEndIndex()

Returns the index of the time period with the minimum end milliseconds.

Returns:

The index.

getMaxEndIndex

public int getMaxEndIndex()

Returns the index of the time period with the maximum end milliseconds.

Returns:

The index.