Class ItemMinFunction
- 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.ItemMinFunction
-
- All Implemented Interfaces:
Serializable
,Cloneable
,EventListener
,ReportListener
,AggregationFunction
,Expression
,FieldAggregationFunction
,Function
public class ItemMinFunction extends AbstractFunction implements FieldAggregationFunction
A report function that calculates the minimum value of one field (column) from the data-row. The function can be used in two ways:- to calculate a minimum value for the entire report;
- to calculate a minimum value within a particular group;
field
parameter is required and denotes the name of an ItemBand-field which gets summed up. The parametergroup
denotes the name of a group. When this group is started, the counter gets reseted to null.- Author:
- Thomas Morgner
- See Also:
- Serialized Form
-
-
Constructor Summary
Constructors Constructor Description ItemMinFunction()
Constructs an unnamed function.ItemMinFunction(String name)
Constructs a named function.
-
Method Summary
All Methods Instance Methods Concrete Methods Modifier and Type Method Description protected void
clear()
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()
Returns the function value, in this case the running total of a specific column in the report's data row.void
groupStarted(ReportEvent event)
Receives notification that a new group is about to start.void
itemsAdvanced(ReportEvent event)
Receives notification that a row of data is being processed.void
reportInitialized(ReportEvent event)
Receives notification that a new report is about to start.void
setCrosstabFilterGroup(String crosstabFilterGroup)
void
setField(String field)
Sets the field name for the function.void
setGroup(String name)
Sets the group name.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
-
-
-
-
Constructor Detail
-
ItemMinFunction
public ItemMinFunction()
Constructs an unnamed function. Make sure to set a Name or function initialisation will fail.
-
ItemMinFunction
public ItemMinFunction(String name)
Constructs a named function.The field must be defined before using the function.
- Parameters:
name
- The function name.
-
-
Method Detail
-
reportInitialized
public void reportInitialized(ReportEvent event)
Receives notification that a new report is about to start.Does nothing.
- Specified by:
reportInitialized
in interfaceReportListener
- Overrides:
reportInitialized
in classAbstractFunction
- Parameters:
event
- Information about the event.
-
clear
protected void clear()
-
groupStarted
public void groupStarted(ReportEvent event)
Receives notification that a new group is about to start. If this is the group defined for the function, then the minimum value is reset to zero.- Specified by:
groupStarted
in interfaceReportListener
- Overrides:
groupStarted
in classAbstractFunction
- Parameters:
event
- Information about the event.
-
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 minimum value 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.
-
itemsAdvanced
public void itemsAdvanced(ReportEvent event)
Receives notification that a row of data is being processed. Reads the data from the field defined for this function and calculates the minimum value.- Specified by:
itemsAdvanced
in interfaceReportListener
- Overrides:
itemsAdvanced
in classAbstractFunction
- Parameters:
event
- Information about the event.
-
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.
-
getValue
public Object getValue()
Returns the function value, in this case the running total of a specific column in the report's data row.- Specified by:
getValue
in interfaceExpression
- Returns:
- The function value.
-
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()
Description copied from class:AbstractExpression
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.
-
getCrosstabFilterGroup
public String getCrosstabFilterGroup()
- Specified by:
getCrosstabFilterGroup
in interfaceAggregationFunction
-
setCrosstabFilterGroup
public void setCrosstabFilterGroup(String crosstabFilterGroup)
- Specified by:
setCrosstabFilterGroup
in interfaceAggregationFunction
-
-