org.apache.lucene.queries.intervals.package-info Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of lucene-queries Show documentation
Lucene Queries Module
There is a newer version: 10.0.0
/*
 * Licensed to the Apache Software Foundation (ASF) under one or more
 * contributor license agreements.  See the NOTICE file distributed with
 * this work for additional information regarding copyright ownership.
 * The ASF licenses this file to You under the Apache License, Version 2.0
 * (the "License"); you may not use this file except in compliance with
 * the License.  You may obtain a copy of the License at
 *
 *     http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */

/**
 * Intervals queries
 *
 * This package contains experimental classes to search over intervals within fields
 *
 * 
IntervalsSource
 *
 * The {@link org.apache.lucene.queries.intervals.IntervalsSource} class can be used to construct
 * proximity relationships between terms and intervals. They can be built using static methods in
 * the {@link org.apache.lucene.queries.intervals.Intervals} class.
 *
 * Basic intervals
 *
 * 
 *   {@link org.apache.lucene.queries.intervals.Intervals#term(String)} — Represents a
 *       single term.
 *   
{@link org.apache.lucene.queries.intervals.Intervals#phrase(java.lang.String...)} —
 *       Represents a phrase.
 *   
{@link org.apache.lucene.queries.intervals.Intervals#analyzedText(java.lang.String,
 *       org.apache.lucene.analysis.Analyzer, java.lang.String, int, boolean)} — Represents a
 *       phrase (or an unordered sequence) of tokens resulting from an analysis of a given text.
 *   
{@link org.apache.lucene.queries.intervals.Intervals#ordered(IntervalsSource...)} —
 *       Represents an interval over an ordered set of terms or intervals.
 *   
{@link org.apache.lucene.queries.intervals.Intervals#unordered(IntervalsSource...)} —
 *       Represents an interval over an unordered set of terms or intervals.
 *   
{@link org.apache.lucene.queries.intervals.Intervals#or(IntervalsSource...)} —
 *       Represents the disjunction of a set of terms or intervals.
 *   
{@link
 *       org.apache.lucene.queries.intervals.Intervals#wildcard(org.apache.lucene.util.BytesRef)}
 *       — Represents an suffix wildcard (any prefix-matching term from the index).
 * 
 *
 * Filters
 *
 * 
 *   {@link org.apache.lucene.queries.intervals.Intervals#maxwidth(int, IntervalsSource)}
 *       — Filters out intervals that are larger than a set width.
 *   
{@link org.apache.lucene.queries.intervals.Intervals#maxgaps(int, IntervalsSource)} —
 *       Filters out intervals that have more than a set number of gaps between their constituent
 *       sub-intervals.
 *   
{@link org.apache.lucene.queries.intervals.Intervals#containedBy(IntervalsSource,
 *       IntervalsSource)} — Returns intervals that are contained by another interval.
 *   
{@link org.apache.lucene.queries.intervals.Intervals#notContainedBy(IntervalsSource,
 *       IntervalsSource)} — Returns intervals that are *not* contained by another interval.
 *   
{@link org.apache.lucene.queries.intervals.Intervals#containing(IntervalsSource,
 *       IntervalsSource)} — Returns intervals that contain another interval.
 *   
{@link org.apache.lucene.queries.intervals.Intervals#notContaining(IntervalsSource,
 *       IntervalsSource)} — Returns intervals that do not contain another interval.
 *   
{@link org.apache.lucene.queries.intervals.Intervals#nonOverlapping(IntervalsSource,
 *       IntervalsSource)} — Returns intervals that do not overlap with another interval.
 *   
{@link org.apache.lucene.queries.intervals.Intervals#notWithin(IntervalsSource, int,
 *       IntervalsSource)} — Returns intervals that do not appear within a set number of
 *       positions of another interval.
 * 
 *
 * The {@link org.apache.lucene.queries.intervals.Intervals} class contains more advanced filters,
 * please refer to the documentation of that class.
 *
 * IntervalQuery
 *
 * An {@link org.apache.lucene.queries.intervals.IntervalQuery} takes a field name and an {@link
 * org.apache.lucene.queries.intervals.IntervalsSource}, and matches all documents that contain
 * intervals defined by the source in that field.
 *
 * Interval query support in query parsers
 *
 * Lucene's {@code StandardQueryParser} (from the {@code queryparser} module) supports interval
 * function expressions.
 */
package org.apache.lucene.queries.intervals;