public final class Intervals extends Object
IntervalsSource
types
These sources implement minimum-interval algorithms taken from the paper
Efficient Optimally Lazy Algorithms for Minimal-Interval SemanticsModifier and Type | Method and Description |
---|---|
static IntervalsSource |
after(IntervalsSource source,
IntervalsSource reference)
Returns intervals from the source that appear after intervals from the reference
|
static IntervalsSource |
atLeast(int minShouldMatch,
IntervalsSource... sources)
Return intervals that span combinations of intervals from
minShouldMatch of the sources |
static IntervalsSource |
before(IntervalsSource source,
IntervalsSource reference)
Returns intervals from the source that appear before intervals from the reference
|
static IntervalsSource |
containedBy(IntervalsSource small,
IntervalsSource big)
Create a contained-by
IntervalsSource
Returns intervals from the small query that appear within intervals of the big query |
static IntervalsSource |
containing(IntervalsSource big,
IntervalsSource small)
Create a containing
IntervalsSource
Returns intervals from the big source that contain one or more intervals from
the small source |
static IntervalsSource |
extend(IntervalsSource source,
int before,
int after)
Create an
IntervalsSource that wraps another source, extending its
intervals by a number of positions before and after. |
static IntervalsSource |
fixField(String field,
IntervalsSource source)
Create an
IntervalsSource that always returns intervals from a specific field
This is useful for comparing intervals across multiple fields, for example fields that
have been analyzed differently, allowing you to search for stemmed terms near unstemmed
terms, etc. |
static IntervalsSource |
maxgaps(int gaps,
IntervalsSource subSource)
Create an
IntervalsSource that filters a sub-source by its gaps |
static IntervalsSource |
maxwidth(int width,
IntervalsSource subSource)
Create an
IntervalsSource that filters a sub-source by the width of its intervals |
static IntervalsSource |
nonOverlapping(IntervalsSource minuend,
IntervalsSource subtrahend)
Create a non-overlapping IntervalsSource
Returns intervals of the minuend that do not overlap with intervals from the subtrahend
|
static IntervalsSource |
notContainedBy(IntervalsSource small,
IntervalsSource big)
Create a not-contained-by
IntervalsSource
Returns intervals from the small IntervalsSource that do not appear within
intervals from the big IntervalsSource . |
static IntervalsSource |
notContaining(IntervalsSource minuend,
IntervalsSource subtrahend)
Create a not-containing
IntervalsSource
Returns intervals from the minuend that do not contain intervals of the subtrahend |
static IntervalsSource |
notWithin(IntervalsSource minuend,
int positions,
IntervalsSource subtrahend)
Create a not-within
IntervalsSource
Returns intervals of the minuend that do not appear within a set number of positions of
intervals from the subtrahend query |
static IntervalsSource |
or(IntervalsSource... subSources)
Return an
IntervalsSource over the disjunction of a set of sub-sources |
static IntervalsSource |
ordered(IntervalsSource... subSources)
Create an ordered
IntervalsSource
Returns intervals in which the subsources all appear in the given order |
static IntervalsSource |
overlapping(IntervalsSource source,
IntervalsSource reference)
Returns intervals from a source that overlap with intervals from another source
|
static IntervalsSource |
phrase(IntervalsSource... subSources)
Return an
IntervalsSource exposing intervals for a phrase consisting of a list of IntervalsSources |
static IntervalsSource |
phrase(String... terms)
Return an
IntervalsSource exposing intervals for a phrase consisting of a list of terms |
static IntervalsSource |
prefix(String prefix)
Return an
IntervalsSource over the disjunction of all terms that begin with a prefix |
static IntervalsSource |
term(BytesRef term)
Return an
IntervalsSource exposing intervals for a term |
static IntervalsSource |
term(String term)
Return an
IntervalsSource exposing intervals for a term |
static IntervalsSource |
unordered(boolean allowOverlaps,
IntervalsSource... subSources)
Create an unordered
IntervalsSource
Returns intervals in which all the subsources appear. |
static IntervalsSource |
unordered(IntervalsSource... subSources)
Create an unordered
IntervalsSource
Returns intervals in which all the subsources appear. |
static IntervalsSource |
wildcard(String wildcard)
Return an
IntervalsSource over the disjunction of all terms that match a wildcard glob |
static IntervalsSource |
within(IntervalsSource source,
int positions,
IntervalsSource reference)
Returns intervals of the source that appear within a set number of positions of intervals from
the reference
|
public static IntervalsSource term(BytesRef term)
IntervalsSource
exposing intervals for a termpublic static IntervalsSource term(String term)
IntervalsSource
exposing intervals for a termpublic static IntervalsSource phrase(String... terms)
IntervalsSource
exposing intervals for a phrase consisting of a list of termspublic static IntervalsSource phrase(IntervalsSource... subSources)
IntervalsSource
exposing intervals for a phrase consisting of a list of IntervalsSourcespublic static IntervalsSource or(IntervalsSource... subSources)
IntervalsSource
over the disjunction of a set of sub-sourcespublic static IntervalsSource prefix(String prefix)
IntervalsSource
over the disjunction of all terms that begin with a prefixIllegalStateException
- if the prefix expands to more than 128 termspublic static IntervalsSource wildcard(String wildcard)
IntervalsSource
over the disjunction of all terms that match a wildcard globIllegalStateException
- if the wildcard glob expands to more than 128 termsfor glob format
public static IntervalsSource maxwidth(int width, IntervalsSource subSource)
IntervalsSource
that filters a sub-source by the width of its intervalswidth
- the maximum width of intervals in the sub-source to filtersubSource
- the sub-source to filterpublic static IntervalsSource maxgaps(int gaps, IntervalsSource subSource)
IntervalsSource
that filters a sub-source by its gapsgaps
- the maximum number of gaps in the sub-source to filtersubSource
- the sub-source to filterpublic static IntervalsSource extend(IntervalsSource source, int before, int after)
IntervalsSource
that wraps another source, extending its
intervals by a number of positions before and after.
This can be useful for adding defined gaps in a block query; for example,
to find 'a b [2 arbitrary terms] c', you can call:
Intervals.phrase(Intervals.term("a"), Intervals.extend(Intervals.term("b"), 0, 2), Intervals.term("c"));Note that calling
IntervalIterator.gaps()
on iterators returned by this source
delegates directly to the wrapped iterator, and does not include the extensions.source
- the source to extendbefore
- how many positions to extend before the delegated intervalafter
- how many positions to extend after the delegated intervalpublic static IntervalsSource ordered(IntervalsSource... subSources)
IntervalsSource
Returns intervals in which the subsources all appear in the given ordersubSources
- an ordered set of IntervalsSource
objectspublic static IntervalsSource unordered(IntervalsSource... subSources)
IntervalsSource
Returns intervals in which all the subsources appear. The subsources may overlapsubSources
- an unordered set of IntervalsSource
spublic static IntervalsSource unordered(boolean allowOverlaps, IntervalsSource... subSources)
IntervalsSource
Returns intervals in which all the subsources appear.subSources
- an unordered set of IntervalsSource
sallowOverlaps
- whether or not the sources should be allowed to overlap in a hitpublic static IntervalsSource fixField(String field, IntervalsSource source)
IntervalsSource
that always returns intervals from a specific field
This is useful for comparing intervals across multiple fields, for example fields that
have been analyzed differently, allowing you to search for stemmed terms near unstemmed
terms, etc.public static IntervalsSource nonOverlapping(IntervalsSource minuend, IntervalsSource subtrahend)
minuend
- the IntervalsSource
to filtersubtrahend
- the IntervalsSource
to filter bypublic static IntervalsSource overlapping(IntervalsSource source, IntervalsSource reference)
source
- the source to filterreference
- the source to filter bypublic static IntervalsSource notWithin(IntervalsSource minuend, int positions, IntervalsSource subtrahend)
IntervalsSource
Returns intervals of the minuend that do not appear within a set number of positions of
intervals from the subtrahend queryminuend
- the IntervalsSource
to filterpositions
- the minimum distance that intervals from the minuend may occur from intervals
of the subtrahendsubtrahend
- the IntervalsSource
to filter bypublic static IntervalsSource within(IntervalsSource source, int positions, IntervalsSource reference)
source
- the IntervalsSource
to filterpositions
- the maximum distance that intervals of the source may occur from intervals of the referencereference
- the IntervalsSource
to filter bypublic static IntervalsSource notContaining(IntervalsSource minuend, IntervalsSource subtrahend)
IntervalsSource
Returns intervals from the minuend that do not contain intervals of the subtrahendminuend
- the IntervalsSource
to filtersubtrahend
- the IntervalsSource
to filter bypublic static IntervalsSource containing(IntervalsSource big, IntervalsSource small)
IntervalsSource
Returns intervals from the big source that contain one or more intervals from
the small sourcebig
- the IntervalsSource
to filtersmall
- the IntervalsSource
to filter bypublic static IntervalsSource notContainedBy(IntervalsSource small, IntervalsSource big)
IntervalsSource
Returns intervals from the small IntervalsSource
that do not appear within
intervals from the big IntervalsSource
.small
- the IntervalsSource
to filterbig
- the IntervalsSource
to filter bypublic static IntervalsSource containedBy(IntervalsSource small, IntervalsSource big)
IntervalsSource
Returns intervals from the small query that appear within intervals of the big querysmall
- the IntervalsSource
to filterbig
- the IntervalsSource
to filter bypublic static IntervalsSource atLeast(int minShouldMatch, IntervalsSource... sources)
minShouldMatch
of the sourcespublic static IntervalsSource before(IntervalsSource source, IntervalsSource reference)
public static IntervalsSource after(IntervalsSource source, IntervalsSource reference)
Copyright © 2000-2019 Apache Software Foundation. All Rights Reserved.