org.jfree.report.function
Class GroupCountFunction

java.lang.Object
  |
  +--org.jfree.report.function.AbstractExpression
        |
        +--org.jfree.report.function.AbstractFunction
              |
              +--org.jfree.report.function.GroupCountFunction

Direct Known Subclasses:

TotalGroupCountFunction

public class GroupCountFunction

extends AbstractFunction

implements java.io.Serializable

A report function that counts groups in a report. If a null-groupname is given, all groups are counted.

The group to be counted can be defined using the property "group". An optional container group can be defined using the property "parent-group". When the group start event of that group is encountered, the counter will be reset to '0'.

If the group property is not set, all group starts get counted.

Author:

David Gilbert

See Also:

Serialized Form

Constructor Summary

GroupCountFunction()
Default constructor.

GroupCountFunction(java.lang.String name, java.lang.String group)
Constructs a report function for counting groups.

Method Summary

protected int	getCount() Returns the current group count value.
java.lang.String	getGroup() Returns the name of the group to be counted.
java.lang.String	getParentGroup() Returns the name of the group on which to reset the counter.
java.lang.Object	getValue() Returns the number of groups processed so far (including the current group).
void	groupStarted(ReportEvent event) Receives notification that a new group is about to start.
void	reportInitialized(ReportEvent event) Receives notification that a new report is about to start.
protected void	setCount(int count) Defines the current group count value.
void	setGroup(java.lang.String group) defines the name of the group to be counted.
void	setParentGroup(java.lang.String group) defines the name of the group on which to reset the counter.

Methods inherited from class org.jfree.report.function.AbstractFunction

clone, groupFinished, itemsAdvanced, itemsFinished, itemsStarted, reportDone, reportFinished, reportStarted

Methods inherited from class org.jfree.report.function.AbstractExpression

getDataRow, getDependencyLevel, getInstance, getName, getReportConfiguration, getResourceBundleFactory, getRuntime, isActive, setActive, setDependencyLevel, setName, setRuntime

Methods inherited from class java.lang.Object

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

Constructor Detail

GroupCountFunction

public GroupCountFunction()

Default constructor.

GroupCountFunction

public GroupCountFunction(java.lang.String name,
                          java.lang.String group)

Constructs a report function for counting groups.

Parameters:

name - The function name.

group - The group name.

Throws:

java.lang.NullPointerException - if the given name is null

Method Detail

getParentGroup

public java.lang.String getParentGroup()

Returns the name of the group on which to reset the counter.

Returns:

the name of the group or null, if all groups are counted

setParentGroup

public void setParentGroup(java.lang.String group)

defines the name of the group on which to reset the counter. If the name is null, all groups are counted.

Parameters:

group - the name of the group to be counted.

getGroup

public java.lang.String getGroup()

Returns the name of the group to be counted.

Returns:

the name of the group or null, if all groups are counted

setGroup

public void setGroup(java.lang.String group)

defines the name of the group to be counted. If the name is null, all groups are counted.

Parameters:

group - the name of the group to be counted.

reportInitialized

public void reportInitialized(ReportEvent event)

Receives notification that a new report is about to start. Resets the count.

Overrides:

reportInitialized in class AbstractFunction

Parameters:

event - the current report event received.

groupStarted

public void groupStarted(ReportEvent event)

Receives notification that a new group is about to start. Increases the count if all groups are counted or the name defines the current group.

Overrides:

groupStarted in class AbstractFunction

Parameters:

event - the current report event received.

getCount

protected int getCount()

Returns the current group count value.

Returns:

the curernt group count.

setCount

protected void setCount(int count)

Defines the current group count value.

Parameters:

count - the curernt group count.

getValue

public java.lang.Object getValue()

Returns the number of groups processed so far (including the current group).

Returns:

the number of groups processed as java.lang.Integer.