Package org.elasticsearch.rest

Class BaseRestHandler

java.lang.Object

org.elasticsearch.rest.BaseRestHandler

All Implemented Interfaces:

RestHandler

Direct Known Subclasses:

AbstractCatAction, RestAddVotingConfigExclusionAction, RestAnalyzeAction, RestBulkAction, RestCancelTasksAction, RestCatAction, RestCleanupRepositoryAction, RestClearIndicesCacheAction, RestClearScrollAction, RestClearVotingConfigExclusionsAction, RestCloseIndexAction, RestClusterAllocationExplainAction, RestClusterGetSettingsAction, RestClusterHealthAction, RestClusterRerouteAction, RestClusterSearchShardsAction, RestClusterStateAction, RestClusterStatsAction, RestClusterUpdateSettingsAction, RestCountAction, RestCreateIndexAction, RestCreateSnapshotAction, RestDeleteAction, RestDeleteIndexAction, RestDeleteIndexTemplateAction, RestDeletePipelineAction, RestDeleteRepositoryAction, RestDeleteSnapshotAction, RestDeleteStoredScriptAction, RestExplainAction, RestFieldCapabilitiesAction, 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, RestNodesUsageAction, RestOpenIndexAction, RestPendingClusterTasksAction, RestPutIndexTemplateAction, RestPutMappingAction, RestPutPipelineAction, RestPutRepositoryAction, RestPutStoredScriptAction, RestRecoveryAction, RestRefreshAction, RestReloadSecureSettingsAction, RestRemoteClusterInfoAction, RestResizeHandler, RestRestoreSnapshotAction, RestRolloverIndexAction, RestSearchAction, RestSearchScrollAction, RestSimulatePipelineAction, RestSnapshotsStatusAction, RestSyncedFlushAction, RestTermVectorsAction, RestUpdateAction, RestUpdateSettingsAction, RestUpgradeAction, RestUpgradeStatusAction, RestValidateQueryAction, RestVerifyRepositoryAction

public abstract class BaseRestHandler
extends Object
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	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	Description
static boolean	DEFAULT_INCLUDE_TYPE_NAME_POLICY
static String	INCLUDE_TYPE_NAME_PARAMETER	Parameter that controls whether certain REST apis should include type names in their requests or responses.
protected org.apache.logging.log4j.Logger	logger	Deprecated. declare your own logger.
static Setting<Boolean>	MULTI_ALLOW_EXPLICIT_INDEX

Constructor Summary

Constructors

Constructor	Description
BaseRestHandler()

Method Summary

Modifier and Type	Method	Description
abstract String	getName()
long	getUsageCount()
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 Set<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 String	unrecognized(RestRequest request, Set<String> invalids, Set<String> candidates, String detail)

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

Field Detail

MULTI_ALLOW_EXPLICIT_INDEX

public static final Setting<Boolean> MULTI_ALLOW_EXPLICIT_INDEX

logger

@Deprecated
protected org.apache.logging.log4j.Logger logger

Deprecated.

declare your own logger.

INCLUDE_TYPE_NAME_PARAMETER

public static final String INCLUDE_TYPE_NAME_PARAMETER

Parameter that controls whether certain REST apis should include type names in their requests or responses. Note: Support for this parameter will be removed after the transition period to typeless APIs.

See Also:

Constant Field Values

DEFAULT_INCLUDE_TYPE_NAME_POLICY

public static final boolean DEFAULT_INCLUDE_TYPE_NAME_POLICY

See Also:

Constant Field Values

Constructor Detail

BaseRestHandler

public BaseRestHandler()

Method Detail

getUsageCount

public final long getUsageCount()

getName

public abstract String getName()

Returns:

the name of this handler. The name should be human readable and should describe the action that will performed when this API is called. This name is used in the response to the RestNodesUsageAction.

handleRequest

public final void handleRequest(RestRequest request,
                                RestChannel channel,
                                NodeClient client)
                         throws 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:

Exception

unrecognized

protected final String unrecognized(RestRequest request,
                                    Set<String> invalids,
                                    Set<String> candidates,
                                    String detail)

prepareRequest

protected abstract BaseRestHandler.RestChannelConsumer prepareRequest(RestRequest request,
                                                                      NodeClient client)
                                                               throws 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:

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

responseParams

protected Set<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.