Module org.elasticsearch.server

Package org.elasticsearch.index.query

Class FuzzyQueryBuilder

java.lang.Object

org.elasticsearch.index.query.AbstractQueryBuilder<FuzzyQueryBuilder>

org.elasticsearch.index.query.FuzzyQueryBuilder

All Implemented Interfaces:

NamedWriteable, VersionedNamedWriteable, Writeable, MultiTermQueryBuilder, QueryBuilder, Rewriteable<QueryBuilder>, ToXContent, ToXContentObject

public class FuzzyQueryBuilder
extends AbstractQueryBuilder<FuzzyQueryBuilder>
implements MultiTermQueryBuilder

A Query that does fuzzy matching for a specific value.

Nested Class Summary

Nested classes/interfaces inherited from interface org.elasticsearch.xcontent.ToXContent

ToXContent.DelegatingMapParams, ToXContent.MapParams, ToXContent.Params

Nested classes/interfaces inherited from interface org.elasticsearch.common.io.stream.Writeable

Writeable.Reader<V>, Writeable.Writer<V>

Field Summary

Fields

Modifier and Type	Field	Description
static final Fuzziness	DEFAULT_FUZZINESS	Default maximum edit distance.
static final int	DEFAULT_MAX_EXPANSIONS	Default maximum number of terms that the fuzzy query will expand to.
static final int	DEFAULT_PREFIX_LENGTH	Default number of initial characters which will not be “fuzzified”.
static final boolean	DEFAULT_TRANSPOSITIONS	Default as to whether transpositions should be treated as a primitive edit operation, instead of classic Levenshtein algorithm.
static final String	NAME

Fields inherited from class org.elasticsearch.index.query.AbstractQueryBuilder

boost, BOOST_FIELD, DEFAULT_BOOST, NAME_FIELD, queryName

Fields inherited from interface org.elasticsearch.index.query.Rewriteable

MAX_REWRITE_ROUNDS

Fields inherited from interface org.elasticsearch.xcontent.ToXContent

EMPTY_PARAMS

Constructor Summary

Constructors

Constructor	Description
FuzzyQueryBuilder(String fieldName, boolean value)	Constructs a new fuzzy query.
FuzzyQueryBuilder(String fieldName, double value)	Constructs a new fuzzy query.
FuzzyQueryBuilder(String fieldName, float value)	Constructs a new fuzzy query.
FuzzyQueryBuilder(String fieldName, int value)	Constructs a new fuzzy query.
FuzzyQueryBuilder(String fieldName, long value)	Constructs a new fuzzy query.
FuzzyQueryBuilder(String fieldName, Object value)	Constructs a new fuzzy query.
FuzzyQueryBuilder(String fieldName, String value)	Constructs a new fuzzy query.
FuzzyQueryBuilder(StreamInput in)	Read from a stream.

Method Summary

Modifier and Type	Method	Description
protected boolean	doEquals(FuzzyQueryBuilder other)	Indicates whether some other QueryBuilder object of the same type is "equal to" this one.
protected int	doHashCode()
protected QueryBuilder	doRewrite(QueryRewriteContext queryRewriteContext)
protected org.apache.lucene.search.Query	doToQuery(SearchExecutionContext context)
protected void	doWriteTo(StreamOutput out)
protected void	doXContent(XContentBuilder builder, ToXContent.Params params)
String	fieldName()	Get the field name for this query.
static FuzzyQueryBuilder	fromXContent(XContentParser parser)
Fuzziness	fuzziness()
FuzzyQueryBuilder	fuzziness(Fuzziness fuzziness)
Version	getMinimalSupportedVersion()	The minimal version of the recipient this object can be sent to
String	getWriteableName()	Returns the name of the writeable object
int	maxExpansions()
FuzzyQueryBuilder	maxExpansions(int maxExpansions)
int	prefixLength()
FuzzyQueryBuilder	prefixLength(int prefixLength)
String	rewrite()
FuzzyQueryBuilder	rewrite(String rewrite)
boolean	transpositions()
FuzzyQueryBuilder	transpositions(boolean transpositions)
Object	value()

Methods inherited from class org.elasticsearch.index.query.AbstractQueryBuilder

addValidationError, boost, boost, boostAndQueryNameToXContent, checkNegativeBoost, declareStandardFields, equals, extractInnerHitBuilders, getName, hashCode, parseInnerQueryBuilder, parseInnerQueryBuilder, printBoostAndQueryName, queryName, queryName, readQueries, requireValue, rewrite, throwParsingExceptionOnMultipleFields, toQuery, toString, toXContent, writeQueries, writeTo

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.elasticsearch.index.query.QueryBuilder

boost, boost, getName, queryName, queryName, rewrite, toQuery

Methods inherited from interface org.elasticsearch.xcontent.ToXContent

toXContent

Methods inherited from interface org.elasticsearch.xcontent.ToXContentObject

isFragment

Methods inherited from interface org.elasticsearch.common.io.stream.Writeable

writeTo

Field Details

NAME

public static final String NAME

See Also:

• Constant Field Values

DEFAULT_FUZZINESS

public static final Fuzziness DEFAULT_FUZZINESS

