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

java.lang.Object
  extended by org.apache.lucene.search.Filter
      extended by org.apache.lucene.search.MultiTermQueryWrapperFilter<NumericRangeQuery<T>>
          extended by 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.



Copyright © 2000-2011 Apache Software Foundation. All Rights Reserved.