Package com.inet.report.chart.dataset

Class ForAllRecordsDataset

java.lang.Object

com.inet.report.chart.dataset.AbstractDataset

com.inet.report.chart.dataset.ForAllRecordsDataset

All Implemented Interfaces:

BaseDataset, PieDataset, StandardDataset, Serializable

Direct Known Subclasses:

ForEachRecordDataset, OneGroupDataset

public class ForAllRecordsDataset
extends com.inet.report.chart.dataset.AbstractDataset
implements StandardDataset, PieDataset

This is a dataset used by standard (bar, line, area) and pie charts. This evaluates 'for all records' data for several data fields.

Since:

8.0

See Also:

• Serialized Form

Field Summary

Fields inherited from interface com.inet.report.chart.dataset.BaseDataset

TOKEN_DATASET

Constructor Summary

Constructors

Constructor	Description
ForAllRecordsDataset(Chart2 chart)	Creates a new empty dataset.

Method Summary

Modifier and Type	Method	Description
boolean	addDataField(int summaryOperation, Field field, Field field2nd, int nth)	Adds a data field to the list of fields whose values will be calculated by the summary operation and shown in the chart as bar length for example.
protected Group	getCategoryGroup()	Returns the category group.
Chart2	getChart()	Returns the parent chart of this dataset.
SummaryField	getDataField(int index)	Returns the summary field at the specified position in the list.
SummaryField	getDataField(String name)	Returns the summary field with the specified name or null if the summary field with this name not found in the list.
List	getDataFields()	Returns the data fields of this dataset as list.
int	getDataFieldsCount()	Returns the count of data fields in this dataset.
com.inet.report.chart.dataset.LabelProvider	getLabelProvider()	Returns the LabelProvider responsible for providing the title, footnote, and axis labels
protected String	getName()	FOR INTERNAL USE ONLY Returns the XML attribute name for this dataset.
void	removeAllDataFields()	Removes all data fields from this dataset.
void	removeDataField(int index)	Removes a data field at the specified position in the list.
void	updateReferences()	FOR INTERNAL USE ONLY.
String	verify(ChartStyle style)	Verifies the group and sum properties of current dataset.

Methods inherited from class com.inet.report.chart.dataset.AbstractDataset

getReferencedObject, saveGroups, saveProperties, saveSummaryFields

Methods inherited from class java.lang.Object

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

Methods inherited from interface com.inet.report.chart.dataset.BaseDataset

getReferencedObject

Constructor Details

ForAllRecordsDataset

public ForAllRecordsDataset(Chart2 chart)

Creates a new empty dataset.

Parameters:

chart - the chart (null not permitted)

Since:

8.0

Method Details

getChart

public Chart2 getChart()

Returns the parent chart of this dataset.

Specified by:

getChart in interface BaseDataset

Returns:

the chart.

addDataField

public boolean addDataField(int summaryOperation,
 Field field,
 Field field2nd,
 int nth)

Adds a data field to the list of fields whose values will be calculated by the summary operation and shown in the chart as bar length for example. This will creates a new SummaryField with the given parameters.
For more information about the supported value types of the field and about using parameters 'field2nd' and 'nth' see SummaryField.

Parameters:

summaryOperation - the summary operation

field - the data field

field2nd - the second data field, user for example for weights in weighted average SummaryField.WEIGHTED_AVERAGE.

nth - the nth parameter, used for example by the summary operation SummaryField.NTH_LARGEST

Returns:

true (as per the general contract of Collection.add).

Throws:

IllegalArgumentException - if the required second field or the field are null or have an unsupported value type.

IllegalArgumentException - if parameter nth is less than zero.

Since:

8.0

See Also:

• getDataField(int)
• getDataFieldsCount()
• removeAllDataFields()
• removeDataField(int)
• SummaryField.setSummaryOperation(int)
• SummaryField.setField(Field)
• SummaryField.setField2nd(Field)
• SummaryField.setSummaryNth(int)

getDataField

public SummaryField getDataField(int index)

Returns the summary field at the specified position in the list.

Parameters:

index - index of summary field to return

Returns:

the summary field at the specified position in the list.

Throws:

IndexOutOfBoundsException - if index is out of range.

Since:

8.0

getDataField

public SummaryField getDataField(String name)

Returns the summary field with the specified name or null if the summary field with this name not found in the list. Testing for equality using the case sensitive equals method.

Specified by:

getDataField in interface BaseDataset

Parameters:

name - the searched name of summary field (null not permitted)

Returns:

the summary field with the specified name or null.

See Also:

• BaseDataset.getDataFields()

getDataFields

public List getDataFields()

Returns the data fields of this dataset as list.

Specified by:

getDataFields in interface BaseDataset

Returns:

the list of data fields

See Also:

• BaseDataset.getDataField(String)

removeDataField

public void removeDataField(int index)

Removes a data field at the specified position in the list. Note: this dataset is incomplete without any data fields and cannot be used by chart.

Parameters:

index - the specified position

Throws:

IndexOutOfBoundsException - if index out of range.

Since:

8.0

See Also:

• addDataField(int, Field, Field, int)
• getDataField(int)
• getDataFieldsCount()
• removeAllDataFields()

removeAllDataFields

public void removeAllDataFields()

Removes all data fields from this dataset.

Since:

8.0

See Also:

• addDataField(int, Field, Field, int)
• getDataField(int)
• getDataFieldsCount()
• removeDataField(int)

getDataFieldsCount

public int getDataFieldsCount()

Returns the count of data fields in this dataset.

Returns:

the count

Since:

8.0

See Also:

• addDataField(int, Field, Field, int)
• getDataField(int)
• removeAllDataFields()
• removeDataField(int)

getCategoryGroup

protected Group getCategoryGroup()

Returns the category group. The category group is the first group of chart.

Returns:

the group

Since:

8.0

verify

public String verify(ChartStyle style)

Verifies the group and sum properties of current dataset.

Specified by:

verify in interface BaseDataset

Parameters:

style - the chart style

Returns:

the error message or empty string if all properties are correct.

updateReferences

public void updateReferences()

FOR INTERNAL USE ONLY. Updates the references of this dataset.

Specified by:

updateReferences in interface BaseDataset

getName

protected String getName()

FOR INTERNAL USE ONLY Returns the XML attribute name for this dataset.

Returns:

name of the XML attribute for this dataset

getLabelProvider

public com.inet.report.chart.dataset.LabelProvider getLabelProvider()

Returns the LabelProvider responsible for providing the title, footnote, and axis labels

Specified by:

getLabelProvider in interface BaseDataset

Returns:

the LabelProvider responsible for providing the title, footnote, and axis labels