| authenticateBasic |
Wraps the inner route with Http Basic authentication support using a given Authenticator[T] |
| authenticateBasicAsync |
Wraps the inner route with Http Basic authentication support using a given AsyncAuthenticator[T] |
| authenticateBasicPF |
Wraps the inner route with Http Basic authentication support using a given AuthenticatorPF[T] |
| authenticateBasicPFAsync |
Wraps the inner route with Http Basic authentication support using a given AsyncAuthenticatorPF[T] |
| authenticateOAuth2 |
Wraps the inner route with OAuth Bearer Token authentication support using a given AuthenticatorPF[T] |
| authenticateOAuth2Async |
Wraps the inner route with OAuth Bearer Token authentication support using a given AsyncAuthenticator[T] |
| authenticateOAuth2PF |
Wraps the inner route with OAuth Bearer Token authentication support using a given AuthenticatorPF[T] |
| authenticateOAuth2PFAsync |
Wraps the inner route with OAuth Bearer Token authentication support using a given AsyncAuthenticatorPF[T] |
| authenticateOrRejectWithChallenge |
Lifts an authenticator function into a directive |
| authorize |
Applies the given authorization check to the request |
| authorizeAsync |
Applies the given asynchronous authorization check to the request |
| cancelRejection |
Adds a TransformationRejection cancelling all rejections equal to the given one to the rejections potentially coming back from the inner route. |
| cancelRejections |
Adds a TransformationRejection cancelling all matching rejections to the rejections potentially coming back from the inner route |
| checkSameOrigin |
Checks that the request comes from the same origin |
| complete |
Completes the request using the given arguments |
| completeOrRecoverWith |
“Unwraps” a Future[T] and runs the inner route when the future has failed with the error as an extraction of type Throwable |
| completeWith |
Uses the marshaller for a given type to extract a completion function |
| conditional |
Wraps its inner route with support for conditional requests as defined by http://tools.ietf.org/html/rfc7232 |
| cookie |
Extracts the HttpCookie with the given name |
| decodeRequest |
Decompresses the request if it is gzip or deflate compressed |
| decodeRequestWith |
Decodes the incoming request using one of the given decoders |
| delete |
Rejects all non-DELETE requests |
| deleteCookie |
Adds a Set-Cookie response header expiring the given cookies |
| encodeResponse |
Encodes the response with the encoding that is requested by the client via the Accept-Encoding header (NoCoding, Gzip and Deflate) |
| encodeResponseWith |
Encodes the response with the encoding that is requested by the client via the Accept-Encoding header (from a user-defined set) |
| entity |
Extracts the request entity unmarshalled to a given type |
| extract |
Extracts a single value using a RequestContext ⇒ T function |
| extractDataBytes |
Extracts the entities data bytes as a stream Source[ByteString, Any] |
| extractClientIP |
Extracts the client’s IP from either the X-Forwarded-, Remote-Address or X-Real-IP header |
| extractCredentials |
Extracts the potentially present HttpCredentials provided with the request’s Authorization header |
| extractExecutionContext |
Extracts the ExecutionContext from the RequestContext |
| extractMatchedPath |
Extracts the already matched path from the RequestContext |
| extractMaterializer |
Extracts the Materializer from the RequestContext |
| extractHost |
Extracts the hostname part of the Host request header value |
| extractLog |
Extracts the LoggingAdapter from the RequestContext |
| extractMethod |
Extracts the request method |
| extractOfferedWsProtocols |
Extract the list of websocket subprotocols offered by the client in the Sec-WebSocket-Protocol header if this is a websocket request and otherwise rejects with an ExpectedWebSocketRequestRejection |
| extractParserSettings |
Extracts the ParserSettings from the RequestContext |
| extractRequest |
Extracts the current HttpRequest instance |
| extractRequestContext |
Extracts the RequestContext itself |
| extractRequestEntity |
Extracts the RequestEntity from the RequestContext |
| extractScheme |
Extracts the URI scheme from the request |
| extractSettings |
Extracts the RoutingSettings from the RequestContext |
| extractUnmatchedPath |
Extracts the yet unmatched path from the RequestContext |
| extractUpgradeToWebSocket |
Extract the UpgradeToWebSocket header if existent and otherwise rejects with an ExpectedWebSocketRequestRejection |
| extractUri |
Extracts the complete request URI |
| failWith |
Bubbles the given error up the response chain where it is dealt with by the closest handleExceptions directive and its ExceptionHandler |
| fileUpload |
Provides a stream of an uploaded file from a multipart request |
| formField |
Extracts an HTTP form field from the request |
| formFieldMap |
Extracts a number of HTTP form field from the request as a Map[String, String] |
| formFieldMultiMap |
Extracts a number of HTTP form field from the request as a Map[String, List[String] |
| formFields |
Extracts a number of HTTP form field from the request |
| formFieldSeq |
Extracts a number of HTTP form field from the request as a Seq[(String, String)] |
| get |
Rejects all non-GET requests |
| getFromBrowseableDirectories |
Serves the content of the given directories as a file-system browser, i.e. files are sent and directories served as browseable listings |
| getFromBrowseableDirectory |
Serves the content of the given directory as a file-system browser, i.e. files are sent and directories served as browseable listings |
| getFromDirectory |
Completes GET requests with the content of a file underneath a given file-system directory |
| getFromFile |
Completes GET requests with the content of a given file |
| getFromResource |
Completes GET requests with the content of a given class-path resource |
| getFromResourceDirectory |
Completes GET requests with the content of a file underneath a given “class-path resource directory” |
| handleExceptions |
Transforms exceptions thrown during evaluation of the inner route using the given ExceptionHandler |
| handleRejections |
Transforms rejections produced by the inner route using the given RejectionHandler |
| handleWebSocketMessages |
Handles websocket requests with the given handler and rejects other requests with an ExpectedWebSocketRequestRejection |
| handleWebSocketMessagesForOptionalProtocol |
Handles websocket requests with the given handler if the subprotocol matches and rejects other requests. If the subprotocol parameter is None any WebSocket request is accepted.. |
| handleWebSocketMessagesForProtocol |
Handles websocket requests with the given handler if the subprotocol matches and rejects other requests with an ExpectedWebSocketRequestRejection or an UnsupportedWebSocketSubprotocolRejection. |
| handleWith |
Completes the request using a given function |
| head |
Rejects all non-HEAD requests |
| headerValue |
Extracts an HTTP header value using a given HttpHeader ⇒ Option[T] function |
| headerValueByName |
Extracts the value of the first HTTP request header with a given name |
| headerValueByType |
Extracts the first HTTP request header of the given type |
| headerValuePF |
Extracts an HTTP header value using a given PartialFunction[HttpHeader, T] |
| host |
Rejects all requests with a non-matching host name |
| ignoreTrailingSlash |
Retries the inner route adding (or removing) the trailing slash in case of empty rejections |
| listDirectoryContents |
Completes GET requests with a unified listing of the contents of all given file-system directories |
| logRequest |
Produces a log entry for every incoming request |
| logRequestResult |
Produces a log entry for every incoming request and RouteResult |
| logResult |
Produces a log entry for every RouteResult |
| mapInnerRoute |
Transforms its inner Route with a Route => Route function |
| mapRejections |
Transforms rejections from a previous route with an immutable.Seq[Rejection] ⇒ immutable.Seq[Rejection] function |
| mapRequest |
Transforms the request with an HttpRequest => HttpRequest function |
| mapRequestContext |
Transforms the RequestContext with a RequestContext => RequestContext function |
| mapResponse |
Transforms the response with an HttpResponse => HttpResponse function |
| mapResponseEntity |
Transforms the response entity with an ResponseEntity ⇒ ResponseEntity function |
| mapResponseHeaders |
Transforms the response headers with an immutable.Seq[HttpHeader] ⇒ immutable.Seq[HttpHeader] function |
| mapRouteResult |
Transforms the RouteResult with a RouteResult ⇒ RouteResult function |
| mapRouteResultFuture |
Transforms the RouteResult future with a Future[RouteResult] ⇒ Future[RouteResult] function |
| mapRouteResultPF |
Transforms the RouteResult with a PartialFunction[RouteResult, RouteResult] |
| mapRouteResultWith |
Transforms the RouteResult with a RouteResult ⇒ Future[RouteResult] function |
| mapRouteResultWithPF |
Transforms the RouteResult with a PartialFunction[RouteResult, Future[RouteResult]] |
| mapSettings |
Transforms the RoutingSettings with a RoutingSettings ⇒ RoutingSettings function |
| mapUnmatchedPath |
Transforms the unmatchedPath of the RequestContext using a Uri.Path ⇒ Uri.Path function |
| method |
Rejects all requests whose HTTP method does not match the given one |
| onComplete |
“Unwraps” a Future[T] and runs the inner route after future completion with the future’s value as an extraction of type Try[T] |
| onCompleteWithBreaker |
“Unwraps” a Future[T] inside a CircuitBreaker and runs the inner route after future completion with the future’s value as an extraction of type Try[T] |
| onSuccess |
“Unwraps” a Future[T] and runs the inner route after future completion with the future’s value as an extraction of type T |
| optionalCookie |
Extracts the HttpCookiePair with the given name as an Option[HttpCookiePair] |
| optionalHeaderValue |
Extracts an optional HTTP header value using a given HttpHeader ⇒ Option[T] function |
| optionalHeaderValueByName |
Extracts the value of the first optional HTTP request header with a given name |
| optionalHeaderValueByType |
Extracts the first optional HTTP request header of the given type |
| optionalHeaderValuePF |
Extracts an optional HTTP header value using a given PartialFunction[HttpHeader, T] |
| options |
Rejects all non-OPTIONS requests |
| overrideMethodWithParameter |
Changes the request method to the value of the specified query parameter |
| parameter |
Extracts a query parameter value from the request |
| parameterMap |
Extracts the request’s query parameters as a Map[String, String] |
| parameterMultiMap |
Extracts the request’s query parameters as a Map[String, List[String]] |
| parameters |
Extracts a number of query parameter values from the request |
| parameterSeq |
Extracts the request’s query parameters as a Seq[(String, String)] |
| pass |
Always simply passes the request on to its inner route, i.e. doesn’t do anything, neither with the request nor the response |
| patch |
Rejects all non-PATCH requests |
| path |
Applies the given PathMatcher to the remaining unmatched path after consuming a leading slash |
| pathEnd |
Only passes on the request to its inner route if the request path has been matched completely |
| 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 |
| pathPrefix |
Applies the given PathMatcher to a prefix of the remaining unmatched path after consuming a leading slash |
| pathPrefixTest |
Checks whether the unmatchedPath has a prefix matched by the given PathMatcher after implicitly consuming a leading slash |
| pathSingleSlash |
Only passes on the request to its inner route if the request path consists of exactly one remaining slash |
| pathSuffix |
Applies the given PathMatcher to a suffix of the remaining unmatched path (Caution: check scaladoc!) |
| pathSuffixTest |
Checks whether the unmatched path has a suffix matched by the given PathMatcher (Caution: check scaladoc!) |
| post |
Rejects all non-POST requests |
| provide |
Injects a given value into a directive |
| put |
Rejects all non-PUT requests |
| rawPathPrefix |
Applies the given matcher directly to a prefix of the unmatched path of the RequestContext, without implicitly consuming a leading slash |
| rawPathPrefixTest |
Checks whether the unmatchedPath has a prefix matched by the given PathMatcher |
| recoverRejections |
Transforms rejections from the inner route with an immutable.Seq[Rejection] ⇒ RouteResult function |
| recoverRejectionsWith |
Transforms rejections from the inner route with an immutable.Seq[Rejection] ⇒ Future[RouteResult] function |
| redirect |
Completes the request with redirection response of the given type to the given URI |
| redirectToNoTrailingSlashIfPresent |
If the request path ends with a slash, redirects to the same uri without trailing slash in the path |
| redirectToTrailingSlashIfMissing |
If the request path doesn’t end with a slash, redirects to the same uri with trailing slash in the path |
| reject |
Rejects the request with the given rejections |
| rejectEmptyResponse |
Converts responses with an empty entity into (empty) rejections |
| requestEncodedWith |
Rejects the request with an UnsupportedRequestEncodingRejection if its encoding doesn’t match the given one |
| requestEntityEmpty |
Rejects if the request entity is non-empty |
| requestEntityPresent |
Rejects with a RequestEntityExpectedRejection if the request entity is empty |
| respondWithDefaultHeader |
Adds a given response header if the response doesn’t already contain a header with the same name |
| respondWithDefaultHeaders |
Adds the subset of the given headers to the response which doesn’t already have a header with the respective name present in the response |
| respondWithHeader |
Unconditionally adds a given header to the outgoing response |
| respondWithHeaders |
Unconditionally adds the given headers to the outgoing response |
| responseEncodingAccepted |
Rejects the request with an UnacceptedResponseEncodingRejection if the given response encoding is not accepted by the client |
| scheme |
Rejects all requests whose URI scheme doesn’t match the given one |
| selectPreferredLanguage |
Inspects the request’s Accept-Language header and determines, which of a given set of language alternatives is preferred by the client |
| setCookie |
Adds a Set-Cookie response header with the given cookies |
| textract |
Extracts a number of values using a RequestContext ⇒ Tuple function |
| tprovide |
Injects a given tuple of values into a directive |
| uploadedFile |
Streams one uploaded file from a multipart request to a file on disk |
| validate |
Checks a given condition before running its inner route |
| withoutRequestTimeout |
Disables request timeouts for a given route. |
| withoutSizeLimit |
Skips request entity size check |
| withExecutionContext |
Runs its inner route with the given alternative ExecutionContext |
| withMaterializer |
Runs its inner route with the given alternative Materializer |
| withLog |
Runs its inner route with the given alternative LoggingAdapter |
| withPrecompressedMediaTypeSupport |
Adds a Content-Encoding: gzip response header if the entity’s media-type is precompressed with gzip header |
| withRangeSupport |
Adds Accept-Ranges: bytes to responses to GET requests, produces partial responses if the initial request contained a valid Range header |
| withRequestTimeout |
Configures the request timeouts for a given route. |
| withRequestTimeoutResponse |
Prepares the HttpResponse that is emitted if a request timeout is triggered. RequestContext => RequestContext function |
| withSettings |
Runs its inner route with the given alternative RoutingSettings |
| withSizeLimit |
Applies request entity size check |
