Module org.jfree.chart

Package org.jfree.data

Class KeyToGroupMap<K extends Comparable<K>,G extends Comparable<G>>

java.lang.Object

org.jfree.data.KeyToGroupMap<K,G>

All Implemented Interfaces:

Serializable, Cloneable, PublicCloneable

public class KeyToGroupMap<K extends Comparable<K>,G extends Comparable<G>>
extends Object
implements Cloneable, PublicCloneable, Serializable

A class that maps keys (instances of Comparable) to groups.

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor	Description
KeyToGroupMap()	Creates a new map with a default group named 'Default Group'.
KeyToGroupMap(G defaultGroup)	Creates a new map with the specified default group.

Method Summary

Modifier and Type	Method	Description
Object	clone()	Returns a clone of the map.
boolean	equals(Object obj)	Tests the map for equality against an arbitrary object.
G	getGroup(K key)	Returns the group that a key is mapped to.
int	getGroupCount()	Returns the number of groups in the map.
int	getGroupIndex(G group)	Returns the index for the group.
List<G>	getGroups()	Returns a list of the groups (always including the default group) in the map.
int	getKeyCount(G group)	Returns the number of keys mapped to the specified group.
int	hashCode()
void	mapKeyToGroup(K key, G group)	Maps a key to a group.

Methods inherited from class java.lang.Object

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

Constructor Detail

KeyToGroupMap

public KeyToGroupMap()

Creates a new map with a default group named 'Default Group'.

KeyToGroupMap

public KeyToGroupMap(G defaultGroup)

Creates a new map with the specified default group.

Parameters:

defaultGroup - the default group (null not permitted).

Method Detail

getGroupCount

public int getGroupCount()

Returns the number of groups in the map.

Returns:

The number of groups in the map.

getGroups

public List<G> getGroups()

Returns a list of the groups (always including the default group) in the map. The returned list is independent of the map, so altering the list will have no effect.

Returns:

The groups (never null).

getGroupIndex

public int getGroupIndex(G group)

Returns the index for the group.

Parameters:

group - the group.

Returns:

The group index (or -1 if the group is not represented within the map).

getGroup

public G getGroup(K key)

Returns the group that a key is mapped to.

Parameters:

key - the key (null not permitted).

Returns:

The group (never null, returns the default group if there is no mapping for the specified key).

mapKeyToGroup

public void mapKeyToGroup(K key,
                          G group)

Maps a key to a group.

Parameters:

key - the key (null not permitted).

group - the group (null permitted, clears any existing mapping).

getKeyCount

public int getKeyCount(G group)

Returns the number of keys mapped to the specified group. This method won't always return an accurate result for the default group, since explicit mappings are not required for this group.

Parameters:

group - the group (null not permitted).

Returns:

The key count.

equals

public boolean equals(Object obj)

Tests the map for equality against an arbitrary object.

Overrides:

equals in class Object

Parameters:

obj - the object to test against (null permitted).

Returns:

A boolean.

hashCode

public int hashCode()

Overrides:

hashCode in class Object

clone

public Object clone()
             throws CloneNotSupportedException

Returns a clone of the map.

Specified by:

clone in interface PublicCloneable

Overrides:

clone in class Object

Returns:

A clone.

Throws:

CloneNotSupportedException - if there is a problem cloning the map.