## org.jfree.chart.labels
Class StandardXYSeriesLabelGenerator

    java.lang.Object
      org.jfree.chart.labels.StandardXYSeriesLabelGenerator

All Implemented Interfaces:
  java.io.Serializable, java.lang.Cloneable, XYSeriesLabelGenerator, org.jfree.util.PublicCloneable

    public class StandardXYSeriesLabelGenerator

extends java.lang.Object
implements XYSeriesLabelGenerator, java.lang.Cloneable, org.jfree.util.PublicCloneable, java.io.Serializable

A standard series label generator for plots that use data from an `XYDataset`.
This class implements `PublicCloneable` by mistake but we retain this for the sake of backward compatibility.

See Also:
  Serialized Form

Field Summary
`static java.lang.String` `DEFAULT_LABEL_FORMAT` The default item label format.

Constructor Summary
`StandardXYSeriesLabelGenerator()` Creates a default series label generator (uses `DEFAULT_LABEL_FORMAT`).
`StandardXYSeriesLabelGenerator(java.lang.String format)` Creates a new series label generator.

Method Summary
`java.lang.Object` `clone()` Returns an independent copy of the generator.
`protected java.lang.Object[]` `createItemArray(XYDataset dataset, int series)` Creates the array of items that can be passed to the `MessageFormat` class for creating labels.
`boolean` `equals(java.lang.Object obj)` Tests this object for equality with an arbitrary object.
`java.lang.String` `generateLabel(XYDataset dataset, int series)` Generates a label for the specified series.

Methods inherited from class java.lang.Object
`finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait`

Field Detail

### DEFAULT_LABEL_FORMAT

    public static final java.lang.String DEFAULT_LABEL_FORMAT

  The default item label format.

  See Also:
    Constant Field Values

Constructor Detail

### StandardXYSeriesLabelGenerator

    public StandardXYSeriesLabelGenerator()

  Creates a default series label generator (uses `DEFAULT_LABEL_FORMAT`).

### StandardXYSeriesLabelGenerator

    public StandardXYSeriesLabelGenerator(java.lang.String format)

  Creates a new series label generator.

  Parameters:
    `format` - the format pattern (`null` not permitted).

Method Detail

### generateLabel

    public java.lang.String generateLabel(XYDataset dataset,
                                          int series)

  Generates a label for the specified series. This label will be used for the chart legend.

  Specified by:
    `generateLabel` in interface `XYSeriesLabelGenerator`
  Parameters:
    `dataset` - the dataset (`null` not permitted).
    `series` - the series.
  Returns:
    A series label.

### createItemArray

    protected java.lang.Object[] createItemArray(XYDataset dataset,
                                                 int series)

  Creates the array of items that can be passed to the `MessageFormat` class for creating labels.

  Parameters:
    `dataset` - the dataset (`null` not permitted).
    `series` - the series (zero-based index).
  Returns:
    The items (never `null`).

### clone

    public java.lang.Object clone()
                           throws java.lang.CloneNotSupportedException

  Returns an independent copy of the generator. This is unnecessary, because instances are immutable anyway, but we retain this behaviour for backwards compatibility.

  Specified by:
    `clone` in interface `org.jfree.util.PublicCloneable`
  Overrides:
    `clone` in class `java.lang.Object`
  Returns:
    A clone.
  Throws:
    `java.lang.CloneNotSupportedException` - if cloning is not supported.

### equals

    public boolean equals(java.lang.Object obj)

  Tests this object for equality with an arbitrary object.

  Overrides:
    `equals` in class `java.lang.Object`
  Parameters:
    `obj` - the other object (`null` permitted).
  Returns:
    A boolean.