Module org.elasticsearch.server

Package org.elasticsearch.index.query

Class TermQueryBuilder

java.lang.Object

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

org.elasticsearch.index.query.BaseTermQueryBuilder<TermQueryBuilder>

org.elasticsearch.index.query.TermQueryBuilder

All Implemented Interfaces:

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

public class TermQueryBuilder
extends BaseTermQueryBuilder<TermQueryBuilder>

A Query that matches documents containing a term.

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 boolean	DEFAULT_CASE_INSENSITIVITY
static final String	NAME

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

fieldName, value

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, EMPTY_PARAMS

Constructor Summary

Constructors

Constructor	Description
TermQueryBuilder(String fieldName, boolean value)
TermQueryBuilder(String fieldName, double value)
TermQueryBuilder(String fieldName, float value)
TermQueryBuilder(String fieldName, int value)
TermQueryBuilder(String fieldName, long value)
TermQueryBuilder(String fieldName, Object value)
TermQueryBuilder(String fieldName, String value)
TermQueryBuilder(StreamInput in)	Read from a stream.

Method Summary

Modifier and Type	Method	Description
protected void	addExtraXContent(XContentBuilder builder, ToXContent.Params params)
boolean	caseInsensitive()
TermQueryBuilder	caseInsensitive(boolean caseInsensitive)
protected QueryBuilder	doCoordinatorRewrite(CoordinatorRewriteContext coordinatorRewriteContext)
protected final boolean	doEquals(TermQueryBuilder other)	Indicates whether some other QueryBuilder object of the same type is "equal to" this one.
protected final int	doHashCode()
protected QueryBuilder	doIndexMetadataRewrite(QueryRewriteContext context)	Optional rewrite logic that only needs access to index level metadata and services (e.g.
protected org.apache.lucene.search.Query	doToQuery(SearchExecutionContext context)
protected void	doWriteTo(StreamOutput out)
static TermQueryBuilder	fromXContent(XContentParser parser)
TransportVersion	getMinimalSupportedVersion()	The minimal version of the recipient this object can be sent to
String	getWriteableName()	Returns the name of the writeable object

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

doXContent, fieldName, value

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

addValidationError, boost, boost, boostAndQueryNameToXContent, checkNegativeBoost, declareStandardFields, doInnerHitsRewrite, doRewrite, doSearchRewrite, equals, extractInnerHitBuilders, getMaxNestedDepth, getName, hashCode, parseInnerQueryBuilder, parseTopLevelQuery, parseTopLevelQuery, printBoostAndQueryName, queryName, queryName, readQueries, requireValue, rewrite, setMaxNestedDepth, 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.xcontent.ToXContentObject

isFragment

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

TermQueryBuilder

public TermQueryBuilder(String fieldName,
 String value)

See Also:

• BaseTermQueryBuilder(String, String)

TermQueryBuilder

public TermQueryBuilder(String fieldName,
 int value)

See Also:

• BaseTermQueryBuilder(String, int)

TermQueryBuilder

public TermQueryBuilder(String fieldName,
 long value)

See Also:

• BaseTermQueryBuilder(String, long)

TermQueryBuilder

public TermQueryBuilder(String fieldName,
 float value)

See Also:

• BaseTermQueryBuilder(String, float)

TermQueryBuilder

public TermQueryBuilder(String fieldName,
 double value)

See Also:

• BaseTermQueryBuilder(String, double)

TermQueryBuilder

public TermQueryBuilder(String fieldName,
 boolean value)

See Also:

• BaseTermQueryBuilder(String, boolean)

TermQueryBuilder

public TermQueryBuilder(String fieldName,
 Object value)

See Also:

• BaseTermQueryBuilder(String, Object)

TermQueryBuilder

public TermQueryBuilder(StreamInput in)
                 throws IOException

Read from a stream.

Throws:

IOException

Method Details

caseInsensitive

public TermQueryBuilder caseInsensitive(boolean caseInsensitive)

caseInsensitive

public boolean caseInsensitive()

doWriteTo

protected void doWriteTo(StreamOutput out)
                  throws IOException

Overrides:

doWriteTo in class BaseTermQueryBuilder<TermQueryBuilder>

Throws:

IOException

fromXContent

public static TermQueryBuilder fromXContent(XContentParser parser)
                                     throws IOException

Throws:

IOException

addExtraXContent

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

Overrides:

addExtraXContent in class BaseTermQueryBuilder<TermQueryBuilder>

Throws:

IOException

doIndexMetadataRewrite

protected QueryBuilder doIndexMetadataRewrite(QueryRewriteContext context)

Description copied from class: AbstractQueryBuilder

Optional rewrite logic that only needs access to index level metadata and services (e.g. index settings and mappings) on the data node, but not the shard / Lucene index. The can_match phase can use this logic to early terminate a search without doing any search related i/o.

Overrides:

doIndexMetadataRewrite in class AbstractQueryBuilder<TermQueryBuilder>

Parameters:

context - an QueryRewriteContext instance that has access the mappings and other index metadata

Returns:

A QueryBuilder representing the rewritten query, that could be used to determine whether this query yields result.

doCoordinatorRewrite

protected QueryBuilder doCoordinatorRewrite(CoordinatorRewriteContext coordinatorRewriteContext)

Overrides:

doCoordinatorRewrite in class AbstractQueryBuilder<TermQueryBuilder>

Parameters:

coordinatorRewriteContext - A QueryRewriteContext that enables limited rewrite capabilities happening on the coordinator node before execution moves to the data node.

Returns:

A QueryBuilder representing the rewritten query which could be executed without going to the date node.

doToQuery

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

Specified by:

doToQuery in class AbstractQueryBuilder<TermQueryBuilder>

Throws:

IOException

getWriteableName

public String getWriteableName()

Description copied from interface: VersionedNamedWriteable

Returns the name of the writeable object

doHashCode

protected final int doHashCode()

Overrides:

doHashCode in class BaseTermQueryBuilder<TermQueryBuilder>

doEquals

protected final boolean doEquals(TermQueryBuilder other)

Description copied from class: AbstractQueryBuilder

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

Overrides:

doEquals in class BaseTermQueryBuilder<TermQueryBuilder>

getMinimalSupportedVersion

public TransportVersion getMinimalSupportedVersion()

Description copied from interface: VersionedNamedWriteable

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