org.elasticsearch.rest

Class BaseRestHandler

java.lang.Object

org.elasticsearch.common.component.AbstractComponent

org.elasticsearch.rest.BaseRestHandler

All Implemented Interfaces:

RestHandler

Direct Known Subclasses:

AbstractCatAction, RestAnalyzeAction, RestBulkAction, RestCancelTasksAction, RestCatAction, RestClearIndicesCacheAction, RestClearScrollAction, RestCloseIndexAction, RestClusterAllocationExplainAction, RestClusterGetSettingsAction, RestClusterHealthAction, RestClusterRerouteAction, RestClusterSearchShardsAction, RestClusterStateAction, RestClusterStatsAction, RestClusterUpdateSettingsAction, RestCountAction, RestCreateIndexAction, RestCreateSnapshotAction, RestDeleteAction, RestDeleteIndexAction, RestDeleteIndexTemplateAction, RestDeletePipelineAction, RestDeleteRepositoryAction, RestDeleteSnapshotAction, RestDeleteStoredScriptAction, RestExplainAction, RestFieldCapabilitiesAction, RestFieldStatsAction, RestFlushAction, RestForceMergeAction, RestGetAction, RestGetAliasesAction, RestGetFieldMappingAction, RestGetIndexTemplateAction, RestGetIndicesAction, RestGetMappingAction, RestGetPipelineAction, RestGetRepositoriesAction, RestGetSettingsAction, RestGetSnapshotsAction, RestGetSourceAction, RestGetStoredScriptAction, RestGetTaskAction, RestIndexAction, RestIndexDeleteAliasesAction, RestIndexPutAliasAction, RestIndicesAliasesAction, RestIndicesSegmentsAction, RestIndicesShardStoresAction, RestIndicesStatsAction, RestListTasksAction, RestMainAction, RestMultiGetAction, RestMultiSearchAction, RestMultiTermVectorsAction, RestNodesHotThreadsAction, RestNodesInfoAction, RestNodesStatsAction, RestOpenIndexAction, RestPendingClusterTasksAction, RestPutIndexTemplateAction, RestPutMappingAction, RestPutPipelineAction, RestPutRepositoryAction, RestPutStoredScriptAction, RestRecoveryAction, RestRefreshAction, RestRemoteClusterInfoAction, RestRestoreSnapshotAction, RestRolloverIndexAction, RestSearchAction, RestSearchScrollAction, RestShrinkIndexAction, RestSimulatePipelineAction, RestSnapshotsStatusAction, RestSuggestAction, RestSyncedFlushAction, RestTermVectorsAction, RestUpdateAction, RestUpdateSettingsAction, RestUpgradeAction, RestValidateQueryAction, RestVerifyRepositoryAction

public abstract class BaseRestHandler
extends AbstractComponent
implements RestHandler

Base handler for REST requests.

This handler makes sure that the headers & context of the handled requests are copied over to the transport requests executed by the associated client. While the context is fully copied over, not all the headers are copied, but a selected few. It is possible to control what headers are copied over by returning them in ActionPlugin.getRestHeaders().

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
protected static interface	BaseRestHandler.RestChannelConsumer REST requests are handled by preparing a channel consumer that represents the execution of the request against a channel.

Field Summary

Fields

Modifier and Type	Field and Description
static Setting<java.lang.Boolean>	MULTI_ALLOW_EXPLICIT_INDEX

Fields inherited from class org.elasticsearch.common.component.AbstractComponent

deprecationLogger, logger, settings

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	BaseRestHandler(Settings settings)

Method Summary

Modifier and Type	Method and Description
void	handleRequest(RestRequest request, RestChannel channel, NodeClient client) Handles a rest request.
protected abstract BaseRestHandler.RestChannelConsumer	prepareRequest(RestRequest request, NodeClient client) Prepare the request for execution.
protected java.util.Set<java.lang.String>	responseParams() Parameters used for controlling the response and thus might not be consumed during preparation of the request execution in prepareRequest(RestRequest, NodeClient).
protected java.lang.String	unrecognized(RestRequest request, java.util.Set<java.lang.String> invalids, java.util.Set<java.lang.String> candidates, java.lang.String detail)

Methods inherited from class org.elasticsearch.common.component.AbstractComponent

logDeprecatedSetting, logRemovedSetting, nodeName

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.elasticsearch.rest.RestHandler

canTripCircuitBreaker, supportsContentStream, supportsPlainText

Field Detail

MULTI_ALLOW_EXPLICIT_INDEX

public static final Setting<java.lang.Boolean> MULTI_ALLOW_EXPLICIT_INDEX

Constructor Detail

BaseRestHandler

protected BaseRestHandler(Settings settings)

Method Detail

handleRequest

public final void handleRequest(RestRequest request,
                                RestChannel channel,
                                NodeClient client)
                         throws java.lang.Exception

Description copied from interface: RestHandler

Handles a rest request.

Specified by:

handleRequest in interface RestHandler

Parameters:

request - The request to handle

channel - The channel to write the request response to

client - A client to use to make internal requests on behalf of the original request

Throws:

java.lang.Exception

unrecognized

protected final java.lang.String unrecognized(RestRequest request,
                                              java.util.Set<java.lang.String> invalids,
                                              java.util.Set<java.lang.String> candidates,
                                              java.lang.String detail)

prepareRequest

protected abstract BaseRestHandler.RestChannelConsumer prepareRequest(RestRequest request,
                                                                      NodeClient client)
                                                               throws java.io.IOException

Prepare the request for execution. Implementations should consume all request params before returning the runnable for actual execution. Unconsumed params will immediately terminate execution of the request. However, some params are only used in processing the response; implementations can override responseParams() to indicate such params.

Parameters:

request - the request to execute

client - client for executing actions on the local node

Returns:

the action to execute

Throws:

java.io.IOException - if an I/O exception occurred parsing the request and preparing for execution

responseParams

protected java.util.Set<java.lang.String> responseParams()

Parameters used for controlling the response and thus might not be consumed during preparation of the request execution in prepareRequest(RestRequest, NodeClient).

Returns:

a set of parameters used to control the response and thus should not trip strict URL parameter checks.