Package org.elasticsearch.rest
Class BaseRestHandler.Wrapper
java.lang.Object
org.elasticsearch.rest.BaseRestHandler
org.elasticsearch.rest.BaseRestHandler.Wrapper
- All Implemented Interfaces:
RestHandler
- Enclosing class:
- BaseRestHandler
public static class BaseRestHandler.Wrapper extends BaseRestHandler
-
Nested Class Summary
Nested classes/interfaces inherited from class org.elasticsearch.rest.BaseRestHandler
BaseRestHandler.RestChannelConsumer, BaseRestHandler.WrapperNested classes/interfaces inherited from interface org.elasticsearch.rest.RestHandler
RestHandler.DeprecatedRoute, RestHandler.ReplacedRoute, RestHandler.Route -
Field Summary
Fields Modifier and Type Field Description protected BaseRestHandlerdelegateFields inherited from class org.elasticsearch.rest.BaseRestHandler
DEFAULT_INCLUDE_TYPE_NAME_POLICY, INCLUDE_TYPE_NAME_PARAMETER, logger, MULTI_ALLOW_EXPLICIT_INDEX -
Constructor Summary
Constructors Constructor Description Wrapper(BaseRestHandler delegate) -
Method Summary
Modifier and Type Method Description booleanallowsUnsafeBuffers()Indicates if the RestHandler supports working with pooled buffers.booleancanTripCircuitBreaker()java.util.List<RestHandler.DeprecatedRoute>deprecatedRoutes()A list of routes handled by this RestHandler that are deprecated and do not have a direct replacement.java.lang.StringgetName()protected BaseRestHandler.RestChannelConsumerprepareRequest(RestRequest request, NodeClient client)Prepare the request for execution.java.util.List<RestHandler.ReplacedRoute>replacedRoutes()A list of routes handled by this RestHandler that have had theirpathand/ormethodchanged.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 inBaseRestHandler.prepareRequest(RestRequest, NodeClient).java.util.List<RestHandler.Route>routes()The list ofRestHandler.Routes that this RestHandler is responsible for handling.booleansupportsContentStream()Indicates if the RestHandler supports content as a stream.Methods inherited from class org.elasticsearch.rest.BaseRestHandler
getUsageCount, handleRequest, unrecognized
-
Field Details
-
Constructor Details
-
Method Details
-
getName
public java.lang.String getName()- Specified by:
getNamein classBaseRestHandler- 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.
-
routes
Description copied from class:BaseRestHandlerThe list ofRestHandler.Routes that this RestHandler is responsible for handling.- Specified by:
routesin interfaceRestHandler- Specified by:
routesin classBaseRestHandler
-
deprecatedRoutes
Description copied from interface:RestHandlerA list of routes handled by this RestHandler that are deprecated and do not have a direct replacement. If changing thepathormethodof a route, useRestHandler.replacedRoutes(). -
replacedRoutes
Description copied from interface:RestHandlerA list of routes handled by this RestHandler that have had theirpathand/ormethodchanged. The pre-existingroutewill be registered as deprecated alongside the updatedroute. -
prepareRequest
protected BaseRestHandler.RestChannelConsumer prepareRequest(RestRequest request, NodeClient client) throws java.io.IOExceptionDescription copied from class:BaseRestHandlerPrepare 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 overrideBaseRestHandler.responseParams()to indicate such params.- Specified by:
prepareRequestin classBaseRestHandler- Parameters:
request- the request to executeclient- 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()Description copied from class:BaseRestHandlerParameters used for controlling the response and thus might not be consumed during preparation of the request execution inBaseRestHandler.prepareRequest(RestRequest, NodeClient).- Overrides:
responseParamsin classBaseRestHandler- Returns:
- a set of parameters used to control the response and thus should not trip strict URL parameter checks.
-
canTripCircuitBreaker
public boolean canTripCircuitBreaker() -
supportsContentStream
public boolean supportsContentStream()Description copied from interface:RestHandlerIndicates if the RestHandler supports content as a stream. A stream would be multiple objects delineated byXContent.streamSeparator(). If a handler returns true this will affect the types of content that can be sent to this endpoint. -
allowsUnsafeBuffers
public boolean allowsUnsafeBuffers()Description copied from interface:RestHandlerIndicates if the RestHandler supports working with pooled buffers. If the request handler will not escape the returnRestRequest.content()or any buffers extracted from it then there is no need to make a copies of any pooled buffers in theRestRequestinstance before passing a request to this handler. If this instance does not support pooled/unsafe buffersRestRequest.ensureSafeBuffers()should be called on any request before passing it toRestHandler.handleRequest(org.elasticsearch.rest.RestRequest, org.elasticsearch.rest.RestChannel, org.elasticsearch.client.node.NodeClient).- Returns:
- true iff the handler supports requests that make use of pooled buffers
-