org.apache.lucene.search
Class NumericRangeFilter<T extends Number>

java.lang.Object
  org.apache.lucene.search.Filter
      org.apache.lucene.search.MultiTermQueryWrapperFilter<NumericRangeQuery<T>>
          org.apache.lucene.search.NumericRangeFilter<T>

All Implemented Interfaces:

Serializable

public final class NumericRangeFilter<T extends Number>
extends MultiTermQueryWrapperFilter<NumericRangeQuery<T>>

A Filter that only accepts numeric values within a specified range. To use this, you must first index the numeric values using NumericField (expert: NumericTokenStream).

You create a new NumericRangeFilter with the static factory methods, eg:

 Filter f = NumericRangeFilter.newFloatRange("weight", 0.03f, 0.10f, true, true);
 

accepts all documents whose float valued "weight" field ranges from 0.03 to 0.10, inclusive. See NumericRangeQuery for details on how Lucene indexes and searches numeric valued fields.

Since:

2.9

See Also:

Serialized Form

Field Summary

Fields inherited from class org.apache.lucene.search.MultiTermQueryWrapperFilter

query

Method Summary

String	getField() Returns the field name for this filter
T	getMax() Returns the upper value of this range filter
T	getMin() Returns the lower value of this range filter
int	getPrecisionStep() Returns the precision step.
boolean	includesMax() Returns true if the upper endpoint is inclusive
boolean	includesMin() Returns true if the lower endpoint is inclusive
static NumericRangeFilter<Double>	newDoubleRange(String field, Double min, Double max, boolean minInclusive, boolean maxInclusive) Factory that creates a NumericRangeFilter, that queries a double range using the default precisionStep NumericUtils.PRECISION_STEP_DEFAULT (4).
static NumericRangeFilter<Double>	newDoubleRange(String field, int precisionStep, Double min, Double max, boolean minInclusive, boolean maxInclusive) Factory that creates a NumericRangeFilter, that filters a double range using the given precisionStep.
static NumericRangeFilter<Float>	newFloatRange(String field, Float min, Float max, boolean minInclusive, boolean maxInclusive) Factory that creates a NumericRangeFilter, that queries a float range using the default precisionStep NumericUtils.PRECISION_STEP_DEFAULT (4).
static NumericRangeFilter<Float>	newFloatRange(String field, int precisionStep, Float min, Float max, boolean minInclusive, boolean maxInclusive) Factory that creates a NumericRangeFilter, that filters a float range using the given precisionStep.
static NumericRangeFilter<Integer>	newIntRange(String field, Integer min, Integer max, boolean minInclusive, boolean maxInclusive) Factory that creates a NumericRangeFilter, that queries a int range using the default precisionStep NumericUtils.PRECISION_STEP_DEFAULT (4).
static NumericRangeFilter<Integer>	newIntRange(String field, int precisionStep, Integer min, Integer max, boolean minInclusive, boolean maxInclusive) Factory that creates a NumericRangeFilter, that filters a int range using the given precisionStep.
static NumericRangeFilter<Long>	newLongRange(String field, int precisionStep, Long min, Long max, boolean minInclusive, boolean maxInclusive) Factory that creates a NumericRangeFilter, that filters a long range using the given precisionStep.
static NumericRangeFilter<Long>	newLongRange(String field, Long min, Long max, boolean minInclusive, boolean maxInclusive) Factory that creates a NumericRangeFilter, that queries a long range using the default precisionStep NumericUtils.PRECISION_STEP_DEFAULT (4).

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

clearTotalNumberOfTerms, equals, getDocIdSet, getTotalNumberOfTerms, hashCode, toString

Methods inherited from class java.lang.Object

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

Method Detail

newLongRange

public static NumericRangeFilter<Long> newLongRange(String field,
                                                    int precisionStep,
                                                    Long min,
                                                    Long max,
                                                    boolean minInclusive,
                                                    boolean maxInclusive)

Factory that creates a NumericRangeFilter, that filters a long range using the given precisionStep. You can have half-open ranges (which are in fact </≤ or >/≥ queries) by setting the min or max value to null. By setting inclusive to false, it will match all documents excluding the bounds, with inclusive on, the boundaries are hits, too.

