org.elasticsearch.index.query

Class BoolQueryBuilder

java.lang.Object

org.elasticsearch.action.support.ToXContentToBytes

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

org.elasticsearch.index.query.BoolQueryBuilder

All Implemented Interfaces:

NamedWriteable<BoolQueryBuilder>, StreamableReader<BoolQueryBuilder>, Writeable<BoolQueryBuilder>, ToXContent, QueryBuilder<BoolQueryBuilder>

public class BoolQueryBuilder
extends AbstractQueryBuilder<BoolQueryBuilder>

A Query that matches documents matching boolean combinations of other queries.

Nested Class Summary

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

Writeable.Reader<R>

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

ToXContent.DelegatingMapParams, ToXContent.MapParams, ToXContent.Params

Field Summary

Fields

Modifier and Type	Field and Description
static boolean	ADJUST_PURE_NEGATIVE_DEFAULT
static boolean	DISABLE_COORD_DEFAULT
static java.lang.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.common.xcontent.ToXContent

EMPTY_PARAMS

Constructor Summary

Constructors

Constructor and Description
BoolQueryBuilder()

Method Summary

Modifier and Type	Method and Description
boolean	adjustPureNegative()
BoolQueryBuilder	adjustPureNegative(boolean adjustPureNegative) If a boolean query contains only negative ("must not") clauses should the BooleanQuery be enhanced with a MatchAllDocsQuery in order to act as a pure exclude.
boolean	disableCoord()
BoolQueryBuilder	disableCoord(boolean disableCoord) Disables Similarity#coord(int,int) in scoring.
protected boolean	doEquals(BoolQueryBuilder other) Indicates whether some other QueryBuilder object of the same type is "equal to" this one.
protected int	doHashCode()
protected BoolQueryBuilder	doReadFrom(StreamInput in)
protected QueryBuilder<?>	doRewrite(QueryRewriteContext queryRewriteContext)
protected org.apache.lucene.search.Query	doToQuery(QueryShardContext context)
protected void	doWriteTo(StreamOutput out)
protected void	doXContent(XContentBuilder builder, ToXContent.Params params)
java.util.List<QueryBuilder<?>>	filter() Gets the queries that must appear in the matching documents but don't contribute to scoring
BoolQueryBuilder	filter(QueryBuilder<?> queryBuilder) Adds a query that must appear in the matching documents but will not contribute to scoring.
java.lang.String	getWriteableName() Returns the name of the writeable object
boolean	hasClauses() Returns true iff this query builder has at least one should, must, must not or filter clause.
BoolQueryBuilder	minimumNumberShouldMatch(int minimumNumberShouldMatch) Specifies a minimum number of the optional (should) boolean clauses which must be satisfied.
BoolQueryBuilder	minimumNumberShouldMatch(java.lang.String minimumNumberShouldMatch) Specifies a minimum number of the optional (should) boolean clauses which must be satisfied.
java.lang.String	minimumShouldMatch()
BoolQueryBuilder	minimumShouldMatch(java.lang.String minimumShouldMatch) Sets the minimum should match using the special syntax (for example, supporting percentage).
java.util.List<QueryBuilder<?>>	must() Gets the queries that must appear in the matching documents.
BoolQueryBuilder	must(QueryBuilder<?> queryBuilder) Adds a query that must appear in the matching documents and will contribute to scoring.
java.util.List<QueryBuilder<?>>	mustNot() Gets the queries that must not appear in the matching documents.
BoolQueryBuilder	mustNot(QueryBuilder<?> queryBuilder) Adds a query that must not appear in the matching documents.
java.util.List<QueryBuilder<?>>	should() Gets the list of clauses that should be matched by the returned documents.
BoolQueryBuilder	should(QueryBuilder<?> queryBuilder) Adds a clause that should be matched by the returned documents.

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

addValidationError, boost, boost, convertToBytesRefIfString, convertToStringIfBytesRef, equals, getName, hashCode, printBoostAndQueryName, queryName, queryName, readFrom, readQueries, rewrite, toFilter, toQueries, toQuery, toXContent, writeQueries, writeTo

Methods inherited from class org.elasticsearch.action.support.ToXContentToBytes

buildAsBytes, buildAsBytes, toString

Methods inherited from class java.lang.Object

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

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

rewriteQuery

Field Detail

NAME

public static final java.lang.String NAME

See Also:

Constant Field Values

ADJUST_PURE_NEGATIVE_DEFAULT

public static final boolean ADJUST_PURE_NEGATIVE_DEFAULT

See Also:

Constant Field Values

DISABLE_COORD_DEFAULT

public static final boolean DISABLE_COORD_DEFAULT

See Also:

Constant Field Values

Constructor Detail

BoolQueryBuilder

