Class SimpleQueryStringBuilder
- All Implemented Interfaces:
NamedWriteable
,VersionedNamedWriteable
,Writeable
,QueryBuilder
,Rewriteable<QueryBuilder>
,ToXContent
,ToXContentObject
- '
+
' specifiesAND
operation:token1+token2
- '
|
' specifiesOR
operation:token1|token2
- '
-
' negates a single token:-token0
- '
"
' creates phrases of terms:"term1 term2 ..."
- '
*
' at the end of terms specifies prefix query:term*
- '
(
' and ')
' specifies precedence:token1 + (token2 | token3)
- '
~
N' at the end of terms specifies fuzzy query:term~1
- '
~
N' at the end of phrases specifies near/slop query:"term1 term2"~5
See: SimpleQueryStringQueryParser
for more information.
This query supports these options:
Required:
query
- query text to be converted into other queries
Optional:
analyzer
- anaylzer to be used for analyzing tokens to determine
which kind of query they should be converted into, defaults to "standard"
default_operator
- default operator for boolean queries, defaults
to OR
fields
- fields to search, defaults to _all if not set, allows
boosting a field with ^n
For more detailed explanation of the query string syntax see also the online documentation.
-
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
FieldsModifier and TypeFieldDescriptionstatic final boolean
Default for wildcard analysis.static final int
Default for search flags to use.static final int
Default number of terms fuzzy queries will expand to.static final int
Default for prefix length in fuzzy queries.static final boolean
Default for using transpositions in fuzzy queries.static final boolean
Default for using lenient query parsing.static final Operator
Default for default operator to use for linking boolean clauses.static final MultiMatchQueryBuilder.Type
static final String
Name for (de-)serialization.static final TransportVersion
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
ConstructorsConstructorDescriptionSimpleQueryStringBuilder
(String queryText) Construct a new simple query with this query string.Read from a stream. -
Method Summary
Modifier and TypeMethodDescriptionanalyzer()
Returns the analyzer to use for the query.Specify an analyzer to use for the query.boolean
Returns whether wildcards should by analyzed.analyzeWildcard
(boolean analyzeWildcard) Specifies whether wildcards should be analyzed.boolean
Whether phrase queries should be automatically generated for multi terms synonyms.autoGenerateSynonymsPhraseQuery
(boolean value) Returns the default operator for the query.defaultOperator
(Operator defaultOperator) Specify the default operator for the query.protected boolean
doEquals
(SimpleQueryStringBuilder other) Indicates whether some otherQueryBuilder
object of the same type is "equal to" this one.protected int
protected org.apache.lucene.search.Query
doToQuery
(SearchExecutionContext context) protected void
doWriteTo
(StreamOutput out) protected void
doXContent
(XContentBuilder builder, ToXContent.Params params) Add a field to run the query against.Add a field to run the query against with a specific boost.fields()
Returns the fields including their respective boosts to run the query against.Add several fields to run the query against with a specific boost.flags
(SimpleQueryStringFlag... flags) Specify the enabled features of the SimpleQueryString.static SimpleQueryStringBuilder
fromXContent
(XContentParser parser) int
fuzzyMaxExpansions
(int fuzzyMaxExpansions) int
fuzzyPrefixLength
(int fuzzyPrefixLength) boolean
fuzzyTranspositions
(boolean fuzzyTranspositions) Sets whether transpositions are supported in fuzzy queries.The minimal version of the recipient this object can be sent toReturns the name of the writeable objectboolean
lenient()
Returns whether query parsing should be lenient.lenient
(boolean lenient) Specifies whether query parsing should be lenient.Returns the minimumShouldMatch to apply to the resulting query should that be a Boolean query.minimumShouldMatch
(String minimumShouldMatch) Specifies the minimumShouldMatch to apply to the resulting query should that be a Boolean query.Return the suffix to append to field names for phrase matching.quoteFieldSuffix
(String suffix) Set the suffix to append to field names for phrase matching.type()
value()
Returns the text to parse the query from.Methods inherited from class org.elasticsearch.index.query.AbstractQueryBuilder
addValidationError, boost, boost, boostAndQueryNameToXContent, checkNegativeBoost, declareStandardFields, doCoordinatorRewrite, doIndexMetadataRewrite, 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
-
DEFAULT_LENIENT
public static final boolean DEFAULT_LENIENTDefault for using lenient query parsing.- See Also:
-
DEFAULT_ANALYZE_WILDCARD
public static final boolean DEFAULT_ANALYZE_WILDCARDDefault for wildcard analysis.- See Also:
-
DEFAULT_OPERATOR
Default for default operator to use for linking boolean clauses. -
DEFAULT_FLAGS
public static final int DEFAULT_FLAGSDefault for search flags to use. -
DEFAULT_FUZZY_PREFIX_LENGTH
public static final int DEFAULT_FUZZY_PREFIX_LENGTHDefault for prefix length in fuzzy queries.- See Also:
-
DEFAULT_FUZZY_MAX_EXPANSIONS
public static final int DEFAULT_FUZZY_MAX_EXPANSIONSDefault number of terms fuzzy queries will expand to.- See Also:
-
DEFAULT_FUZZY_TRANSPOSITIONS
public static final boolean DEFAULT_FUZZY_TRANSPOSITIONSDefault for using transpositions in fuzzy queries.- See Also:
-
DEFAULT_TYPE
-
NAME
Name for (de-)serialization.- See Also:
-
TYPE_FIELD_ADDED_VERSION
-
-
Constructor Details
-
SimpleQueryStringBuilder
Construct a new simple query with this query string. -
SimpleQueryStringBuilder
Read from a stream.- Throws:
IOException
-
-
Method Details
-
doWriteTo
- Specified by:
doWriteTo
in classAbstractQueryBuilder<SimpleQueryStringBuilder>
- Throws:
IOException
-
value
Returns the text to parse the query from. -
field
Add a field to run the query against. -
field
Add a field to run the query against with a specific boost. -
fields
Add several fields to run the query against with a specific boost. -
fields
Returns the fields including their respective boosts to run the query against. -
analyzer
Specify an analyzer to use for the query. -
analyzer
Returns the analyzer to use for the query. -
defaultOperator
Specify the default operator for the query. Defaults to "OR" if no operator is specified. -
defaultOperator
Returns the default operator for the query. -
flags
Specify the enabled features of the SimpleQueryString. Defaults to ALL if none are specified. -
quoteFieldSuffix
Set the suffix to append to field names for phrase matching. -
quoteFieldSuffix
Return the suffix to append to field names for phrase matching. -
lenient
Specifies whether query parsing should be lenient. Defaults to false. -
lenient
public boolean lenient()Returns whether query parsing should be lenient. -
analyzeWildcard
Specifies whether wildcards should be analyzed. Defaults to false. -
analyzeWildcard
public boolean analyzeWildcard()Returns whether wildcards should by analyzed. -
minimumShouldMatch
Specifies the minimumShouldMatch to apply to the resulting query should that be a Boolean query. -
minimumShouldMatch
Returns the minimumShouldMatch to apply to the resulting query should that be a Boolean query. -
autoGenerateSynonymsPhraseQuery
-
autoGenerateSynonymsPhraseQuery
public boolean autoGenerateSynonymsPhraseQuery()Whether phrase queries should be automatically generated for multi terms synonyms. Defaults totrue
. -
fuzzyPrefixLength
-
fuzzyPrefixLength
public int fuzzyPrefixLength() -
fuzzyMaxExpansions
-
fuzzyMaxExpansions
public int fuzzyMaxExpansions() -
fuzzyTranspositions
public boolean fuzzyTranspositions() -
fuzzyTranspositions
Sets whether transpositions are supported in fuzzy queries.The default metric used by fuzzy queries to determine a match is the Damerau-Levenshtein distance formula which supports transpositions. Setting transposition to false will switch to classic Levenshtein distance.
If not set, Damerau-Levenshtein distance metric will be used. -
type
-
type
-
doToQuery
protected org.apache.lucene.search.Query doToQuery(SearchExecutionContext context) throws IOException - Specified by:
doToQuery
in classAbstractQueryBuilder<SimpleQueryStringBuilder>
- Throws:
IOException
-
doXContent
- Specified by:
doXContent
in classAbstractQueryBuilder<SimpleQueryStringBuilder>
- Throws:
IOException
-
fromXContent
- Throws:
IOException
-
getWriteableName
Description copied from interface:VersionedNamedWriteable
Returns the name of the writeable object -
doHashCode
protected int doHashCode()- Specified by:
doHashCode
in classAbstractQueryBuilder<SimpleQueryStringBuilder>
-
doEquals
Description copied from class:AbstractQueryBuilder
Indicates whether some otherQueryBuilder
object of the same type is "equal to" this one.- Specified by:
doEquals
in classAbstractQueryBuilder<SimpleQueryStringBuilder>
-
getMinimalSupportedVersion
Description copied from interface:VersionedNamedWriteable
The minimal version of the recipient this object can be sent to
-