ilog.views.chart.datax.operator

Class IlvCommutativeAssociativeOperator

java.lang.Object

ilog.views.chart.datax.operator.IlvAbstractOperator

ilog.views.chart.datax.operator.IlvCommutativeAssociativeOperator

All Implemented Interfaces:

IlvOperator

Direct Known Subclasses:

IlvBoundsOperator, IlvMaxOperator, IlvMinOperator

public abstract class IlvCommutativeAssociativeOperator
extends IlvAbstractOperator
implements IlvOperator

This class implements an operator that is commutative, associative, and has a neutral value. It computes the operator result of the values in a model column or, in a tree model, of a branch of a column.

Since:

JViews 7.5

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	IlvCommutativeAssociativeOperator() Creates a new instance of this operator.

Method Summary

Modifier and Type	Method and Description
protected void	attach(IlvModelWithColumns model, IlvDataColumnInfo column) Attaches this operator to a given model and column.
protected void	attach(IlvTreeModelWithColumns model, TreePath branchRootPath, IlvDataColumnInfo column) Attaches this operator to a given tree model branch and column.
protected abstract Object	combine(Object value1, Object value2) Returns the value of the operator, when applied to two operator results.
void	detach() Detaches this operator from its model and thus deactivates it.
protected abstract boolean	equalValues(Object value1, Object value2) Returns true if two values are to be considered the same.
Object	getOperatorValue() Returns the current minimum of the values in the column.
protected abstract Object	identity(Object value) Returns the value of the operator, when applied to a single argument.
protected abstract Object	neutralValue() Returns the value of the operator, when applied to zero arguments.

Methods inherited from class ilog.views.chart.datax.operator.IlvAbstractOperator

addOperatorListener, fireEvent, removeOperatorListener

Methods inherited from class java.lang.Object

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

Methods inherited from interface ilog.views.chart.datax.operator.IlvOperator

addOperatorListener, removeOperatorListener

Constructor Detail

IlvCommutativeAssociativeOperator

protected IlvCommutativeAssociativeOperator()

Creates a new instance of this operator.

Method Detail

neutralValue

protected abstract Object neutralValue()

Returns the value of the operator, when applied to zero arguments.

identity

protected abstract Object identity(Object value)

Returns the value of the operator, when applied to a single argument.

combine

protected abstract Object combine(Object value1,
                                  Object value2)

Returns the value of the operator, when applied to two operator results.

equalValues

protected abstract boolean equalValues(Object value1,
                                       Object value2)

Returns true if two values are to be considered the same.

attach

protected void attach(IlvModelWithColumns model,
                      IlvDataColumnInfo column)

Attaches this operator to a given model and column.

Parameters:

model - The model containing the column values.

column - The column whose values shall be used.

attach

protected void attach(IlvTreeModelWithColumns model,
                      TreePath branchRootPath,
                      IlvDataColumnInfo column)

Attaches this operator to a given tree model branch and column.

Parameters:

model - The model containing the column values.

branchRootPath - The tree path from the root of the model to the root of the branch onto which to limit the scope of the operation. The branch root must stay in the model as long as this operator is attached.

column - The column whose values shall be used.

detach

public void detach()

Detaches this operator from its model and thus deactivates it.

Specified by:

detach in interface IlvOperator

getOperatorValue

public Object getOperatorValue()

Returns the current minimum of the values in the column. Returns null if the column contains no values.

Specified by:

getOperatorValue in interface IlvOperator

Throws:

IllegalStateException - If this operator is not attached to a model.