org.sindice.siren.search.node

Class NodeTermRangeQuery

java.lang.Object

org.apache.lucene.search.Query

org.sindice.siren.search.node.NodeQuery

org.sindice.siren.search.node.NodePrimitiveQuery

org.sindice.siren.search.node.MultiNodeTermQuery

org.sindice.siren.search.node.NodeTermRangeQuery

All Implemented Interfaces:

Cloneable

public class NodeTermRangeQuery
extends MultiNodeTermQuery

A NodePrimitiveQuery that matches documents within an range of terms.

This query matches the documents looking for terms that fall into the supplied range according to Byte.compareTo(Byte). It is not intended for numerical ranges; use NumericRangeQuery instead.

This query uses the MultiNodeTermQuery.CONSTANT_SCORE_AUTO_REWRITE_DEFAULT rewrite method.

Code taken from TermRangeQuery and adapted for SIREn.

Nested Class Summary

Nested classes/interfaces inherited from class org.sindice.siren.search.node.MultiNodeTermQuery

MultiNodeTermQuery.RewriteMethod

Field Summary

Fields inherited from class org.sindice.siren.search.node.MultiNodeTermQuery

CONSTANT_SCORE_AUTO_REWRITE_DEFAULT, CONSTANT_SCORE_BOOLEAN_QUERY_REWRITE, CONSTANT_SCORE_FILTER_REWRITE, field, rewriteMethod, SCORING_BOOLEAN_QUERY_REWRITE

Fields inherited from class org.sindice.siren.search.node.NodePrimitiveQuery

datatype

Fields inherited from class org.sindice.siren.search.node.NodeQuery

ancestor, levelConstraint, lowerBound, upperBound

Constructor Summary

Constructors

Constructor and Description
NodeTermRangeQuery(String field, org.apache.lucene.util.BytesRef lowerTerm, org.apache.lucene.util.BytesRef upperTerm, boolean includeLower, boolean includeUpper) Constructs a query selecting all terms greater/equal than lowerTerm but less/equal than upperTerm.

Method Summary

Methods

Modifier and Type	Method and Description
boolean	equals(Object obj)
org.apache.lucene.util.BytesRef	getLowerTerm() Returns the lower value of this range query
protected org.apache.lucene.index.TermsEnum	getTermsEnum(org.apache.lucene.index.Terms terms, org.apache.lucene.util.AttributeSource atts) Construct the enumeration to be used, expanding the pattern term.
org.apache.lucene.util.BytesRef	getUpperTerm() Returns the upper value of this range query
int	hashCode()
boolean	includesLower() Returns true if the lower endpoint is inclusive
boolean	includesUpper() Returns true if the upper endpoint is inclusive
static NodeTermRangeQuery	newStringRange(String field, String lowerTerm, String upperTerm, boolean includeLower, boolean includeUpper) Factory that creates a new TermRangeQuery using Strings for term text.
String	toString(String field) Prints a user-readable version of this query.

Methods inherited from class org.sindice.siren.search.node.MultiNodeTermQuery

getField, getRewriteMethod, getTermsEnum, rewrite, setRewriteMethod

Methods inherited from class org.sindice.siren.search.node.NodePrimitiveQuery

setDatatype, wrapToStringWithDatatype

Methods inherited from class org.sindice.siren.search.node.NodeQuery

getDocsNodesAndPositionsEnum, getLevelConstraint, getNodeConstraint, setAncestorPointer, setLevelConstraint, setNodeConstraint, setNodeConstraint

Methods inherited from class org.apache.lucene.search.Query

clone, createWeight, extractTerms, getBoost, setBoost, toString

Methods inherited from class java.lang.Object

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

Constructor Detail

NodeTermRangeQuery

public NodeTermRangeQuery(String field,
                  org.apache.lucene.util.BytesRef lowerTerm,
                  org.apache.lucene.util.BytesRef upperTerm,
                  boolean includeLower,
                  boolean includeUpper)

Constructs a query selecting all terms greater/equal than lowerTerm but less/equal than upperTerm.

If an endpoint is null, it is said to be "open". Either or both endpoints may be open. Open endpoints may not be exclusive (you can't select all but the first or last term without explicitly specifying the term to exclude.)

Parameters:

field - The field that holds both lower and upper terms.

lowerTerm - The term text at the lower end of the range

upperTerm - The term text at the upper end of the range

includeLower - If true, the lowerTerm is included in the range.

includeUpper - If true, the upperTerm is included in the range.

Method Detail

newStringRange

public static NodeTermRangeQuery newStringRange(String field,
                                String lowerTerm,
                                String upperTerm,
                                boolean includeLower,
                                boolean includeUpper)

Factory that creates a new TermRangeQuery using Strings for term text.

getLowerTerm

public org.apache.lucene.util.BytesRef getLowerTerm()

Returns the lower value of this range query

getUpperTerm

public org.apache.lucene.util.BytesRef getUpperTerm()

Returns the upper value of this range query

includesLower

public boolean includesLower()

Returns true if the lower endpoint is inclusive

includesUpper

public boolean includesUpper()

Returns true if the upper endpoint is inclusive

getTermsEnum

protected org.apache.lucene.index.TermsEnum getTermsEnum(org.apache.lucene.index.Terms terms,
                                             org.apache.lucene.util.AttributeSource atts)
                                                  throws IOException

Description copied from class: MultiNodeTermQuery

Construct the enumeration to be used, expanding the pattern term. This method should only be called if the field exists (ie, implementations can assume the field does exist). This method should not return null (should instead return TermsEnum.EMPTY if no terms match). The TermsEnum must already be positioned to the first matching term. The given AttributeSource is passed by the MultiNodeTermQuery.RewriteMethod to provide attributes, the rewrite method uses to inform about e.g. maximum competitive boosts. This is currently only used by TopNodeTermsRewrite

Specified by:

getTermsEnum in class MultiNodeTermQuery

Throws:

IOException

toString

public String toString(String field)

Prints a user-readable version of this query.

Specified by:

toString in class org.apache.lucene.search.Query

hashCode

public int hashCode()

Overrides:

hashCode in class MultiNodeTermQuery

equals

public boolean equals(Object obj)

Overrides:

equals in class MultiNodeTermQuery