org.elasticsearch.index.query.xcontent
Class BoolQueryBuilder

java.lang.Object
  org.elasticsearch.index.query.xcontent.BaseQueryBuilder
      org.elasticsearch.index.query.xcontent.BoolQueryBuilder

All Implemented Interfaces:

ToXContent, QueryBuilder, XContentQueryBuilder

public class BoolQueryBuilder
extends BaseQueryBuilder

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

Nested Class Summary

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

ToXContent.MapParams, ToXContent.Params

Field Summary

Fields inherited from interface org.elasticsearch.common.xcontent.ToXContent

EMPTY_PARAMS

Constructor Summary

BoolQueryBuilder()

Method Summary

BoolQueryBuilder	boost(float boost) Sets the boost for this query.
java.util.List<org.elasticsearch.index.query.xcontent.BoolQueryBuilder.Clause>	clauses() A list of the current clauses.
BoolQueryBuilder	disableCoord(boolean disableCoord) Disables Similarity#coord(int,int) in scoring.
protected void	doXContent(XContentBuilder builder, ToXContent.Params params)
BoolQueryBuilder	minimumNumberShouldMatch(int minimumNumberShouldMatch) Specifies a minimum number of the optional (should) boolean clauses which must be satisfied.
BoolQueryBuilder	must(XContentQueryBuilder queryBuilder) Adds a query that must appear in the matching documents.
BoolQueryBuilder	mustNot(XContentQueryBuilder queryBuilder) Adds a query that must not appear in the matching documents.
BoolQueryBuilder	should(XContentQueryBuilder queryBuilder) Adds a query that should appear in the matching documents.

Methods inherited from class org.elasticsearch.index.query.xcontent.BaseQueryBuilder

buildAsBytes, buildAsBytes, buildAsUnsafeBytes, buildAsUnsafeBytes, toXContent

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

BoolQueryBuilder

public BoolQueryBuilder()

Method Detail

must

public BoolQueryBuilder must(XContentQueryBuilder queryBuilder)

Adds a query that must appear in the matching documents.

mustNot

public BoolQueryBuilder mustNot(XContentQueryBuilder queryBuilder)

Adds a query that must not appear in the matching documents.

should

public BoolQueryBuilder should(XContentQueryBuilder queryBuilder)

Adds a query that should appear in the matching documents. For a boolean query with no MUST clauses one or more SHOULD clauses must match a document for the BooleanQuery to match.

See Also:

minimumNumberShouldMatch(int)

boost

public BoolQueryBuilder boost(float boost)

Sets the boost for this query. Documents matching this query will (in addition to the normal weightings) have their score multiplied by the boost provided.

disableCoord

public BoolQueryBuilder disableCoord(boolean disableCoord)

Disables Similarity#coord(int,int) in scoring. Defualts 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

clauses

public java.util.List<org.elasticsearch.index.query.xcontent.BoolQueryBuilder.Clause> clauses()

A list of the current clauses.

doXContent

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

Specified by:

doXContent in class BaseQueryBuilder

Throws:

java.io.IOException