Class CountDistinctFunction
- java.lang.Object
-
- org.pentaho.reporting.engine.classic.core.function.AbstractExpression
-
- org.pentaho.reporting.engine.classic.core.function.AbstractFunction
-
- org.pentaho.reporting.engine.classic.core.function.CountDistinctFunction
-
- All Implemented Interfaces:
Serializable
,Cloneable
,EventListener
,ReportListener
,AggregationFunction
,Expression
,FieldAggregationFunction
,Function
public class CountDistinctFunction extends AbstractFunction implements FieldAggregationFunction
Counts the distinct occurrences of an certain value of an column. This functionality is similar to the SQL distinct() function.- Author:
- Thomas Morgner
- See Also:
- Serialized Form
-
-
Constructor Summary
Constructors Constructor Description CountDistinctFunction()
DefaultConstructor.
-
Method Summary
All Methods Instance Methods Concrete Methods Modifier and Type Method Description Object
clone()
Clones the expression.String
getCrosstabFilterGroup()
String
getField()
Returns the field used by the function.String
getGroup()
Returns the group name.Expression
getInstance()
Return a completly separated copy of this function.Object
getValue()
Return the number of distint values for the given column.void
groupStarted(ReportEvent event)
Receives notification that a group has started.boolean
isIgnoreNullValues()
void
itemsAdvanced(ReportEvent event)
Receives notification that a row of data is being processed.void
reportInitialized(ReportEvent event)
Receives notification that report generation initializes the current run.void
setCrosstabFilterGroup(String crosstabFilterGroup)
void
setField(String field)
Sets the field name for the function.void
setGroup(String name)
Sets the group name.void
setIgnoreNullValues(boolean ignoreNullValues)
void
summaryRowSelection(ReportEvent event)
A crosstab specific event notifying crosstab-aware functions to select the result for the summary row cell that will be printed next.-
Methods inherited from class org.pentaho.reporting.engine.classic.core.function.AbstractFunction
groupFinished, itemsFinished, itemsStarted, reportDone, reportFinished, reportStarted
-
Methods inherited from class org.pentaho.reporting.engine.classic.core.function.AbstractExpression
getDataRow, getDependencyLevel, getName, getReportConfiguration, getResourceBundleFactory, getRuntime, isActive, isDeepTraversing, isPreserve, setActive, setDependencyLevel, setName, setPreserve, setRuntime
-
Methods inherited from class java.lang.Object
equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
-
Methods inherited from interface org.pentaho.reporting.engine.classic.core.function.Expression
getDataRow, getDependencyLevel, getName, getReportConfiguration, getResourceBundleFactory, getRuntime, isActive, isDeepTraversing, isPreserve, setDependencyLevel, setName, setRuntime
-
Methods inherited from interface org.pentaho.reporting.engine.classic.core.event.ReportListener
groupFinished, itemsFinished, itemsStarted, reportDone, reportFinished, reportStarted
-
-
-
-
Method Detail
-
isIgnoreNullValues
public boolean isIgnoreNullValues()
-
setIgnoreNullValues
public void setIgnoreNullValues(boolean ignoreNullValues)
-
getGroup
public String getGroup()
Returns the group name.- Specified by:
getGroup
in interfaceAggregationFunction
- Returns:
- The group name.
-
setGroup
public void setGroup(String name)
Sets the group name.If a group is defined, the running total is reset to zero at the start of every instance of this group.
- Specified by:
setGroup
in interfaceAggregationFunction
- Parameters:
name
- the group name (null permitted).
-
getField
public String getField()
Returns the field used by the function. The field name corresponds to a column name in the report's data-row.- Specified by:
getField
in interfaceFieldAggregationFunction
- Returns:
- The field name.
-
setField
public void setField(String field)
Sets the field name for the function. The field name corresponds to a column name in the report's data-row.- Specified by:
setField
in interfaceFieldAggregationFunction
- Parameters:
field
- the field name.
-
reportInitialized
public void reportInitialized(ReportEvent event)
Receives notification that report generation initializes the current run.The event carries a ReportState.Started state. Use this to initialize the report.
- Specified by:
reportInitialized
in interfaceReportListener
- Overrides:
reportInitialized
in classAbstractFunction
- Parameters:
event
- The event.
-
groupStarted
public void groupStarted(ReportEvent event)
Receives notification that a group has started.- Specified by:
groupStarted
in interfaceReportListener
- Overrides:
groupStarted
in classAbstractFunction
- Parameters:
event
- the event.
-
itemsAdvanced
public void itemsAdvanced(ReportEvent event)
Receives notification that a row of data is being processed.- Specified by:
itemsAdvanced
in interfaceReportListener
- Overrides:
itemsAdvanced
in classAbstractFunction
- Parameters:
event
- the event.
-
getValue
public Object getValue()
Return the number of distint values for the given column.- Specified by:
getValue
in interfaceExpression
- Returns:
- the value of the function.
-
summaryRowSelection
public void summaryRowSelection(ReportEvent event)
Description copied from class:AbstractFunction
A crosstab specific event notifying crosstab-aware functions to select the result for the summary row cell that will be printed next.- Specified by:
summaryRowSelection
in interfaceReportListener
- Overrides:
summaryRowSelection
in classAbstractFunction
- Parameters:
event
- The report event.
-
getInstance
public Expression getInstance()
Return a completly separated copy of this function. The copy does no longer share any changeable objects with the original function.- Specified by:
getInstance
in interfaceExpression
- Overrides:
getInstance
in classAbstractExpression
- Returns:
- a copy of this function.
-
clone
public Object clone() throws CloneNotSupportedException
Clones the expression. The expression should be reinitialized after the cloning.Expressions maintain no state, cloning is done at the beginning of the report processing to disconnect the expression from any other object space.
- Specified by:
clone
in interfaceExpression
- Overrides:
clone
in classAbstractExpression
- Returns:
- a clone of this expression.
- Throws:
CloneNotSupportedException
- this should never happen.
-
getCrosstabFilterGroup
public String getCrosstabFilterGroup()
- Specified by:
getCrosstabFilterGroup
in interfaceAggregationFunction
-
setCrosstabFilterGroup
public void setCrosstabFilterGroup(String crosstabFilterGroup)
- Specified by:
setCrosstabFilterGroup
in interfaceAggregationFunction
-
-