Package com.google.gerrit.server.query.change

Class ChangeQueryProcessor

java.lang.Object

com.google.gerrit.index.query.QueryProcessor<ChangeData>

com.google.gerrit.server.query.change.ChangeQueryProcessor

All Implemented Interfaces:

PluginDefinedInfosFactory, DynamicOptions.BeanProvider, DynamicOptions.BeanReceiver

public class ChangeQueryProcessor
extends QueryProcessor<ChangeData>
implements DynamicOptions.BeanReceiver, DynamicOptions.BeanProvider, PluginDefinedInfosFactory

Query processor for the change index.

Instances are one-time-use. Other singleton classes should inject a Provider rather than holding on to a single instance.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
protected static class	ChangeQueryProcessor.ChangeQueryMetrics

Nested classes/interfaces inherited from class com.google.gerrit.index.query.QueryProcessor

QueryProcessor.Metrics

Field Summary

Fields inherited from class com.google.gerrit.index.query.QueryProcessor

start

Method Summary

Modifier and Type	Method	Description
protected QueryOptions	createOptions(IndexConfig indexConfig, int start, int pageSize, int pageSizeMultiplier, int limit, boolean allowIncompleteResults, Set<String> requestedFields)
com.google.common.collect.ImmutableListMultimap<Change.Id,PluginDefinedInfo>	createPluginDefinedInfos(Collection<ChangeData> cds)	Create a plugin-provided info field from all the plugins for each of the provided ChangeDatas.
ChangeQueryProcessor	enforceVisibility(boolean enforce)	Specify whether to enforce visibility by filtering out results that are not visible to the user.
protected Predicate<ChangeData>	enforceVisibility(Predicate<ChangeData> pred)	Invoked after the query was rewritten.
protected String	formatForLogging(ChangeData changeData)
DynamicOptions.DynamicBean	getDynamicBean(String plugin)
PluginDefinedInfosFactory	getInfosFactory()
protected int	getInitialPageSize(int limit)
void	setDynamicBean(String plugin, DynamicOptions.DynamicBean dynamicBean)

Methods inherited from class com.google.gerrit.index.query.QueryProcessor

getEffectiveLimit, getUserQueryLimit, isDisabled, query, query, setAllowIncompleteResults, setNoLimit, setRequestedFields, setStart, setUserProvidedLimit, setUserProvidedLimit

Methods inherited from class java.lang.Object

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

Methods inherited from interface com.google.gerrit.server.DynamicOptions.BeanReceiver

getExportedBeanReceiver

Method Details

enforceVisibility

public ChangeQueryProcessor enforceVisibility(boolean enforce)

Description copied from class: QueryProcessor

Specify whether to enforce visibility by filtering out results that are not visible to the user.

Enforcing visibility may have performance consequences, as the index system may need to post-filter a large number of results to fill even a modest limit.

If visibility is enforced, the user's queryLimit global capability is also used to bound the total number of results. If this capability is non-positive, this results in the entire query processor being disabled.

Overrides:

enforceVisibility in class QueryProcessor<ChangeData>

Parameters:

enforce - whether to enforce visibility.

Returns:

this.

createOptions

protected QueryOptions createOptions(IndexConfig indexConfig,
 int start,
 int pageSize,
 int pageSizeMultiplier,
 int limit,
 boolean allowIncompleteResults,
 Set<String> requestedFields)

Overrides:

createOptions in class QueryProcessor<ChangeData>

setDynamicBean

public void setDynamicBean(String plugin,
 DynamicOptions.DynamicBean dynamicBean)

Specified by:

setDynamicBean in interface DynamicOptions.BeanReceiver

getDynamicBean

public DynamicOptions.DynamicBean getDynamicBean(String plugin)

Specified by:

getDynamicBean in interface DynamicOptions.BeanProvider

getInfosFactory

public PluginDefinedInfosFactory getInfosFactory()

createPluginDefinedInfos

public com.google.common.collect.ImmutableListMultimap<Change.Id,PluginDefinedInfo> createPluginDefinedInfos(Collection<ChangeData> cds)

Description copied from interface: PluginDefinedInfosFactory

Create a plugin-provided info field from all the plugins for each of the provided ChangeDatas.

Specified by:

createPluginDefinedInfos in interface PluginDefinedInfosFactory

Parameters:

cds - changes.

Returns:

map of the all plugin's special infos for each change.

enforceVisibility

protected Predicate<ChangeData> enforceVisibility(Predicate<ChangeData> pred)

Description copied from class: QueryProcessor

Invoked after the query was rewritten. Subclasses must overwrite this method to filter out results that are not visible to the calling user.

Specified by:

enforceVisibility in class QueryProcessor<ChangeData>

Parameters:

pred - the query

Returns:

the modified query

formatForLogging

protected String formatForLogging(ChangeData changeData)

Specified by:

formatForLogging in class QueryProcessor<ChangeData>

getInitialPageSize

protected int getInitialPageSize(int limit)

Overrides:

getInitialPageSize in class QueryProcessor<ChangeData>