borland Packages  Class Hierarchy  jbcl.dataset Package  Index 

AggOperator class (abstract)

java.lang.Object
   +----borland.jbcl.dataset.AggOperator
           +----borland.jbcl.dataset.SumAggOperator
           +----borland.jbcl.dataset.BoundsAggOperator
           +----borland.jbcl.dataset.CustomAggOperator
           +----borland.jbcl.dataset.CountAggOperator

About the AggOperator class

Variables  Properties  Methods  

Implements Serializable, Cloneable

The AggOperator class is an abstract class that defines basic aggregator behavior of a calculated value or a calculated Column. All aggregation operators must extend from this class, therefore, you should extend this class when creating custom AggOperator classes. The following aggregator operators are provided and can be specified as the aggOperator of the AggDescriptor object:

For examples of applications that use aggregators, see the following projects in the specified directories of your JBuilder installation:


AggOperator variables

Variables implemented in this class

AggOperator properties

*Read-only properties **Write-only properties

Properties implemented in java.lang.Object

AggOperator methods

Methods implemented in this class

Methods implemented in java.lang.Object


AggOperator variables

aggColumn

  protected transient Column aggColumn
The Column in the DataSet that is being aggregated on.

aggDataSet

  protected transient DataSet aggDataSet
The internal StorageDataSet that contains and maintains aggregated values.

aggValue

  protected transient Variant aggValue
This variable is used internally by other classes in the JBCL. You should never use this variable directly.

dataSet

  protected transient StorageDataSet dataSet
The StorageDataSet that contains the Column ("aggColumn") that is being aggregated on.

resultColumn

  protected transient Column resultColumn
The Column in aggDataSet that contains the aggregated value.

resultValue

  protected transient Variant resultValue
This variable is used internally by other classes in the JBCL. You should never use this variable directly.

AggOperator methods

add(borland.jbcl.dataset.ReadRow, long, boolean)

  public abstract void add(borland.jbcl.dataset.ReadRow row, long internalRow, boolean first)
A row has been added or updated.
row
The row containing the values.
internalRow
The unique identifier for the row.
first
Returns true if this is the first row in the group, false otherwise.

clone()

  public Object clone()

Overrides: java.lang.Object.clone()

delete(borland.jbcl.dataset.ReadRow, long)

  public abstract void delete(borland.jbcl.dataset.ReadRow row, long internalRow)
A row has been deleted or updated. The DataRow parameter contains the values and internalRow is a unique identifier for the row.

init(borland.jbcl.dataset.StorageDataSet, java.lang.String[], borland.jbcl.dataset.StorageDataSet, borland.jbcl.dataset.Column, borland.jbcl.dataset.Column)

  public void init(borland.jbcl.dataset.StorageDataSet dataSet, java.lang.String[] groupColumnNames, borland.jbcl.dataset.StorageDataSet aggDataSet, borland.jbcl.dataset.Column resultColumn, borland.jbcl.dataset.Column aggColumn)
Called when the AggOperator is being initialized. If overridden by an extended class, super.init() should still be called to ensure proper initialization. Note that this method is called before the aggDataSet is opened. This allows an AggOperator extension to add a column to the aggDataSet. This can be useful for some types of maintained aggregations like average that would need to accumulate count and total.
dataSet
The StorageDataSet that contains the aggColumn that is being aggregated on
groupColumnNames
A array of the Column names to perform grouping by.
aggDataSet
The internal StorageDataSet that contains and maintains aggregated values.
resultColumn
The Column in aggDataSet that contains the aggregated value.
aggColumn
The Column in the DataSet that is being aggregated on.

locate(borland.jbcl.dataset.ReadRow)

  public boolean locate(borland.jbcl.dataset.ReadRow row)

needsAggDataSet()

  public boolean needsAggDataSet()

open(borland.jbcl.dataset.DataSet)

  public void open(borland.jbcl.dataset.DataSet aggDataSet)
Called when the aggDataSet is opened and prepared for usage.