com.day.cq.search.eval

Class RangePropertyPredicateEvaluator

java.lang.Object

com.day.cq.search.eval.AbstractPredicateEvaluator

com.day.cq.search.eval.RangePropertyPredicateEvaluator

All Implemented Interfaces:

PredicateEvaluator

Direct Known Subclasses:

DateRangePredicateEvaluator

public class RangePropertyPredicateEvaluator
extends AbstractPredicateEvaluator

Matches a JCR property against an interval. This applies to properties with linear types such as LONG, DOUBLE and DECIMAL. For DATE please see the DateRangePredicateEvaluator that has optimized date format input.

You can define a lower bound and an upper bound or only one of them. The operation (eg. "lesser than" or "lesser or equals") can also be specified for lower and upper bound individually.

Does not support facet extraction.

Name:

rangeproperty

Properties:

property

relative path to property

lowerBound

lower bound to check property for

lowerOperation

">" (default) or ">=", applies to the lowerValue

upperBound

upper bound to check property for

upperOperation

"<" (default) or "<=", applies to the lowerValue

decimal

"true" if the checked property is of type Decimal

Since:

5.2

Field Summary

Fields

Modifier and Type	Field and Description
static String	LOWER_BOUND
static String	LOWER_OPERATION
static String	PROPERTY
static String	PROPERTY_DECIMAL
static String	UPPER_BOUND
static String	UPPER_OPERATION

Constructor Summary

Constructors

Constructor and Description
RangePropertyPredicateEvaluator()

Method Summary

Modifier and Type	Method and Description
boolean	canFilter(Predicate p, EvaluationContext context) Returns the same as the deprecated AbstractPredicateEvaluator.isFiltering(Predicate, EvaluationContext) method (ie.
boolean	canXpath(Predicate p, EvaluationContext context) Returns the inverted boolean value of the deprecated AbstractPredicateEvaluator.isFiltering(Predicate, EvaluationContext) method (ie.
String[]	getOrderByProperties(Predicate p, EvaluationContext context) Default implementation that always returns null.
String	getXPathExpression(Predicate p, EvaluationContext context) Default implementation that always returns null, ie.
boolean	includes(Predicate p, Row row, EvaluationContext context) Default implementation that always returns true, ie.

Methods inherited from class com.day.cq.search.eval.AbstractPredicateEvaluator

getFacetExtractor, getOrderByComparator, isFiltering

Methods inherited from class java.lang.Object

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

Field Detail

PROPERTY

public static final String PROPERTY

See Also:

Constant Field Values

LOWER_BOUND

public static final String LOWER_BOUND

See Also:

Constant Field Values

LOWER_OPERATION

public static final String LOWER_OPERATION

See Also:

Constant Field Values

UPPER_BOUND

public static final String UPPER_BOUND

See Also:

Constant Field Values

UPPER_OPERATION

public static final String UPPER_OPERATION

See Also:

Constant Field Values

PROPERTY_DECIMAL

public static final String PROPERTY_DECIMAL

See Also:

Constant Field Values

Constructor Detail

RangePropertyPredicateEvaluator

public RangePropertyPredicateEvaluator()

Method Detail

getXPathExpression

public String getXPathExpression(Predicate p,
                                 EvaluationContext context)

Description copied from class: AbstractPredicateEvaluator

Default implementation that always returns null, ie. adds nothing to the XPath query. Subclasses can choose whether they want to implement this method or use the AbstractPredicateEvaluator.includes(Predicate, Row, EvaluationContext) method for advanced filtering (or both).

Specified by:

getXPathExpression in interface PredicateEvaluator

Overrides:

getXPathExpression in class AbstractPredicateEvaluator

Parameters:

p - predicate (for this evaluator type) which is evaluated

context - helper class which provides access to various elements of the query evaluation

Returns:

string containing an XPath predicateEvaluator expression

getOrderByProperties

public String[] getOrderByProperties(Predicate p,
                                     EvaluationContext context)

Description copied from class: AbstractPredicateEvaluator

Default implementation that always returns null.

Specified by:

getOrderByProperties in interface PredicateEvaluator

Overrides:

getOrderByProperties in class AbstractPredicateEvaluator

Parameters:

p - predicate (for this evaluator type) which is evaluated

context - helper class which provides access to various elements of the query evaluation

Returns:

one or multiple relative paths to JCR properties or null

canXpath

public boolean canXpath(Predicate p,
                        EvaluationContext context)

Description copied from class: AbstractPredicateEvaluator

Returns the inverted boolean value of the deprecated AbstractPredicateEvaluator.isFiltering(Predicate, EvaluationContext) method (ie. if not overridden, true).

Specified by:

canXpath in interface PredicateEvaluator

Overrides:

canXpath in class AbstractPredicateEvaluator

Parameters:

p - predicate (for this evaluator type) which is evaluated

context - helper class which provides access to various elements of the query evaluation

Returns:

true if this evaluator can express itself via xpath, ie. PredicateEvaluator.getXPathExpression(Predicate, EvaluationContext)

canFilter

public boolean canFilter(Predicate p,
                         EvaluationContext context)

Description copied from class: AbstractPredicateEvaluator

Returns the same as the deprecated AbstractPredicateEvaluator.isFiltering(Predicate, EvaluationContext) method (ie. if not overridden, false).

Specified by:

canFilter in interface PredicateEvaluator

Overrides:

canFilter in class AbstractPredicateEvaluator

Parameters:

p - predicate (for this evaluator type) which is evaluated

context - helper class which provides access to various elements of the query evaluation

Returns:

true if this evaluator can be express itself via filtering, ie. PredicateEvaluator.includes(Predicate, Row, EvaluationContext)

includes

public boolean includes(Predicate p,
                        Row row,
                        EvaluationContext context)

Description copied from class: AbstractPredicateEvaluator

Default implementation that always returns true, ie. it does not "touch" the result set at all.

Specified by:

includes in interface PredicateEvaluator

Overrides:

includes in class AbstractPredicateEvaluator

Parameters:

p - predicate (for this evaluator type) which is evaluated

row - current row of the result set returned through the xpath query

context - helper class which provides access to various elements of the query evaluation

Returns:

true if this row should be part of the final result set, false if it should be dropped