Module org.jfree.chart

Package org.jfree.data

Interface KeyedValues<K extends Comparable<K>>

All Superinterfaces:

Values

All Known Subinterfaces:

KeyedValuesDataset<K>, PieDataset<K>

All Known Implementing Classes:

CategoryToPieDataset, DefaultKeyedValues, DefaultKeyedValuesDataset, DefaultPieDataset

public interface KeyedValues<K extends Comparable<K>>
extends Values

An ordered list of (key, value) items where the keys are unique and non-null.

See Also:

Values, DefaultKeyedValues

Method Summary

Modifier and Type	Method	Description
int	getIndex(K key)	Returns the index for a given key.
K	getKey(int index)	Returns the key associated with the item at a given position.
List<K>	getKeys()	Returns the keys for the values in the collection.
Number	getValue(K key)	Returns the value for a given key.

Methods inherited from interface org.jfree.data.Values

getItemCount, getValue

Method Detail

getKey

K getKey(int index)

Returns the key associated with the item at a given position. Note that some implementations allow re-ordering of the data items, so the result may be transient.

Parameters:

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

Returns:

The key (never null).

Throws:

IndexOutOfBoundsException - if index is not in the specified range.

getIndex

int getIndex(K key)

Returns the index for a given key.

Parameters:

key - the key (null not permitted).

Returns:

The index, or -1 if the key is unrecognised.

Throws:

IllegalArgumentException - if key is null.

getKeys

List<K> getKeys()

Returns the keys for the values in the collection. Note that you can access the values in this collection by key or by index. For this reason, the key order is important - this method should return the keys in order. The returned list may be unmodifiable.

Returns:

The keys (never null).

getValue

Number getValue(K key)

Returns the value for a given key.

Parameters:

key - the key.

Returns:

The value (possibly null).

Throws:

UnknownKeyException - if the key is not recognised.