public BoolQueryBuilder()

Method Detail

must

public BoolQueryBuilder must(QueryBuilder<?> queryBuilder)

Adds a query that must appear in the matching documents and will contribute to scoring. No null value allowed.

must

public java.util.List<QueryBuilder<?>> must()

Gets the queries that must appear in the matching documents.

filter

public BoolQueryBuilder filter(QueryBuilder<?> queryBuilder)

Adds a query that must appear in the matching documents but will not contribute to scoring. No null value allowed.

filter

public java.util.List<QueryBuilder<?>> filter()

Gets the queries that must appear in the matching documents but don't contribute to scoring

mustNot

public BoolQueryBuilder mustNot(QueryBuilder<?> queryBuilder)

Adds a query that must not appear in the matching documents. No null value allowed.

mustNot

public java.util.List<QueryBuilder<?>> mustNot()

Gets the queries that must not appear in the matching documents.

should

public BoolQueryBuilder should(QueryBuilder<?> queryBuilder)

Adds a clause that should be matched by the returned documents. For a boolean query with no MUST clauses one or more SHOULD clauses must match a document for the BooleanQuery to match. No null value allowed.

See Also:

minimumNumberShouldMatch(int)

should

public java.util.List<QueryBuilder<?>> should()

Gets the list of clauses that should be matched by the returned documents.

See Also:

should(QueryBuilder), minimumNumberShouldMatch(int)

disableCoord

public BoolQueryBuilder disableCoord(boolean disableCoord)

Disables Similarity#coord(int,int) in scoring. Defaults to false.

disableCoord

public boolean disableCoord()

Returns:

whether the Similarity#coord(int,int) in scoring are disabled. Defaults to false.

minimumNumberShouldMatch

public BoolQueryBuilder minimumNumberShouldMatch(int minimumNumberShouldMatch)

Specifies a minimum number of the optional (should) boolean clauses which must be satisfied.

By default no optional clauses are necessary for a match (unless there are no required clauses). If this method is used, then the specified number of clauses is required.

Use of this method is totally independent of specifying that any specific clauses are required (or prohibited). This number will only be compared against the number of matching optional clauses.

Parameters:

minimumNumberShouldMatch - the number of optional clauses that must match

minimumNumberShouldMatch

public BoolQueryBuilder minimumNumberShouldMatch(java.lang.String minimumNumberShouldMatch)

Specifies a minimum number of the optional (should) boolean clauses which must be satisfied.

See Also:

minimumNumberShouldMatch(int)

minimumShouldMatch

public java.lang.String minimumShouldMatch()

Returns:

the string representation of the minimumShouldMatch settings for this query

minimumShouldMatch

public BoolQueryBuilder minimumShouldMatch(java.lang.String minimumShouldMatch)

Sets the minimum should match using the special syntax (for example, supporting percentage).

hasClauses

public boolean hasClauses()

Returns true iff this query builder has at least one should, must, must not or filter clause. Otherwise false.

adjustPureNegative

public BoolQueryBuilder adjustPureNegative(boolean adjustPureNegative)

If a boolean query contains only negative ("must not") clauses should the BooleanQuery be enhanced with a MatchAllDocsQuery in order to act as a pure exclude. The default is true.

adjustPureNegative

public boolean adjustPureNegative()

Returns:

the setting for the adjust_pure_negative setting in this query

doXContent

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

Specified by:

doXContent in class AbstractQueryBuilder<BoolQueryBuilder>

Throws:

java.io.IOException

getWriteableName

public java.lang.String getWriteableName()

Description copied from interface: NamedWriteable

Returns the name of the writeable object

doToQuery

protected org.apache.lucene.search.Query doToQuery(QueryShardContext context)
                                            throws java.io.IOException

Specified by:

doToQuery in class AbstractQueryBuilder<BoolQueryBuilder>

Throws:

java.io.IOException

doHashCode

protected int doHashCode()

Specified by:

doHashCode in class AbstractQueryBuilder<BoolQueryBuilder>

doEquals

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

doReadFrom

protected BoolQueryBuilder doReadFrom(StreamInput in)
                               throws java.io.IOException

Specified by:

doReadFrom in class AbstractQueryBuilder<BoolQueryBuilder>

Throws:

java.io.IOException

doWriteTo

protected void doWriteTo(StreamOutput out)
                  throws java.io.IOException

Specified by:

doWriteTo in class AbstractQueryBuilder<BoolQueryBuilder>

Throws:

java.io.IOException

doRewrite

protected QueryBuilder<?> doRewrite(QueryRewriteContext queryRewriteContext)
                             throws java.io.IOException

Overrides:

doRewrite in class AbstractQueryBuilder<BoolQueryBuilder>

Throws:

java.io.IOException