Default maximum edit distance. Defaults to AUTO.

DEFAULT_PREFIX_LENGTH

public static final int DEFAULT_PREFIX_LENGTH

Default number of initial characters which will not be “fuzzified”. Defaults to 0.

See Also:

• Constant Field Values

DEFAULT_MAX_EXPANSIONS

public static final int DEFAULT_MAX_EXPANSIONS

Default maximum number of terms that the fuzzy query will expand to. Defaults to 50.

See Also:

• Constant Field Values

DEFAULT_TRANSPOSITIONS

public static final boolean DEFAULT_TRANSPOSITIONS

Default as to whether transpositions should be treated as a primitive edit operation, instead of classic Levenshtein algorithm. Defaults to true.

See Also:

• Constant Field Values

Constructor Details

FuzzyQueryBuilder

public FuzzyQueryBuilder(String fieldName,
 String value)

Constructs a new fuzzy query.

Parameters:

fieldName - The name of the field

value - The value of the text

FuzzyQueryBuilder

public FuzzyQueryBuilder(String fieldName,
 int value)

Constructs a new fuzzy query.

Parameters:

fieldName - The name of the field

value - The value of the text

FuzzyQueryBuilder

public FuzzyQueryBuilder(String fieldName,
 long value)

Constructs a new fuzzy query.

Parameters:

fieldName - The name of the field

value - The value of the text

FuzzyQueryBuilder

public FuzzyQueryBuilder(String fieldName,
 float value)

Constructs a new fuzzy query.

Parameters:

fieldName - The name of the field

value - The value of the text

FuzzyQueryBuilder

public FuzzyQueryBuilder(String fieldName,
 double value)

Constructs a new fuzzy query.

Parameters:

fieldName - The name of the field

value - The value of the text

FuzzyQueryBuilder

public FuzzyQueryBuilder(String fieldName,
 boolean value)

Constructs a new fuzzy query.

Parameters:

fieldName - The name of the field

value - The value of the text

FuzzyQueryBuilder

public FuzzyQueryBuilder(String fieldName,
 Object value)

Constructs a new fuzzy query.

Parameters:

fieldName - The name of the field

value - The value of the term

FuzzyQueryBuilder

public FuzzyQueryBuilder(StreamInput in)
                  throws IOException

Read from a stream.

Throws:

IOException

Method Details

doWriteTo

protected void doWriteTo(StreamOutput out)
                  throws IOException

Specified by:

doWriteTo in class AbstractQueryBuilder<FuzzyQueryBuilder>

Throws:

IOException

fieldName

public String fieldName()

Description copied from interface: MultiTermQueryBuilder

Get the field name for this query.

Specified by:

fieldName in interface MultiTermQueryBuilder

value

public Object value()

fuzziness

public FuzzyQueryBuilder fuzziness(Fuzziness fuzziness)

fuzziness

public Fuzziness fuzziness()

prefixLength

public FuzzyQueryBuilder prefixLength(int prefixLength)

prefixLength

public int prefixLength()

maxExpansions

public FuzzyQueryBuilder maxExpansions(int maxExpansions)

maxExpansions

public int maxExpansions()

transpositions

public FuzzyQueryBuilder transpositions(boolean transpositions)

transpositions

public boolean transpositions()

rewrite

public FuzzyQueryBuilder rewrite(String rewrite)

rewrite

public String rewrite()

doXContent

protected void doXContent(XContentBuilder builder,
 ToXContent.Params params)
                   throws IOException

Specified by:

doXContent in class AbstractQueryBuilder<FuzzyQueryBuilder>

Throws:

IOException

fromXContent

public static FuzzyQueryBuilder fromXContent(XContentParser parser)
                                      throws IOException

Throws:

IOException

getWriteableName

public String getWriteableName()

Description copied from interface: VersionedNamedWriteable

Returns the name of the writeable object

Specified by:

getWriteableName in interface NamedWriteable

Specified by:

getWriteableName in interface VersionedNamedWriteable

doRewrite

protected QueryBuilder doRewrite(QueryRewriteContext queryRewriteContext)
                          throws IOException

Overrides:

doRewrite in class AbstractQueryBuilder<FuzzyQueryBuilder>

Throws:

IOException

doToQuery

protected org.apache.lucene.search.Query doToQuery(SearchExecutionContext context)
                                            throws IOException

Specified by:

doToQuery in class AbstractQueryBuilder<FuzzyQueryBuilder>

Throws:

IOException

doHashCode

protected int doHashCode()

Specified by:

doHashCode in class AbstractQueryBuilder<FuzzyQueryBuilder>

doEquals

protected boolean doEquals(FuzzyQueryBuilder other)

Description copied from class: AbstractQueryBuilder

Indicates whether some other QueryBuilder object of the same type is "equal to" this one.

Specified by:

doEquals in class AbstractQueryBuilder<FuzzyQueryBuilder>

getMinimalSupportedVersion

public Version getMinimalSupportedVersion()

Description copied from interface: VersionedNamedWriteable

The minimal version of the recipient this object can be sent to

Specified by:

getMinimalSupportedVersion in interface VersionedNamedWriteable