org.pepstock.charba.client.data

Class Dataset

java.lang.Object

org.pepstock.charba.client.commons.NativeObjectContainer

org.pepstock.charba.client.data.Dataset

All Implemented Interfaces:

HasDataset

Direct Known Subclasses:

HovingFlexDataset, LiningDataset, MeterDataset

public abstract class Dataset
extends NativeObjectContainer
implements HasDataset

The chart allows a number of properties to be specified for each dataset. These are used to set display properties for a specific dataset.
This is the base implementation for all datasets with common fields.

Author:

Andrea "Stock" Stocchero

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
protected static class	Dataset.Property Name of properties of native object.

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	Dataset(Type type, IsDefaultOptions defaultValues) Creates the dataset using a default and chart type related to the dataset, adding patterns and gradients element.

Method Summary

Modifier and Type	Method and Description
protected abstract void	applyGradient(Key key, List<CanvasGradient> canvasGradientsList) Stores the canvas gradients into dataset object by property name passed as key.
protected abstract void	applyPattern(Key key, List<CanvasPattern> canvasPatternsList) Stores the canvas patterns into dataset object by property name passed as key.
BackgroundColorCallback	getBackgroundColorCallback() Returns the background color callback, if set, otherwise null.
BorderColorCallback	getBorderColorCallback() Returns the border color callback, if set, otherwise null.
BorderWidthCallback	getBorderWidthCallback() Returns the border width callback, if set, otherwise null.
List<Double>	getData() Returns the data property of a dataset for a chart is specified as an array of numbers.
List<Double>	getData(boolean binding) Returns the data property of a dataset for a chart is specified as an array of numbers.
Dataset	getDataset() Gets the dataset instance.
DataType	getDataType() Returns the data type of datasets.
protected String	getDefaultBackgroundColorAsString() Returns the default background color value based on type of chart.
protected String	getDefaultBorderColorAsString() Returns the default border color value based on type of chart.
protected int	getDefaultBorderWidth() Returns the default border width value based on type of chart.
protected IsDefaultOptions	getDefaultValues() Returns the default options instance.
int	getId() Returns the unique id of datasets.
String	getLabel() Returns the label for the dataset which appears in the legend and tooltips.
<T extends NativeObjectContainer> T	getOptions(String pluginId, NativeObjectContainerFactory<T> factory) Returns the plugin dataset configuration, if exist.
Type	getType() Returns the type of dataset, based on type of chart.
boolean	hasOptions(String pluginId) Checks if there is any dataset configuration for a specific plugin, by its id.
protected Object	invokeColorCallback(ScriptableContext context, Scriptable<?> callback, Key property, String defaultValue, boolean hasPattern) Returns a color value of property by a callback, checking all different types of object which can be used as value of the property in color ones.
boolean	isHidden() Returns if the dataset will appear or not.
void	setBackgroundColor(BackgroundColorCallback backgroundColorCallback) Sets the background color callback.
void	setBorderColor(BorderColorCallback borderColorCallback) Sets the border color callback.
void	setBorderWidth(BorderWidthCallback borderWidthCallback) Sets the border width callback.
void	setData(double... values) Sets the data property of a dataset for a chart is specified as an array of numbers.
void	setData(List<Double> values) Sets the data property of a dataset for a chart is specified as an array of numbers.
void	setHidden(boolean hidden) Sets if the dataset will appear or not.
void	setLabel(String label) Sets the label for the dataset which appears in the legend and tooltips.
<T extends NativeObjectContainer> void	setOptions(String pluginId, T options) Sets the plugin dataset configuration.

Methods inherited from class org.pepstock.charba.client.commons.NativeObjectContainer

checkValue, getArrayValue, getNativeObject, getValue, getValue, getValue, getValue, getValue, getValue, getValue, getValue, getValue, getValue, getValueOrArray, getValueOrArray, getValueOrArray, getValueOrArray, getValueOrArray, getValueOrArray, getValueOrArray, has, has, keys, remove, remove, removeIfExists, setArrayValue, setArrayValue, setValue, setValue, setValue, setValue, setValue, setValue, setValue, setValue, setValue, setValue, setValue, setValue, setValueOrArray, setValueOrArray, setValueOrArray, setValueOrArray, setValueOrArray, setValueOrArray, setValueOrArray, setValueOrArray, toJSON, type

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

Dataset

protected Dataset(Type type,
                  IsDefaultOptions defaultValues)

Creates the dataset using a default and chart type related to the dataset, adding patterns and gradients element.

Parameters:

type - chart type related to the dataset

defaultValues - default options

Method Detail

getId

public final int getId()

Returns the unique id of datasets.

Returns:

the unique id of datasets

getDataType

public final DataType getDataType()

Returns the data type of datasets.

Returns:

the data type of datasets

getDefaultValues

protected final IsDefaultOptions getDefaultValues()

Returns the default options instance.

Returns:

the default options instance.

getBackgroundColorCallback

public final BackgroundColorCallback getBackgroundColorCallback()

Returns the background color callback, if set, otherwise null.

Returns:

the background color callback, if set, otherwise null.

setBackgroundColor

public final void setBackgroundColor(BackgroundColorCallback backgroundColorCallback)

Sets the background color callback.

Parameters:

