mondrian.rolap.agg

Class MinusStarPredicate

java.lang.Object

mondrian.rolap.agg.AbstractColumnPredicate

mondrian.rolap.agg.MinusStarPredicate

All Implemented Interfaces:

StarColumnPredicate, StarPredicate

public class MinusStarPredicate
extends AbstractColumnPredicate

A StarPredicate which evaluates to true if its first child evaluates to true and its second child evaluates to false.

Since:

Nov 6, 2006

Author:

jhyde

Nested Class Summary

Nested classes/interfaces inherited from class mondrian.rolap.agg.AbstractColumnPredicate

AbstractColumnPredicate.Factory

Nested classes/interfaces inherited from interface mondrian.rolap.StarColumnPredicate

StarColumnPredicate.Overlap

Field Summary

Fields inherited from class mondrian.rolap.agg.AbstractColumnPredicate

constrainedColumn

Fields inherited from interface mondrian.rolap.StarPredicate

WILDCARD

Constructor Summary

Constructors

Constructor and Description
MinusStarPredicate(StarColumnPredicate plus, StarColumnPredicate minus) Creates a MinusStarPredicate.

Method Summary

Modifier and Type	Method and Description
StarColumnPredicate	cloneWithColumn(RolapStar.Column column) This method is required because unfortunately some ColumnPredicate objects are created without a column.
void	describe(StringBuilder buf) Appends a description of this predicate to a StringBuilder.
boolean	equals(Object obj)
boolean	evaluate(Object value) Returns whether this constraint would return true for a given value.
RolapStar.Column	getConstrainedColumn() Returns the column constrained by this predicate.
int	hashCode()
StarColumnPredicate.Overlap	intersect(StarColumnPredicate predicate) Applies this predicate to a predicate from the axis of a segment, and tests for overlap.
boolean	mightIntersect(StarPredicate other) Returns whether this predicate might intersect another predicate.
StarColumnPredicate	minus(StarPredicate predicate) Returns the logical inverse of this Predicate.
void	values(Collection<Object> collection) Adds the values in this constraint to a collection.

Methods inherited from class mondrian.rolap.agg.AbstractColumnPredicate

and, cloneListWithColumn, equalConstraint, evaluate, getConstrainedColumnBitKey, getConstrainedColumnList, or, orColumn, toSql, toString

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Constructor Detail

MinusStarPredicate

public MinusStarPredicate(StarColumnPredicate plus,
                          StarColumnPredicate minus)

Creates a MinusStarPredicate.

Parameters:

plus - Positive predicate

minus - Negative predicate

Pre-condition:

plus != null, minus != null

Method Detail

equals

public boolean equals(Object obj)

Overrides:

equals in class Object

hashCode

public int hashCode()

Overrides:

hashCode in class Object

getConstrainedColumn

public RolapStar.Column getConstrainedColumn()

Description copied from interface: StarColumnPredicate

Returns the column constrained by this predicate.

Specified by:

getConstrainedColumn in interface StarColumnPredicate

Overrides:

getConstrainedColumn in class AbstractColumnPredicate

Returns:

Column constrained by this predicate.

values

public void values(Collection<Object> collection)

Description copied from interface: StarColumnPredicate

Adds the values in this constraint to a collection.

Parameters:

collection - Collection to add values to

evaluate

public boolean evaluate(Object value)

Description copied from interface: StarColumnPredicate

Returns whether this constraint would return true for a given value.

Parameters:

value - Value

Returns:

Whether predicate is true

describe

public void describe(StringBuilder buf)

Description copied from interface: StarPredicate

Appends a description of this predicate to a StringBuilder. For example:

• =any
• =5
• in (2, 4, 6)

Parameters:

buf - Builder to append to

intersect

public StarColumnPredicate.Overlap intersect(StarColumnPredicate predicate)

Description copied from interface: StarColumnPredicate

Applies this predicate to a predicate from the axis of a segment, and tests for overlap. The result might be that there is no overlap, full overlap (so the constraint can be removed), or partial overlap (so the constraint will need to be replaced with a stronger constraint, say 'x > 10' is replaced with 'x > 20').

Parameters:

predicate - Predicate

Returns:

description of overlap between predicates, if any

mightIntersect

public boolean mightIntersect(StarPredicate other)

Description copied from interface: StarColumnPredicate

Returns whether this predicate might intersect another predicate. That is, whether there might be a value which holds true for both constraints.

Parameters:

other - Other constraint

Returns:

Whether constraints intersect

minus

public StarColumnPredicate minus(StarPredicate predicate)

Description copied from interface: StarPredicate

Returns the logical inverse of this Predicate. The result is a Predicate which holds whenever this predicate holds but the other does not.

Parameters:

predicate - Predicate

Returns:

Combined predicate

cloneWithColumn

public StarColumnPredicate cloneWithColumn(RolapStar.Column column)

Description copied from interface: StarColumnPredicate

This method is required because unfortunately some ColumnPredicate objects are created without a column.

We call this method to provide a fake column, then call StarPredicate.toSql(mondrian.rolap.sql.SqlQuery, StringBuilder).

todo: remove this method when bug MONDRIAN-313 and bug MONDRIAN-314 are fixed.