Class DefaultPieDataset

java.lang.Object
org.jfree.data.general.AbstractDataset
org.jfree.data.general.DefaultPieDataset
All Implemented Interfaces:
ObjectInputValidation, Serializable, Cloneable, Dataset, PieDataset, KeyedValues, Values, org.jfree.util.PublicCloneable
Direct Known Subclasses:
DefaultKeyedValuesDataset, JDBCPieDataset

public class DefaultPieDataset extends AbstractDataset implements PieDataset, Cloneable, org.jfree.util.PublicCloneable, Serializable
A default implementation of the PieDataset interface.
See Also:
  • Field Details

  • Constructor Details

    • DefaultPieDataset

      public DefaultPieDataset()
      Constructs a new dataset, initially empty.
    • DefaultPieDataset

      public DefaultPieDataset(KeyedValues data)
      Creates a new dataset by copying data from a KeyedValues instance.
      Parameters:
      data - the data (null not permitted).
  • Method Details

    • getItemCount

      public int getItemCount()
      Returns the number of items in the dataset.
      Specified by:
      getItemCount in interface Values
      Returns:
      The item count.
    • getKeys

      public List getKeys()
      Returns the categories in the dataset. The returned list is unmodifiable.
      Specified by:
      getKeys in interface KeyedValues
      Returns:
      The categories in the dataset.
    • getKey

      public Comparable getKey(int item)
      Returns the key for the specified item, or null.
      Specified by:
      getKey in interface KeyedValues
      Parameters:
      item - the item index (in the range 0 to getItemCount() - 1).
      Returns:
      The key, or null.
      Throws:
      IndexOutOfBoundsException - if item is not in the specified range.
    • getIndex

      public int getIndex(Comparable key)
      Returns the index for a key, or -1 if the key is not recognised.
      Specified by:
      getIndex in interface KeyedValues
      Parameters:
      key - the key (null not permitted).
      Returns:
      The index, or -1 if the key is unrecognised.
      Throws:
      IllegalArgumentException - if key is null.
    • getValue

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

      public Number getValue(Comparable key)
      Returns the data value associated with a key.
      Specified by:
      getValue in interface KeyedValues
      Parameters:
      key - the key (null not permitted).
      Returns:
      The value (possibly null).
      Throws:
      UnknownKeyException - if the key is not recognised.
    • setValue

      public void setValue(Comparable key, Number value)
      Sets the data value for a key and sends a DatasetChangeEvent to all registered listeners.
      Parameters:
      key - the key (null not permitted).
      value - the value.
      Throws:
      IllegalArgumentException - if key is null.
    • setValue

      public void setValue(Comparable key, double value)
      Sets the data value for a key and sends a DatasetChangeEvent to all registered listeners.
      Parameters:
      key - the key (null not permitted).
      value - the value.
      Throws:
      IllegalArgumentException - if key is null.
    • insertValue

      public void insertValue(int position, Comparable key, double value)
      Inserts a new value at the specified position in the dataset or, if there is an existing item with the specified key, updates the value for that item and moves it to the specified position. After the change is made, this methods sends a DatasetChangeEvent to all registered listeners.
      Parameters:
      position - the position (in the range 0 to getItemCount()).
      key - the key (null not permitted).
      value - the value (null permitted).
      Since:
      1.0.6
    • insertValue

      public void insertValue(int position, Comparable key, Number value)
      Inserts a new value at the specified position in the dataset or, if there is an existing item with the specified key, updates the value for that item and moves it to the specified position. After the change is made, this methods sends a DatasetChangeEvent to all registered listeners.
      Parameters:
      position - the position (in the range 0 to getItemCount()).
      key - the key (null not permitted).
      value - the value (null permitted).
      Since:
      1.0.6
    • remove

      public void remove(Comparable key)
      Removes an item from the dataset and sends a DatasetChangeEvent to all registered listeners.
      Parameters:
      key - the key (null not permitted).
      Throws:
      IllegalArgumentException - if key is null.
    • clear

      public void clear()
      Clears all data from this dataset and sends a DatasetChangeEvent to all registered listeners (unless the dataset was already empty).
      Since:
      1.0.2
    • sortByKeys

      public void sortByKeys(org.jfree.util.SortOrder order)
      Sorts the dataset's items by key and sends a DatasetChangeEvent to all registered listeners.
      Parameters:
      order - the sort order (null not permitted).
      Since:
      1.0.3
    • sortByValues

      public void sortByValues(org.jfree.util.SortOrder order)
      Sorts the dataset's items by value and sends a DatasetChangeEvent to all registered listeners.
      Parameters:
      order - the sort order (null not permitted).
      Since:
      1.0.3
    • equals

      public boolean equals(Object obj)
      Tests if this object is equal to another.
      Overrides:
      equals in class Object
      Parameters:
      obj - the other object.
      Returns:
      A boolean.
    • hashCode

      public int hashCode()
      Returns a hash code.
      Overrides:
      hashCode in class Object
      Returns:
      A hash code.
    • clone

      public Object clone() throws CloneNotSupportedException
      Returns a clone of the dataset.
      Specified by:
      clone in interface org.jfree.util.PublicCloneable
      Overrides:
      clone in class AbstractDataset
      Returns:
      A clone.
      Throws:
      CloneNotSupportedException - This class will not throw this exception, but subclasses (if any) might.