backgroundColorCallback - the background color callback.

getBorderColorCallback

public final BorderColorCallback getBorderColorCallback()

Returns the border color callback, if set, otherwise null.

Returns:

the border color callback, if set, otherwise null.

setBorderColor

public final void setBorderColor(BorderColorCallback borderColorCallback)

Sets the border color callback.

Parameters:

borderColorCallback - the border color callback.

getBorderWidthCallback

public final BorderWidthCallback getBorderWidthCallback()

Returns the border width callback, if set, otherwise null.

Returns:

the border width callback, if set, otherwise null.

setBorderWidth

public final void setBorderWidth(BorderWidthCallback borderWidthCallback)

Sets the border width callback.

Parameters:

borderWidthCallback - the border width callback to set

getDefaultBackgroundColorAsString

protected String getDefaultBackgroundColorAsString()

Returns the default background color value based on type of chart.

Returns:

the default background color value based on type of chart.

getDefaultBorderColorAsString

protected String getDefaultBorderColorAsString()

Returns the default border color value based on type of chart.

Returns:

the default border color value based on type of chart.

getDefaultBorderWidth

protected int getDefaultBorderWidth()

Returns the default border width value based on type of chart.

Returns:

the default border width value based on type of chart.

applyPattern

protected abstract void applyPattern(Key key,
                                     List<CanvasPattern> canvasPatternsList)

Stores the canvas patterns into dataset object by property name passed as key.

Parameters:

key - key property name to use to store canvas patterns into dataset object.

canvasPatternsList - list of canvas patterns

applyGradient

protected abstract void applyGradient(Key key,
                                      List<CanvasGradient> canvasGradientsList)

Stores the canvas gradients into dataset object by property name passed as key.

Parameters:

key - key property name to use to store canvas gradients into dataset object.

canvasGradientsList - list of canvas gradients

setHidden

public void setHidden(boolean hidden)

Sets if the dataset will appear or not.

Parameters:

hidden - if the dataset will appear or not.

isHidden

public boolean isHidden()

Returns if the dataset will appear or not.

Returns:

if the dataset will appear or not. Default is false

setLabel

public void setLabel(String label)

Sets the label for the dataset which appears in the legend and tooltips.

Parameters:

label - the label for the dataset which appears in the legend and tooltips.

getLabel

public String getLabel()

Returns the label for the dataset which appears in the legend and tooltips.

Returns:

the label for the dataset which appears in the legend and tooltips.

setData

public void setData(double... values)

Sets the data property of a dataset for a chart is specified as an array of numbers. Each point in the data array corresponds to the label at the same index on the x axis.

Parameters:

values - an array of numbers

setData

public void setData(List<Double> values)

Sets the data property of a dataset for a chart is specified as an array of numbers. Each point in the data array corresponds to the label at the same index on the x axis.

Parameters:

values - list of numbers.

getData

public List<Double> getData()

Returns the data property of a dataset for a chart is specified as an array of numbers. Each point in the data array corresponds to the label at the same index on the x axis.

Returns:

list of numbers or an empty list of numbers if the data type is not DataType.NUMBERS.

getData

public List<Double> getData(boolean binding)

Returns the data property of a dataset for a chart is specified as an array of numbers. Each point in the data array corresponds to the label at the same index on the x axis.

Parameters:

binding - if true binds the new array list into container

Returns:

list of numbers or an empty list of numbers if the data type is not DataType.NUMBERS.

getDataset

public Dataset getDataset()

Description copied from interface: HasDataset

Gets the dataset instance.

Specified by:

getDataset in interface HasDataset

Returns:

the dataset instance

getType

public final Type getType()

Returns the type of dataset, based on type of chart.

Returns:

type of dataset.

setOptions

public final <T extends NativeObjectContainer> void setOptions(String pluginId,
                                                               T options)

Sets the plugin dataset configuration. If dataset configuration options is null, the configuration of plugin will be removed.

Type Parameters:

T - type of native object container to store

Parameters:

pluginId - plugin id.

options - java script object used to configure the plugin. Pass null to remove the configuration if exist.

hasOptions

public final boolean hasOptions(String pluginId)

Checks if there is any dataset configuration for a specific plugin, by its id.

Parameters:

pluginId - plugin id.

Returns:

true if there is an options, otherwise false.

getOptions

public final <T extends NativeObjectContainer> T getOptions(String pluginId,
                                                            NativeObjectContainerFactory<T> factory)

Returns the plugin dataset configuration, if exist. It uses a factory instance to create a native object container.

Type Parameters:

T - type of native object container to return

Parameters:

pluginId - plugin id.

factory - factory instance to create a native object container.

Returns:

java script object used to configure the plugin or null if factory is null.

invokeColorCallback

protected final Object invokeColorCallback(ScriptableContext context,
                                           Scriptable<?> callback,
                                           Key property,
                                           String defaultValue,
                                           boolean hasPattern)

Returns a color value of property by a callback, checking all different types of object which can be used as value of the property in color ones.

Parameters:

context - scriptable context

callback - callback to invoke

property - property of dataset used to store the color

defaultValue - default value to return in case of chart, callback or result of callback are not consistent.

hasPattern - if true is able to manage also Pattern or CanvasPattern, otherwise it skips them.

Returns:

a value of property as color