newLongRange

public static NumericRangeFilter<Long> newLongRange(String field,
                                                    Long min,
                                                    Long max,
                                                    boolean minInclusive,
                                                    boolean maxInclusive)

Factory that creates a NumericRangeFilter, that queries a long range using the default precisionStep NumericUtils.PRECISION_STEP_DEFAULT (4). You can have half-open ranges (which are in fact </≤ or >/≥ queries) by setting the min or max value to null. By setting inclusive to false, it will match all documents excluding the bounds, with inclusive on, the boundaries are hits, too.

newIntRange

public static NumericRangeFilter<Integer> newIntRange(String field,
                                                      int precisionStep,
                                                      Integer min,
                                                      Integer max,
                                                      boolean minInclusive,
                                                      boolean maxInclusive)

Factory that creates a NumericRangeFilter, that filters a int range using the given precisionStep. You can have half-open ranges (which are in fact </≤ or >/≥ queries) by setting the min or max value to null. By setting inclusive to false, it will match all documents excluding the bounds, with inclusive on, the boundaries are hits, too.

newIntRange

public static NumericRangeFilter<Integer> newIntRange(String field,
                                                      Integer min,
                                                      Integer max,
                                                      boolean minInclusive,
                                                      boolean maxInclusive)

Factory that creates a NumericRangeFilter, that queries a int range using the default precisionStep NumericUtils.PRECISION_STEP_DEFAULT (4). You can have half-open ranges (which are in fact </≤ or >/≥ queries) by setting the min or max value to null. By setting inclusive to false, it will match all documents excluding the bounds, with inclusive on, the boundaries are hits, too.

newDoubleRange

public static NumericRangeFilter<Double> newDoubleRange(String field,
                                                        int precisionStep,
                                                        Double min,
                                                        Double max,
                                                        boolean minInclusive,
                                                        boolean maxInclusive)

Factory that creates a NumericRangeFilter, that filters a double range using the given precisionStep. You can have half-open ranges (which are in fact </≤ or >/≥ queries) by setting the min or max value to null. By setting inclusive to false, it will match all documents excluding the bounds, with inclusive on, the boundaries are hits, too.

newDoubleRange

public static NumericRangeFilter<Double> newDoubleRange(String field,
                                                        Double min,
                                                        Double max,
                                                        boolean minInclusive,
                                                        boolean maxInclusive)

Factory that creates a NumericRangeFilter, that queries a double range using the default precisionStep NumericUtils.PRECISION_STEP_DEFAULT (4). You can have half-open ranges (which are in fact </≤ or >/≥ queries) by setting the min or max value to null. By setting inclusive to false, it will match all documents excluding the bounds, with inclusive on, the boundaries are hits, too.

newFloatRange

public static NumericRangeFilter<Float> newFloatRange(String field,
                                                      int precisionStep,
                                                      Float min,
                                                      Float max,
                                                      boolean minInclusive,
                                                      boolean maxInclusive)

Factory that creates a NumericRangeFilter, that filters a float range using the given precisionStep. You can have half-open ranges (which are in fact </≤ or >/≥ queries) by setting the min or max value to null. By setting inclusive to false, it will match all documents excluding the bounds, with inclusive on, the boundaries are hits, too.

newFloatRange

public static NumericRangeFilter<Float> newFloatRange(String field,
                                                      Float min,
                                                      Float max,
                                                      boolean minInclusive,
                                                      boolean maxInclusive)

Factory that creates a NumericRangeFilter, that queries a float range using the default precisionStep NumericUtils.PRECISION_STEP_DEFAULT (4). You can have half-open ranges (which are in fact </≤ or >/≥ queries) by setting the min or max value to null. By setting inclusive to false, it will match all documents excluding the bounds, with inclusive on, the boundaries are hits, too.

getField

public String getField()

Returns the field name for this filter

includesMin

public boolean includesMin()

Returns true if the lower endpoint is inclusive

includesMax

public boolean includesMax()

Returns true if the upper endpoint is inclusive

getMin

public T getMin()

Returns the lower value of this range filter

getMax

public T getMax()

Returns the upper value of this range filter

getPrecisionStep

public int getPrecisionStep()

Returns the precision step.