org.apache.jackrabbit.oak.query

Class QueryEngineSettings

java.lang.Object

org.apache.jackrabbit.oak.query.QueryEngineSettings

All Implemented Interfaces:

QueryEngineSettingsMBean, QueryLimits

public class QueryEngineSettings
extends Object
implements QueryEngineSettingsMBean, QueryLimits

Settings of the query engine.

Field Summary

Fields

Modifier and Type	Field and Description
static boolean	DEFAULT_FAST_QUERY_SIZE
static long	DEFAULT_QUERY_LIMIT_IN_MEMORY
static long	DEFAULT_QUERY_LIMIT_READS
static String	OAK_QUERY_FAIL_TRAVERSAL
static String	OAK_QUERY_LIMIT_IN_MEMORY
static String	OAK_QUERY_LIMIT_READS
static String	SQL2_OPTIMISATION_FLAG the flag used to turn on/off the optimisations on top of the org.apache.jackrabbit.oak.query.Query object.
static String	SQL2_OPTIMISATION_FLAG_2
static boolean	SQL2_OPTIMIZATION_2

Fields inherited from interface org.apache.jackrabbit.oak.api.jmx.QueryEngineSettingsMBean

TYPE

Constructor Summary

Constructors

Constructor and Description
QueryEngineSettings()
QueryEngineSettings(StatisticsProvider statisticsProvider)

Method Summary

Modifier and Type	Method and Description
boolean	getFailTraversal() Whether queries that don't use an index will fail (throw an exception).
boolean	getFullTextComparisonWithoutIndex()
long	getLimitInMemory() Get the limit on how many nodes a query may read at most into memory, for "order by" and "distinct" queries.
long	getLimitReads() Get the limit on how many nodes a query may read at most (raw read operations, including skipped nodes).
QueryStatsMBean	getQueryStats()
QueryStatsReporter	getQueryStatsReporter()
QueryValidator	getQueryValidator()
String	getQueryValidatorJson()
StatisticsProvider	getStatisticsProvider()
boolean	isFastQuerySize() Whether the query result size should return an estimation for large queries.
boolean	isSql2Optimisation()
void	setFailTraversal(boolean failTraversal) Set whether queries that don't use an index will fail (throw an exception).
void	setFastQuerySize(boolean fastQuerySize)
void	setFullTextComparisonWithoutIndex(boolean fullTextComparisonWithoutIndex)
void	setLimitInMemory(long limitInMemory) Change the limit.
void	setLimitReads(long limitReads) Change the limit.
void	setQueryValidatorPattern(String key, String pattern, String comment, boolean failQuery) Set or remove a query validator pattern.
String	toString()

Methods inherited from class java.lang.Object

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

Field Detail

SQL2_OPTIMISATION_FLAG

public static final String SQL2_OPTIMISATION_FLAG

the flag used to turn on/off the optimisations on top of the org.apache.jackrabbit.oak.query.Query object. -Doak.query.sql2optimisation

See Also:

Constant Field Values

SQL2_OPTIMISATION_FLAG_2

public static final String SQL2_OPTIMISATION_FLAG_2

See Also:

Constant Field Values

SQL2_OPTIMIZATION_2

public static final boolean SQL2_OPTIMIZATION_2

OAK_QUERY_LIMIT_IN_MEMORY

public static final String OAK_QUERY_LIMIT_IN_MEMORY

See Also:

Constant Field Values

DEFAULT_QUERY_LIMIT_IN_MEMORY

public static final long DEFAULT_QUERY_LIMIT_IN_MEMORY

OAK_QUERY_LIMIT_READS

public static final String OAK_QUERY_LIMIT_READS

See Also:

Constant Field Values

DEFAULT_QUERY_LIMIT_READS

public static final long DEFAULT_QUERY_LIMIT_READS

OAK_QUERY_FAIL_TRAVERSAL

public static final String OAK_QUERY_FAIL_TRAVERSAL

See Also:

Constant Field Values

DEFAULT_FAST_QUERY_SIZE

