| alwaysCache |
Wraps its inner Route with caching support using a given cache instance, ignores
request Cache-Control headers |
| anyParam |
Extracts a parameter either from a form field or from query parameters (in that
order), rejects if no form field of query param of the given name can be found |
| anyParams |
Same as anyParam, except for several parameters at once |
| authenticate |
Tries to authenticate the user with a given authenticator and either extract a
an object representing the user context or rejects |
| authorize |
Applies a given authorization check to the request and rejects if it doesn’t pass |
| autoChunk |
Converts non-rejected responses from its inner Route to chunked responses using a
given chunk size |
| autoChunkFileBytes |
Converts non-rejected responses from its inner Route to chunked responses using a
given chunk size, if the response entity contains HttpData.FileBytes |
| cache |
Wraps its inner Route with caching support using a given cache instance |
| cachingProhibited |
Rejects the request if it doesn’t contain a Cache-Control header with
no-cache or max-age=0 |
| cancelAllRejections |
Adds a TransformationRejection to rejections from its inner Route, which
cancels other rejections according to a predicate function |
| cancelRejection |
Adds a TransformationRejection cancelling all rejections equal to a given one |
| clientIP |
Extracts the IP address of the client from either the X-Forwarded-For,
Remote-Address or X-Real-IP request header |
| complete |
Completes the request with a given response, several overloads |
| compressResponse |
Compresses responses coming back from its inner Route using either Gzip or
Deflate unless the request explicitly sets Accept-Encoding to identity. |
| compressResponseIfRequested |
Compresses responses coming back from its inner Route using either Gzip or
Deflate, but only when the request explicitly accepts one of them. |
| conditional |
Depending on the given ETag and Last-Modified values responds with
304 Not Modified if the request comes with the respective conditional headers. |
| cookie |
Extracts an HttpCookie with a given name or rejects if no such cookie is
present in the request |
| decodeRequest |
Decompresses incoming requests using a given Decoder |
| decompressRequest |
Decompresses incoming requests using either Gzip, Deflate, or NoEncoding |
| delete |
Rejects all non-DELETE requests |
| deleteCookie |
Adds a Set-Cookie header expiring the given cookie to all HttpResponse
replies of its inner Route |
| detach |
Executes its inner Route in a Future |
| dynamic |
Rebuilds its inner Route for every request anew |
| dynamicIf |
Conditionally rebuilds its inner Route for every request anew |
| encodeResponse |
Compresses responses coming back from its inner Route using a given Encoder |
| entity |
Unmarshalls the requests entity according to a given definition, rejects in
case of problems |
| extract |
Extracts a single value from the RequestContext using a function
RequestContext => T |
| failWith |
Bubbles the given error up the response chain, where it is dealt with by the
closest handleExceptions directive and its ExceptionHandler |
| formField |
Extracts the value of an HTTP form field, rejects if the request doesn’t come
with a field matching the definition |
| formFields |
Same as formField, except for several fields at once |
| get |
Rejects all non-GET requests |
| getFromBrowseableDirectories |
Same as getFromBrowseableDirectory, but allows for serving the “union”
of several directories as one single “virtual” one |
| getFromBrowseableDirectory |
Completes GET requests with the content of a file underneath a given directory,
renders directory contents as browsable listings |
| getFromDirectory |
Completes GET requests with the content of a file underneath a given directory |
| getFromFile |
Completes GET requests with the content of a given file |
| getFromResource |
Completes GET requests with the content of a given resource |
| getFromResourceDirectory |
Same as getFromDirectory except that the file is not fetched from the
file system but rather from a “resource directory” |
| handleExceptions |
Converts exceptions thrown during evaluation of its inner Route into
HttpResponse replies using a given ExceptionHandler |
| handleRejections |
Converts rejections produced by its inner Route into HttpResponse replies
using a given RejectionHandler |
| handleWith |
Completes the request using a given function. Uses the in-scope Unmarshaller
and Marshaller for converting to and from the function |
| head |
Rejects all non-HEAD requests |
| headerValue |
Extracts an HTTP header value using a given function, rejects if no value can
be extracted |
| headerValueByName |
Extracts an HTTP header value by selecting a header by name |
| headerValueByType |
Extracts an HTTP header value by selecting a header by type |
| headerValuePF |
Same as headerValue, but with a PartialFunction |
| hextract |
Extracts an HList of values from the RequestContext using a function |
| host |
Rejects all requests with a hostname different from a given definition,
can extract the hostname using a regex pattern |
| hostName |
Extracts the hostname part of the requests Host header value |
| hprovide |
Injects an HList of values into a directive, which provides them as
extractions |
| jsonpWithParameter |
Wraps its inner Route with JSONP support |
| listDirectoryContents |
Completes GET requests with a unified listing of the contents of one or more
given directories |
| logRequest |
Produces a log entry for every incoming request |
| logRequestResponse |
Produces a log entry for every response or rejection coming back from its inner
route, allowing for coalescing with the corresponding request |
| logResponse |
Produces a log entry for every response or rejection coming back from its inner
route |
| mapHttpResponse |
Transforms the HttpResponse coming back from its inner Route |
| mapHttpResponsePart |
More general than mapHttpResponse, transforms the HttpResponsePart
coming back from its inner Route |
| mapHttpResponseEntity |
Transforms the entity of the HttpResponse coming back from its inner Route |
| mapHttpResponseHeaders |
Transforms the headers of the HttpResponse coming back from its inner Route |
| mapInnerRoute |
Transforms its inner Route with a Route => Route function |
| mapRejections |
Transforms all rejections coming back from its inner Route |
| mapRequest |
Transforms the incoming HttpRequest |
| mapRequestContext |
Transforms the RequestContext |
| mapRouteResponse |
Transforms all responses coming back from its inner Route with a Any => Any
function |
| mapRouteResponsePF |
Same as mapRouteResponse, but with a PartialFunction |
| method |
Rejects if the request method does not match a given one |
| overrideMethodWithParameter |
Changes the HTTP method of the request to the value of the specified query string
parameter |
| noop |
Does nothing, i.e. passes the RequestContext unchanged to its inner Route |
| onComplete |
“Unwraps” a Future[T] and runs its inner route after future completion with
the future’s value as an extraction of type Try[T] |
| onFailure |
“Unwraps” a Future[T] and runs its inner route when the future has failed
with the future’s failure exception as an extraction of type Throwable |
| onSuccess |
“Unwraps” a Future[T] and runs its inner route after future completion with
the future’s value as an extraction of type T |
| optionalAuthenticate |
Tries to authenticate the user with a given authenticator and either extract a
an object representing the user context, extract None, or rejects |
| optionalCookie |
Extracts an HttpCookie with a given name, if the cookie is not present in the
request extracts None |
| optionalHeaderValue |
Extracts an optional HTTP header value using a given function |
| optionalHeaderValueByName |
Extracts an optional HTTP header value by selecting a header by name |
| optionalHeaderValueByType |
Extracts an optional HTTP header value by selecting a header by type |
| optionalHeaderValuePF |
Extracts an optional HTTP header value using a given partial function |
| options |
Rejects all non-OPTIONS requests |
| parameter |
Extracts the value of a request query parameter, rejects if the request doesn’t
come with a parameter matching the definition |
| parameterMap |
Extracts the requests query parameters as a Map[String, String] |
| parameterMultiMap |
Extracts the requests query parameters as a Map[String, List[String]] |
| parameters |
Same as parameter, except for several parameters at once |
| parameterSeq |
Extracts the requests query parameters as a Seq[(String, String)] |
| pass |
Alias for noop |
| patch |
Rejects all non-PATCH requests |
| path |
Extracts zero+ values from the unmatchedPath of the RequestContext
according to a given PathMatcher, rejects if no match |
| pathEnd |
Only passes on the request to its inner route if the request path has been
matched completely, rejects otherwise |
| pathEndOrSingleSlash |
Only passes on the request to its inner route if the request path has been matched
completely or only consists of exactly one remaining slash, rejects otherwise |
| pathPrefix |
Same as path, but also matches (and consumes) prefixes of the unmatched
path (rather than only the complete unmatched path at once) |
| pathPrefixTest |
Like pathPrefix but without “consumption” of the matched path (prefix). |
| pathSingleSlash |
Only passes on the request to its inner route if the request path consists of
exactly one remaining slash |
| pathSuffix |
Like as pathPrefix, but for suffixes rather than prefixed of the
unmatched path |
| pathSuffixTest |
Like pathSuffix but without “consumption” of the matched path (suffix). |
| post |
Rejects all non-POST requests |
| produce |
Uses the in-scope marshaller to extract a function that can be used for
completing the request with an instance of a custom type |
| provide |
Injects a single value into a directive, which provides it as an extraction |
| put |
Rejects all non-PUT requests |
| rawPathPrefix |
Applies a given PathMatcher directly to the unmatched path of the
RequestContext, i.e. without implicitly consuming a leading slash |
| rawPathPrefixTest |
Checks whether the unmatchedPath of the RequestContext has a prefix matched
by a PathMatcher |
| redirect |
Completes the request with redirection response of the given type to a given URI |
| reject |
Rejects the request with a given set of rejections |
| rejectEmptyResponse |
Converts responses with an empty entity into a rejection |
| requestEncodedWith |
Rejects the request if its encoding doesn’t match a given one |
| requestEntityEmpty |
Rejects the request if its entity is not empty |
| requestEntityPresent |
Rejects the request if its entity is empty |
| requestInstance |
Extracts the complete request |
| requestUri |
Extracts the complete request URI |
| respondWithHeader |
Adds a given response header to all HttpResponse replies from its inner
Route |
| respondWithHeaders |
Same as respondWithHeader, but for several headers at once |
| respondWithLastModifiedHeader |
Adds a Last-Modified header to all HttpResponse replies from its inner
Route |
| respondWithMediaType |
Overrides the media-type of all HttpResponse replies from its inner Route,
rejects if the media-type is not accepted by the client |
| respondWithSingletonHeader |
Adds a given response header to all HttpResponse replies from its inner
Route, if a header with the same name is not yet present |
| respondWithSingletonHeaders |
Same as respondWithSingletonHeader, but for several headers at once |
| respondWithStatus |
Overrides the response status of all HttpResponse replies coming back from
its inner Route |
| responseEncodingAccepted |
Rejects the request if the client doesn’t accept a given encoding for the
response |
| rewriteUnmatchedPath |
Transforms the unmatchedPath of the RequestContext using a given function |
| routeRouteResponse |
Chains a partial function into the response chain, which, for certain responses
from its inner route, produces another route that is to be applied instead |
| scheme |
Rejects a request if its Uri scheme does not match a given one |
| schemeName |
Extracts the request Uri scheme |
| setCookie |
Adds a Set-Cookie header to all HttpResponse replies of its inner Route |
| unmatchedPath |
Extracts the unmatched path from the RequestContext |
| validate |
Passes or rejects the request depending on evaluation of a given conditional
expression |
| withRangeSupport |
Transforms the response from its inner route into a 206 Partial Content
response if the client requested only part of the resource with a Range header. |