org.apache.solr.handler.component

Class SuggestComponent

java.lang.Object

org.apache.solr.handler.component.SearchComponent

org.apache.solr.handler.component.SuggestComponent

All Implemented Interfaces:

Accountable, SolrInfoBean, SolrMetricProducer, SuggesterParams, NamedListInitializedPlugin, SolrCoreAware

public class SuggestComponent
extends SearchComponent
implements SolrCoreAware, SuggesterParams, Accountable, SolrMetricProducer

SuggestComponent: interacts with multiple SolrSuggester to serve up suggestions Responsible for routing commands and queries to the appropriate SolrSuggester and for initializing them as specified by SolrConfig

Nested Class Summary

Nested classes/interfaces inherited from interface org.apache.solr.core.SolrInfoBean

SolrInfoBean.Category, SolrInfoBean.Group

Field Summary

Fields

Modifier and Type	Field and Description
static String	COMPONENT_NAME Name used to identify whether the user query concerns this component
protected NamedList	initParams
protected SolrMetricManager	metricManager
protected String	registryName
protected Map<String,SolrSuggester>	suggesters Key is the dictionary name used in SolrConfig, value is the corresponding SolrSuggester

Fields inherited from class org.apache.solr.handler.component.SearchComponent

metricNames, registry, standard_components

Fields inherited from interface org.apache.solr.spelling.suggest.SuggesterParams

SUGGEST_ALL_TERMS_REQUIRED, SUGGEST_BUILD, SUGGEST_BUILD_ALL, SUGGEST_CONTEXT_FILTER_QUERY, SUGGEST_COUNT, SUGGEST_DICT, SUGGEST_HIGHLIGHT, SUGGEST_PREFIX, SUGGEST_Q, SUGGEST_RELOAD, SUGGEST_RELOAD_ALL

Constructor Summary

Constructors

Constructor and Description
SuggestComponent()

Method Summary

Modifier and Type	Method and Description
int	distributedProcess(ResponseBuilder rb) Dispatch shard request in STAGE_EXECUTE_QUERY stage
void	finishStage(ResponseBuilder rb) Used in Distributed Search, merges the suggestion results from every shard
Collection<Accountable>	getChildResources()
String	getDescription() Simple one or two line description
void	inform(SolrCore core)
void	init(NamedList args)
void	initializeMetrics(SolrMetricManager manager, String registryName, String tag, String scope) Initializes metrics specific to this producer.
void	prepare(ResponseBuilder rb) Responsible for issuing build and rebuild command to the specified SolrSuggester
void	process(ResponseBuilder rb) Responsible for using the specified suggester to get the suggestions for the query and write the results
long	ramBytesUsed()

Methods inherited from class org.apache.solr.handler.component.SearchComponent

getCategory, getMetricNames, getMetricRegistry, getName, handleResponses, modifyRequest, setName

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.apache.solr.metrics.SolrMetricProducer

initializeMetrics

Methods inherited from interface org.apache.solr.core.SolrInfoBean

getMetricsSnapshot, registerMetricName

Field Detail

COMPONENT_NAME

public static final String COMPONENT_NAME

Name used to identify whether the user query concerns this component

See Also:

Constant Field Values

initParams

protected NamedList initParams

metricManager

protected SolrMetricManager metricManager

registryName

protected String registryName

suggesters

protected Map<String,SolrSuggester> suggesters

Key is the dictionary name used in SolrConfig, value is the corresponding SolrSuggester

Constructor Detail

SuggestComponent

public SuggestComponent()

Method Detail

init

public void init(NamedList args)

Specified by:

init in interface NamedListInitializedPlugin

Overrides:

init in class SearchComponent

inform

public void inform(SolrCore core)

Specified by:

inform in interface SolrCoreAware

prepare

public void prepare(ResponseBuilder rb)
             throws IOException

Responsible for issuing build and rebuild command to the specified SolrSuggester

Specified by:

prepare in class SearchComponent

Parameters:

rb - The ResponseBuilder

Throws:

IOException - If there is a low-level I/O error.

distributedProcess

public int distributedProcess(ResponseBuilder rb)

Dispatch shard request in STAGE_EXECUTE_QUERY stage

Overrides:

distributedProcess in class SearchComponent

Returns:

the next stage for this component

process

public void process(ResponseBuilder rb)
             throws IOException

Responsible for using the specified suggester to get the suggestions for the query and write the results

Specified by:

process in class SearchComponent

Parameters:

rb - The ResponseBuilder

Throws:

IOException - If there is a low-level I/O error.

finishStage

public void finishStage(ResponseBuilder rb)

Used in Distributed Search, merges the suggestion results from every shard

Overrides:

finishStage in class SearchComponent

getDescription

public String getDescription()

Description copied from interface: SolrInfoBean

Simple one or two line description

Specified by:

getDescription in interface SolrInfoBean

Specified by:

getDescription in class SearchComponent

initializeMetrics

public void initializeMetrics(SolrMetricManager manager,
                              String registryName,
                              String tag,
                              String scope)

Description copied from interface: SolrMetricProducer

Initializes metrics specific to this producer.

Note: for back-compatibility this method by default calls SolrMetricProducer.initializeMetrics(SolrMetricManager, String, String).

Specified by:

initializeMetrics in interface SolrMetricProducer

Parameters:

manager - an instance of SolrMetricManager

registryName - registry name where metrics are registered

tag - symbolic tag that represents a group of related instances that have the same life-cycle. Parent component can use the tag when calling SolrMetricManager.unregisterGauges(String, String) to unregister metrics created by this instance of the producer.

scope - scope of the metrics (eg. handler name) to separate metrics of instances of the same component executing in different contexts

ramBytesUsed

public long ramBytesUsed()

Specified by:

ramBytesUsed in interface Accountable

getChildResources

public Collection<Accountable> getChildResources()

Specified by:

getChildResources in interface Accountable