public static final boolean DEFAULT_FAST_QUERY_SIZE

Constructor Detail

QueryEngineSettings

public QueryEngineSettings()

QueryEngineSettings

public QueryEngineSettings(StatisticsProvider statisticsProvider)

Method Detail

getLimitInMemory

public long getLimitInMemory()

Description copied from interface: QueryEngineSettingsMBean

Get the limit on how many nodes a query may read at most into memory, for "order by" and "distinct" queries. If this limit is exceeded, the query throws an exception.

Specified by:

getLimitInMemory in interface QueryEngineSettingsMBean

Specified by:

getLimitInMemory in interface QueryLimits

Returns:

the limit

setLimitInMemory

public void setLimitInMemory(long limitInMemory)

Description copied from interface: QueryEngineSettingsMBean

Change the limit.

Specified by:

setLimitInMemory in interface QueryEngineSettingsMBean

Parameters:

limitInMemory - the new limit

getLimitReads

public long getLimitReads()

Description copied from interface: QueryEngineSettingsMBean

Get the limit on how many nodes a query may read at most (raw read operations, including skipped nodes). If this limit is exceeded, the query throws an exception.

Specified by:

getLimitReads in interface QueryEngineSettingsMBean

Specified by:

getLimitReads in interface QueryLimits

Returns:

the limit

setLimitReads

public void setLimitReads(long limitReads)

Description copied from interface: QueryEngineSettingsMBean

Change the limit.

Specified by:

setLimitReads in interface QueryEngineSettingsMBean

Parameters:

limitReads - the new limit

getFailTraversal

public boolean getFailTraversal()

Description copied from interface: QueryEngineSettingsMBean

Whether queries that don't use an index will fail (throw an exception). The default is false.

Specified by:

getFailTraversal in interface QueryEngineSettingsMBean

Specified by:

getFailTraversal in interface QueryLimits

Returns:

true if they fail

setFailTraversal

public void setFailTraversal(boolean failTraversal)

Description copied from interface: QueryEngineSettingsMBean

Set whether queries that don't use an index will fail (throw an exception).

Specified by:

setFailTraversal in interface QueryEngineSettingsMBean

Parameters:

failTraversal - the new value for this setting

isFastQuerySize

public boolean isFastQuerySize()

Description copied from interface: QueryEngineSettingsMBean

Whether the query result size should return an estimation for large queries.

Specified by:

isFastQuerySize in interface QueryEngineSettingsMBean

Returns:

true if enabled

setFastQuerySize

public void setFastQuerySize(boolean fastQuerySize)

Specified by:

setFastQuerySize in interface QueryEngineSettingsMBean

setFullTextComparisonWithoutIndex

public void setFullTextComparisonWithoutIndex(boolean fullTextComparisonWithoutIndex)

getFullTextComparisonWithoutIndex

public boolean getFullTextComparisonWithoutIndex()

Specified by:

getFullTextComparisonWithoutIndex in interface QueryLimits

isSql2Optimisation

public boolean isSql2Optimisation()

getQueryStats

public QueryStatsMBean getQueryStats()

getQueryStatsReporter

public QueryStatsReporter getQueryStatsReporter()

getStatisticsProvider

public StatisticsProvider getStatisticsProvider()

setQueryValidatorPattern

public void setQueryValidatorPattern(String key,
                                     String pattern,
                                     String comment,
                                     boolean failQuery)

Description copied from interface: QueryEngineSettingsMBean

Set or remove a query validator pattern.

Specified by:

setQueryValidatorPattern in interface QueryEngineSettingsMBean

Parameters:

key - the key

pattern - the regular expression pattern (empty to remove the pattern)

comment - a comment

failQuery - whether matching queries should fail (true) or just log a warning (false)

getQueryValidatorJson

public String getQueryValidatorJson()

Specified by:

getQueryValidatorJson in interface QueryEngineSettingsMBean

getQueryValidator

public QueryValidator getQueryValidator()

toString

public String toString()

Overrides:

toString in class Object