Package com.attivio.sdk.search.query
Class FilterQuery
- java.lang.Object
-
- com.attivio.sdk.search.query.Query
-
- com.attivio.sdk.search.query.FilterQuery
-
- All Implemented Interfaces:
QueryParameters
,LocaleAware
,java.io.Serializable
,java.lang.Cloneable
public final class FilterQuery extends Query
- See Also:
- Serialized Form
-
-
Nested Class Summary
-
Nested classes/interfaces inherited from interface com.attivio.sdk.search.query.QueryParameters
QueryParameters.Parameter
-
-
Field Summary
Fields Modifier and Type Field Description protected QueryParameters.Parameter
parameters
protected Query
query
The search query.-
Fields inherited from class com.attivio.sdk.search.query.Query
boost, DEFAULT_PARAMETERS, IGNORE_PARAMETERS
-
Fields inherited from interface com.attivio.sdk.search.query.QueryParameters
ACL, ACRONYMS, ACRONYMS_EXPANDED, ACRONYMS_ORIGINAL, ALIAS, ALLOW, ANONYMOUS, BOOST, BOOST_FREQUENCY, BOOST_POSITION, BOOST_PROXIMITY, COMPLETENESS_BOOST, DEFAULT_BOOST, DEFAULT_DEPTH, DEFAULT_FIELD_NORMS, DEFAULT_FUZZY_MAX_TERMS, DEFAULT_MINIMUM, DEFAULT_QUOTED, DEFAULT_RECURSIVE, DEFAULT_ROLLUP_LIMIT, DEFAULT_SCORE_DEPTH, DEFAULT_SCORE_EXPLAIN, DEFAULT_SEARCH_FIELD, DEFAULT_SIMILARITY, DEFAULT_SPAN, DENY, DEPTH, DISABLE_COORD, DISTANCE, FACET, FIELD_NORMS, FUZZY_MAX_TERMS, INDEX, LANGUAGE, LOWER, METHOD, MINIMUM, ON, ORDER, QUERY, QUERY_LANGUAGE, QUOTED, RECURSIVE, RELEVANCY_MODEL, ROLLUP, SCORE_DEPTH, SCORE_EXPLAIN, SCORE_FUNCTIONS, SCORE_MODE, SIMILARITY, SIMILARITY_PREFIX, SOUNDS_LIKE, SPAN, SPELLCHECK_CORRECTED, SPELLCHECK_EXPANDED, SPELLCHECK_MODE, SPELLCHECK_ORIGINAL, SPELLCHECK_SUGGESTIONS, STOPWORDS, SYNONYMS, SYNONYMS_EXPANDED, SYNONYMS_ORIGINAL, TOKENIZE, UNSECURED_ZONES, UPPER, WARNING, WILDCARD, XON
-
-
Constructor Summary
Constructors Constructor Description FilterQuery()
FilterQuery(Query query, Query filter)
Construct a new FilterQuery
-
Method Summary
All Methods Static Methods Instance Methods Concrete Methods Modifier and Type Method Description protected static void
addParameter(java.lang.StringBuilder buffer, java.lang.String name, java.lang.Object value)
Add "\"name
\"=\"value
\"" tobuffer
.protected static void
addParameterCompact(java.lang.StringBuilder buffer, java.lang.String name, java.lang.Object value)
Add "\"name
\"=\"value
\"" tobuffer
, omitting value if it is Boolean.TRUE.protected static void
appendParameter(java.lang.StringBuilder buffer, java.lang.String name, java.lang.Object value)
Add ", \"name
\"=\"value
\"" tobuffer
.FilterQuery
clone()
Returns a deep copy of this Query instance.boolean
containsParameter(java.lang.String name)
Returns true if the specified parameter exists for this Query object.protected boolean
equals(java.lang.Object other, java.util.Map<java.lang.String,java.lang.Object> defaults, java.util.Set<java.lang.String> ignore)
Checks whetherquery
equals this Query object.protected static void
escape(java.lang.StringBuilder buffer, java.lang.Object value)
protected void
escape(java.lang.StringBuilder buffer, java.lang.String value, boolean quote)
Helper method to escape a string for toString() .Query
getFilter()
Query
getFirstNode(QueryHandler selector)
Get the first query in the tree that hasparameter
set tovalue
.protected void
getNodes(java.util.List<Query> nodes, QueryHandler selector)
Internal method to collect all nodes that haveparameter
set tovalue
.java.lang.Object
getParameter(java.lang.String name)
Returns a named property for this Query object.boolean
getParameter(java.lang.String name, boolean defaultValue)
Gets a boolean parameter.double
getParameter(java.lang.String name, double defaultValue)
Gets a double parameter.float
getParameter(java.lang.String name, float defaultValue)
Gets a float parameter.int
getParameter(java.lang.String name, int defaultValue)
Gets an integer parameter.long
getParameter(java.lang.String name, long defaultValue)
Gets a long parameter.java.lang.Object
getParameter(java.lang.String name, java.lang.Object defaultValue)
Gets a parameter.java.lang.String
getParameter(java.lang.String name, java.lang.String defaultValue)
Gets a String parameter.java.util.List<java.lang.Object>
getParameterList(java.lang.String name)
Returns list of values found for the named property for this Query object.Query
getQuery()
Get the search query.int
hashCode()
protected static java.lang.StringBuilder
indent(java.lang.StringBuilder buffer, int indent)
Support method to indent a "line" in a StringBuilder.protected boolean
isAllowNull()
Are null sub queries allowed.Query
optimize()
Optimizes this query object, removing unnecessary levels of expressions.java.util.Iterator<java.util.Map.Entry<java.lang.String,java.lang.Object>>
parameters()
Get an iterator for returning all custom parameters.protected static int
parseIntParameter(java.lang.Object value, int defaultValue)
java.lang.String
prettyFormat()
Returns a hierarchical representation of this query as a string.protected void
prettyFormat(java.lang.StringBuilder buffer, int indent)
Pretty format all parameters for this Query instance.void
prettyPrint()
Sends a hierarchical representation of this query to standard out.void
prettyPrint(java.io.PrintStream out)
Sends a hierarchical representation of this query specified PrintStream.java.lang.Object
removeParameter(java.lang.String name)
Remove the value for a parameter for this Query object.Query
rewrite(QueryHandler handler)
Recursively rewrite this query usinghandler
.void
rewriteChildren(QueryHandler handler)
Rewrite child nodes usinghandler
.protected void
setBooleanParameter(java.lang.String key, java.lang.Object value)
Internal method for setting a boolean parameter.protected void
setEnumParameter(java.lang.String key, java.lang.Object value, java.lang.String... enumValues)
Internal method for setting an object parameter.void
setFilter(Query filter)
protected void
setIntegerParameter(java.lang.String key, java.lang.Object value)
Internal method for setting an integer parameter.void
setParameters(java.util.Map<java.lang.String,java.lang.Object> value)
void
setParameters(java.util.Map<java.lang.String,java.lang.Object> params, boolean override)
Copies parameters from a Map into this Query.void
setQuery(Query value)
Set the search query.void
setQuery(java.lang.String term)
Set the search query to be a search forterm
.protected void
setRollupParameter(java.lang.String key, java.lang.Object value)
protected void
setStringParameter(java.lang.String key, java.lang.Object value)
Internal method for setting a string parameter.protected void
setUnsignedParameter(java.lang.String key, java.lang.Object value)
Internal method for setting an integer parameter.java.lang.String
toString()
java.lang.String
toString(boolean compact)
protected void
toString(java.lang.StringBuilder buffer, boolean compact)
Write the String representation of this query tobuffer
.-
Methods inherited from class com.attivio.sdk.search.query.Query
addParameter, addParameters, appendParameters, containsParameters, equals, equals, equals, getAllParameters, getBoost, getInternalParameter, getLocale, getNodes, getQueryLanguage, getQueryString, isCompactParameter, prettyFormatParameters, setBoost, setBoost, setLocale, setParameter, setParameters, setParameters, toCompactString, valueOf
-
-
-
-
Field Detail
-
query
protected Query query
The search query.
-
parameters
protected QueryParameters.Parameter parameters
-
-
Method Detail
-
getFilter
public Query getFilter()
-
setFilter
public void setFilter(Query filter)
-
rewrite
public Query rewrite(QueryHandler handler)
Recursively rewrite this query usinghandler
.
-
rewriteChildren
public void rewriteChildren(QueryHandler handler)
Rewrite child nodes usinghandler
.
-
optimize
public Query optimize()
Optimizes this query object, removing unnecessary levels of expressions.- Returns:
- an optimized form of this Query, or null if this Query is a no-op
-
prettyFormat
protected void prettyFormat(java.lang.StringBuilder buffer, int indent)
Pretty format all parameters for this Query instance.- Parameters:
buffer
- buffer to write pretty formated parameters to.indent
- the indentation level
-
toString
protected void toString(java.lang.StringBuilder buffer, boolean compact)
Write the String representation of this query tobuffer
.
-
equals
protected boolean equals(java.lang.Object other, java.util.Map<java.lang.String,java.lang.Object> defaults, java.util.Set<java.lang.String> ignore)
Checks whetherquery
equals this Query object.- Parameters:
other
- the query to compare todefaults
- map of default values for query parametersignore
- set of query parameters to ignore during equality check.- Returns:
- true if other is equal to this Query
-
hashCode
public int hashCode()
-
clone
public FilterQuery clone()
Returns a deep copy of this Query instance.NOTE: values for parameters are shallow copied.
- Returns:
- a copy of this Query.
-
isAllowNull
protected boolean isAllowNull()
Are null sub queries allowed.
-
getQuery
public Query getQuery()
Get the search query.
-
setQuery
public void setQuery(Query value)
Set the search query.
-
setQuery
public void setQuery(java.lang.String term)
Set the search query to be a search forterm
.
-
getFirstNode
public Query getFirstNode(QueryHandler selector)
Get the first query in the tree that hasparameter
set tovalue
.WARNING: this is an experimental API and may change in the near future.
- Overrides:
getFirstNode
in classQuery
- Returns:
- the first query in the query tree that matches
selector
, ornull
if no match found.
-
getNodes
protected void getNodes(java.util.List<Query> nodes, QueryHandler selector)
Internal method to collect all nodes that haveparameter
set tovalue
.
-
parameters
public java.util.Iterator<java.util.Map.Entry<java.lang.String,java.lang.Object>> parameters()
Get an iterator for returning all custom parameters.
-
containsParameter
public boolean containsParameter(java.lang.String name)
Returns true if the specified parameter exists for this Query object.- Parameters:
name
- parameter name.- Returns:
- true if the specified parameter exists.
-
getParameter
public final java.lang.Object getParameter(java.lang.String name)
Returns a named property for this Query object.- Parameters:
name
- parameter name.- Returns:
- the value for the named property (or null if not found)
-
getParameterList
public final java.util.List<java.lang.Object> getParameterList(java.lang.String name)
Returns list of values found for the named property for this Query object.- Parameters:
name
- parameter name.- Returns:
- list, which might be empty (but we never return null)
-
getParameter
public final java.lang.String getParameter(java.lang.String name, java.lang.String defaultValue)
Gets a String parameter.- Parameters:
name
- parameter name.defaultValue
- default value to return if not set.
-
getParameter
public final boolean getParameter(java.lang.String name, boolean defaultValue)
Gets a boolean parameter.- Parameters:
name
- parameter name.defaultValue
- default value to return if not set.
-
getParameter
public final int getParameter(java.lang.String name, int defaultValue)
Gets an integer parameter.- Parameters:
name
- parameter name.defaultValue
- default value to return if not set.
-
getParameter
public final long getParameter(java.lang.String name, long defaultValue)
Gets a long parameter.- Parameters:
name
- parameter name.defaultValue
- default value to return if not set.
-
getParameter
public final float getParameter(java.lang.String name, float defaultValue)
Gets a float parameter.- Parameters:
name
- parameter name.defaultValue
- default value to return if not set.
-
getParameter
public final double getParameter(java.lang.String name, double defaultValue)
Gets a double parameter.- Parameters:
name
- parameter name.defaultValue
- default value to return if not set.
-
getParameter
public java.lang.Object getParameter(java.lang.String name, java.lang.Object defaultValue)
Gets a parameter.- Parameters:
name
- name of parameter to return.defaultValue
- default value to return if not set.
-
setParameters
public final void setParameters(java.util.Map<java.lang.String,java.lang.Object> value)
-
setParameters
public void setParameters(java.util.Map<java.lang.String,java.lang.Object> params, boolean override)
Copies parameters from a Map into this Query.- Parameters:
params
- the parameters to copy into this Query instance.override
- indicates if parameters from params should overwrite existing parameters in this Query
-
parseIntParameter
protected static int parseIntParameter(java.lang.Object value, int defaultValue)
-
removeParameter
public java.lang.Object removeParameter(java.lang.String name)
Remove the value for a parameter for this Query object.- Parameters:
name
- the parameter to remove.
-
setEnumParameter
protected final void setEnumParameter(java.lang.String key, java.lang.Object value, java.lang.String... enumValues)
Internal method for setting an object parameter.NOTE: enumValues must contain lower case strings.
-
setStringParameter
protected final void setStringParameter(java.lang.String key, java.lang.Object value)
Internal method for setting a string parameter.
-
setIntegerParameter
protected final void setIntegerParameter(java.lang.String key, java.lang.Object value)
Internal method for setting an integer parameter.
-
setUnsignedParameter
protected final void setUnsignedParameter(java.lang.String key, java.lang.Object value)
Internal method for setting an integer parameter.
-
setBooleanParameter
protected final void setBooleanParameter(java.lang.String key, java.lang.Object value)
Internal method for setting a boolean parameter.
-
setRollupParameter
protected final void setRollupParameter(java.lang.String key, java.lang.Object value)
-
appendParameter
protected static void appendParameter(java.lang.StringBuilder buffer, java.lang.String name, java.lang.Object value)
Add ", \"name
\"=\"value
\"" tobuffer
.
-
addParameter
protected static void addParameter(java.lang.StringBuilder buffer, java.lang.String name, java.lang.Object value)
Add "\"name
\"=\"value
\"" tobuffer
.
-
addParameterCompact
protected static void addParameterCompact(java.lang.StringBuilder buffer, java.lang.String name, java.lang.Object value)
Add "\"name
\"=\"value
\"" tobuffer
, omitting value if it is Boolean.TRUE.
-
escape
protected static void escape(java.lang.StringBuilder buffer, java.lang.Object value)
-
escape
protected void escape(java.lang.StringBuilder buffer, java.lang.String value, boolean quote)
Helper method to escape a string for toString() .- Parameters:
buffer
- buffer to write escaped value tovalue
- the value to escapequote
- if true, escaped value will be wrapped in double quotes.
-
toString
public final java.lang.String toString()
- Overrides:
toString
in classjava.lang.Object
-
toString
public final java.lang.String toString(boolean compact)
-
prettyPrint
public final void prettyPrint()
Sends a hierarchical representation of this query to standard out.
-
prettyPrint
public final void prettyPrint(java.io.PrintStream out)
Sends a hierarchical representation of this query specified PrintStream.- Parameters:
out
- stream to output query representation to
-
prettyFormat
public final java.lang.String prettyFormat()
Returns a hierarchical representation of this query as a string.
-
indent
protected static java.lang.StringBuilder indent(java.lang.StringBuilder buffer, int indent)
Support method to indent a "line" in a StringBuilder.
-
-