Package org.elasticsearch.index.query

Class TermsQueryBuilder

java.lang.Object

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

org.elasticsearch.index.query.TermsQueryBuilder

All Implemented Interfaces:

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

public class TermsQueryBuilder
extends AbstractQueryBuilder<TermsQueryBuilder>

A filter for a field based on several terms matching on any of them.

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 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
TermsQueryBuilder(String fieldName, double... values)	A filter for a field based on several terms matching on any of them.
TermsQueryBuilder(String fieldName, float... values)	A filter for a field based on several terms matching on any of them.
TermsQueryBuilder(String fieldName, int... values)	A filter for a field based on several terms matching on any of them.
TermsQueryBuilder(String fieldName, long... values)	A filter for a field based on several terms matching on any of them.
TermsQueryBuilder(String fieldName, Iterable<?> values)	A filter for a field based on several terms matching on any of them.
TermsQueryBuilder(String fieldName, Object... values)	A filter for a field based on several terms matching on any of them.
TermsQueryBuilder(String fieldName, String... values)	A filter for a field based on several terms matching on any of them.
TermsQueryBuilder(String fieldName, TermsLookup termsLookup)
TermsQueryBuilder(StreamInput in)	Read from a stream.

Method Summary

Modifier and Type	Method	Description
protected boolean	doEquals(TermsQueryBuilder 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()
static TermsQueryBuilder	fromXContent(org.elasticsearch.common.xcontent.XContentParser parser)
org.elasticsearch.index.query.TermsQueryBuilder.Values	getValues()
String	getWriteableName()	Returns the name of the writeable object
boolean	isTypeless()
TermsLookup	termsLookup()
List<Object>	values()	get readable values only for AbstractQueryBuilder.toXContent(org.elasticsearch.common.xcontent.XContentBuilder, org.elasticsearch.common.xcontent.ToXContent.Params) and tests, don't use this to construct a query.

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.common.xcontent.ToXContentObject

isFragment

Field Details

NAME

public static final String NAME

See Also:

Constant Field Values

Constructor Details

TermsQueryBuilder

public TermsQueryBuilder(String fieldName,
 TermsLookup termsLookup)

TermsQueryBuilder

public TermsQueryBuilder(String fieldName,
 String... values)

A filter for a field based on several terms matching on any of them.

Parameters:

fieldName - The field name

values - The terms

TermsQueryBuilder

public TermsQueryBuilder(String fieldName,
 int... values)

A filter for a field based on several terms matching on any of them.

Parameters:

fieldName - The field name

values - The terms

TermsQueryBuilder

public TermsQueryBuilder(String fieldName,
 long... values)

A filter for a field based on several terms matching on any of them.

Parameters:

fieldName - The field name

values - The terms

TermsQueryBuilder

public TermsQueryBuilder(String fieldName,
 float... values)

A filter for a field based on several terms matching on any of them.

Parameters:

fieldName - The field name

values - The terms

TermsQueryBuilder

public TermsQueryBuilder(String fieldName,
 double... values)

A filter for a field based on several terms matching on any of them.

Parameters:

fieldName - The field name

values - The terms

TermsQueryBuilder

public TermsQueryBuilder(String fieldName,
 Object... values)

A filter for a field based on several terms matching on any of them.

Parameters:

fieldName - The field name

values - The terms

TermsQueryBuilder

public TermsQueryBuilder(String fieldName,
 Iterable<?> values)

A filter for a field based on several terms matching on any of them.

Parameters:

fieldName - The field name

values - The terms

TermsQueryBuilder

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

Throws:

IOException

fieldName

public String fieldName()

getValues

public org.elasticsearch.index.query.TermsQueryBuilder.Values getValues()

values

public List<Object> values()

get readable values only for AbstractQueryBuilder.toXContent(org.elasticsearch.common.xcontent.XContentBuilder, org.elasticsearch.common.xcontent.ToXContent.Params) and tests, don't use this to construct a query. use getValues() instead.

termsLookup

public TermsLookup termsLookup()

isTypeless

public boolean isTypeless()

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<TermsQueryBuilder>

Throws:

IOException

fromXContent

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

Throws:

IOException

getWriteableName

public String getWriteableName()

Description copied from interface: NamedWriteable

Returns the name of the writeable object

doToQuery

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

Specified by:

doToQuery in class AbstractQueryBuilder<TermsQueryBuilder>

Throws:

IOException

doHashCode

protected int doHashCode()

Specified by:

doHashCode in class AbstractQueryBuilder<TermsQueryBuilder>

doEquals

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

doRewrite

protected QueryBuilder doRewrite(QueryRewriteContext queryRewriteContext)

Overrides:

doRewrite in class AbstractQueryBuilder<TermsQueryBuilder>