Package org.elasticsearch.index.query

Class WildcardQueryBuilder

java.lang.Object

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

org.elasticsearch.index.query.WildcardQueryBuilder

All Implemented Interfaces:

NamedWriteable, Writeable, org.elasticsearch.common.xcontent.ToXContent, org.elasticsearch.common.xcontent.ToXContentObject, MultiTermQueryBuilder, QueryBuilder, Rewriteable<QueryBuilder>

public class WildcardQueryBuilder
extends AbstractQueryBuilder<WildcardQueryBuilder>
implements MultiTermQueryBuilder

Implements the wildcard search query. Supported wildcards are *, which matches any character sequence (including the empty one), and ?, which matches any single character. Note this query can be slow, as it needs to iterate over many terms. In order to prevent extremely slow WildcardQueries, a Wildcard term should not start with one of the wildcards * or ?.

Nested Class Summary

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

org.elasticsearch.common.xcontent.ToXContent.DelegatingMapParams, org.elasticsearch.common.xcontent.ToXContent.MapParams, org.elasticsearch.common.xcontent.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 boolean	DEFAULT_CASE_INSENSITIVITY
static 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.common.xcontent.ToXContent

EMPTY_PARAMS

Constructor Summary

Constructors

Constructor	Description
WildcardQueryBuilder(String fieldName, String value)	Implements the wildcard search query.
WildcardQueryBuilder(StreamInput in)	Read from a stream.

Method Summary

Modifier and Type	Method	Description
boolean	caseInsensitive()
WildcardQueryBuilder	caseInsensitive(boolean caseInsensitive)
protected boolean	doEquals(WildcardQueryBuilder 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(org.elasticsearch.common.xcontent.XContentBuilder builder, org.elasticsearch.common.xcontent.ToXContent.Params params)
String	fieldName()	Get the field name for this query.
static WildcardQueryBuilder	fromXContent(org.elasticsearch.common.xcontent.XContentParser parser)
String	getWriteableName()	Returns the name of the writeable object
String	rewrite()
WildcardQueryBuilder	rewrite(String rewrite)
String	value()

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

addValidationError, boost, boost, checkNegativeBoost, declareStandardFields, equals, extractInnerHitBuilders, getName, hashCode, parseInnerQueryBuilder, parseInnerQueryBuilder, printBoostAndQueryName, queryName, queryName, requireValue, rewrite, throwParsingExceptionOnMultipleFields, toQuery, toString, toXContent, 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.common.xcontent.ToXContent

toXContent

Methods inherited from interface org.elasticsearch.common.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_CASE_INSENSITIVITY

public static final boolean DEFAULT_CASE_INSENSITIVITY

See Also:

Constant Field Values

Constructor Details

WildcardQueryBuilder

public WildcardQueryBuilder(String fieldName,
 String value)

Implements the wildcard search query. Supported wildcards are *, which matches any character sequence (including the empty one), and ?, which matches any single character. Note this query can be slow, as it needs to iterate over many terms. In order to prevent extremely slow WildcardQueries, a Wildcard term should not start with one of the wildcards * or ?.

Parameters:

fieldName - The field name

value - The wildcard query string

WildcardQueryBuilder

public WildcardQueryBuilder(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<WildcardQueryBuilder>

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 String value()

rewrite

public WildcardQueryBuilder rewrite(String rewrite)

rewrite

public String rewrite()

caseInsensitive

public WildcardQueryBuilder caseInsensitive(boolean caseInsensitive)

caseInsensitive

public boolean caseInsensitive()

getWriteableName

public String getWriteableName()

Description copied from interface: NamedWriteable

Returns the name of the writeable object

Specified by:

getWriteableName in interface NamedWriteable

doXContent

protected void doXContent(org.elasticsearch.common.xcontent.XContentBuilder builder,
 org.elasticsearch.common.xcontent.ToXContent.Params params)
                   throws IOException

Specified by:

doXContent in class AbstractQueryBuilder<WildcardQueryBuilder>

Throws:

IOException

fromXContent

public static WildcardQueryBuilder fromXContent(org.elasticsearch.common.xcontent.XContentParser parser)
                                         throws IOException

Throws:

IOException

doRewrite

protected QueryBuilder doRewrite(QueryRewriteContext queryRewriteContext)
                          throws IOException

Overrides:

doRewrite in class AbstractQueryBuilder<WildcardQueryBuilder>

Throws:

IOException

doToQuery

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

Specified by:

doToQuery in class AbstractQueryBuilder<WildcardQueryBuilder>

Throws:

IOException

doHashCode

protected int doHashCode()

Specified by:

doHashCode in class AbstractQueryBuilder<WildcardQueryBuilder>

doEquals

protected boolean doEquals(WildcardQueryBuilder 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<WildcardQueryBuilder>