Interface BasicDirectives

    • Method Detail

      • mapRequestContext

        Directive<scala.runtime.BoxedUnit> mapRequestContext​(scala.Function1<RequestContext,​RequestContext> f)
        Parameters:
        f - (undocumented)
        Returns:
        (undocumented)
      • mapRequest

        Directive<scala.runtime.BoxedUnit> mapRequest​(scala.Function1<HttpRequest,​HttpRequest> f)
        Parameters:
        f - (undocumented)
        Returns:
        (undocumented)
      • mapRouteResultFuture

        Directive<scala.runtime.BoxedUnit> mapRouteResultFuture​(scala.Function1<scala.concurrent.Future<RouteResult>,​scala.concurrent.Future<RouteResult>> f)
        Parameters:
        f - (undocumented)
        Returns:
        (undocumented)
      • mapRouteResult

        Directive<scala.runtime.BoxedUnit> mapRouteResult​(scala.Function1<RouteResult,​RouteResult> f)
        Parameters:
        f - (undocumented)
        Returns:
        (undocumented)
      • mapRouteResultWith

        Directive<scala.runtime.BoxedUnit> mapRouteResultWith​(scala.Function1<RouteResult,​scala.concurrent.Future<RouteResult>> f)
        Parameters:
        f - (undocumented)
        Returns:
        (undocumented)
      • mapRouteResultPF

        Directive<scala.runtime.BoxedUnit> mapRouteResultPF​(scala.PartialFunction<RouteResult,​RouteResult> f)
        Parameters:
        f - (undocumented)
        Returns:
        (undocumented)
      • mapRouteResultWithPF

        Directive<scala.runtime.BoxedUnit> mapRouteResultWithPF​(scala.PartialFunction<RouteResult,​scala.concurrent.Future<RouteResult>> f)
        Parameters:
        f - (undocumented)
        Returns:
        (undocumented)
      • recoverRejections

        Directive<scala.runtime.BoxedUnit> recoverRejections​(scala.Function1<scala.collection.immutable.Seq<Rejection>,​RouteResult> f)
        Parameters:
        f - (undocumented)
        Returns:
        (undocumented)
      • recoverRejectionsWith

        Directive<scala.runtime.BoxedUnit> recoverRejectionsWith​(scala.Function1<scala.collection.immutable.Seq<Rejection>,​scala.concurrent.Future<RouteResult>> f)
        Parameters:
        f - (undocumented)
        Returns:
        (undocumented)
      • mapRejections

        Directive<scala.runtime.BoxedUnit> mapRejections​(scala.Function1<scala.collection.immutable.Seq<Rejection>,​scala.collection.immutable.Seq<Rejection>> f)
        Parameters:
        f - (undocumented)
        Returns:
        (undocumented)
      • mapResponse

        Directive<scala.runtime.BoxedUnit> mapResponse​(scala.Function1<HttpResponse,​HttpResponse> f)
        Parameters:
        f - (undocumented)
        Returns:
        (undocumented)
      • mapResponseEntity

        Directive<scala.runtime.BoxedUnit> mapResponseEntity​(scala.Function1<ResponseEntity,​ResponseEntity> f)
        Parameters:
        f - (undocumented)
        Returns:
        (undocumented)
      • mapResponseHeaders

        Directive<scala.runtime.BoxedUnit> mapResponseHeaders​(scala.Function1<scala.collection.immutable.Seq<HttpHeader>,​scala.collection.immutable.Seq<HttpHeader>> f)
        Parameters:
        f - (undocumented)
        Returns:
        (undocumented)
      • pass

        Directive<scala.runtime.BoxedUnit> pass()
        A Directive0 that always passes the request on to its inner route (i.e. does nothing with the request or the response).

        Returns:
        (undocumented)
      • provide

        <T> Directive<scala.Tuple1<T>> provide​(T value)
        Injects the given value into a directive.

        Parameters:
        value - (undocumented)
        Returns:
        (undocumented)
      • tprovide

        <L> Directive<L> tprovide​(L values,
                                  Tuple<L> evidence$1)
        Injects the given values into a directive.

        Parameters:
        values - (undocumented)
        evidence$1 - (undocumented)
        Returns:
        (undocumented)
      • extract

        <T> Directive<scala.Tuple1<T>> extract​(scala.Function1<RequestContext,​T> f)
        Extracts a single value using the given function.

        Parameters:
        f - (undocumented)
        Returns:
        (undocumented)
      • textract

        <L> Directive<L> textract​(scala.Function1<RequestContext,​L> f,
                                  Tuple<L> evidence$2)
        Extracts a number of values using the given function.

        Parameters:
        f - (undocumented)
        evidence$2 - (undocumented)
        Returns:
        (undocumented)
      • cancelRejection

        Directive<scala.runtime.BoxedUnit> cancelRejection​(Rejection rejection)
        Adds a TransformationRejection cancelling all rejections equal to the given one to the list of rejections potentially coming back from the inner route.

        Parameters:
        rejection - (undocumented)
        Returns:
        (undocumented)
      • cancelRejections

        Directive<scala.runtime.BoxedUnit> cancelRejections​(scala.collection.immutable.Seq<java.lang.Class<?>> classes)
        Adds a TransformationRejection cancelling all rejections of one of the given classes to the list of rejections potentially coming back from the inner route.

        Parameters:
        classes - (undocumented)
        Returns:
        (undocumented)
      • cancelRejections

        Directive<scala.runtime.BoxedUnit> cancelRejections​(scala.Function1<Rejection,​java.lang.Object> cancelFilter)
        Adds a TransformationRejection cancelling all rejections for which the given filter function returns true to the list of rejections potentially coming back from the inner route.

        Parameters:
        cancelFilter - (undocumented)
        Returns:
        (undocumented)
      • mapUnmatchedPath

        Directive<scala.runtime.BoxedUnit> mapUnmatchedPath​(scala.Function1<Uri.Path,​Uri.Path> f)
        Transforms the unmatchedPath of the RequestContext using the given function.

        Parameters:
        f - (undocumented)
        Returns:
        (undocumented)
      • extractUnmatchedPath

        Directive<scala.Tuple1<Uri.Path>> extractUnmatchedPath()
        Extracts the yet unmatched path from the RequestContext.

        Returns:
        (undocumented)
      • extractMatchedPath

        Directive<scala.Tuple1<Uri.Path>> extractMatchedPath()
        Extracts the already matched path from the RequestContext.

        Returns:
        (undocumented)
      • extractRequest

        Directive<scala.Tuple1<HttpRequest>> extractRequest()
        Extracts the current HttpRequest instance.

        Returns:
        (undocumented)
      • extractUri

        Directive<scala.Tuple1<Uri>> extractUri()
        Extracts the complete request URI.

        Returns:
        (undocumented)
      • withExecutionContext

        Directive<scala.runtime.BoxedUnit> withExecutionContext​(scala.concurrent.ExecutionContextExecutor ec)
        Runs its inner route with the given alternative ExecutionContextExecutor.

        Parameters:
        ec - (undocumented)
        Returns:
        (undocumented)
      • extractExecutionContext

        Directive<scala.Tuple1<scala.concurrent.ExecutionContextExecutor>> extractExecutionContext()
        Extracts the ExecutionContextExecutor from the RequestContext.

        Returns:
        (undocumented)
      • withMaterializer

        Directive<scala.runtime.BoxedUnit> withMaterializer​(akka.stream.Materializer materializer)
        Runs its inner route with the given alternative Materializer.

        Parameters:
        materializer - (undocumented)
        Returns:
        (undocumented)
      • extractMaterializer

        Directive<scala.Tuple1<akka.stream.Materializer>> extractMaterializer()
        Extracts the Materializer from the RequestContext.

        Returns:
        (undocumented)
      • extractActorSystem

        Directive<scala.Tuple1<akka.actor.ActorSystem>> extractActorSystem()
        Extracts the ActorSystem if the available Materializer is an ActorMaterializer. Otherwise throws an exception as it won't be able to extract the system from arbitrary materializers.

        Returns:
        (undocumented)
      • withLog

        Directive<scala.runtime.BoxedUnit> withLog​(akka.event.LoggingAdapter log)
        Runs its inner route with the given alternative LoggingAdapter.

        Parameters:
        log - (undocumented)
        Returns:
        (undocumented)
      • extractLog

        Directive<scala.Tuple1<akka.event.LoggingAdapter>> extractLog()
        Extracts the LoggingAdapter from the RequestContext.

        Returns:
        (undocumented)
      • withSettings

        Directive<scala.runtime.BoxedUnit> withSettings​(RoutingSettings settings)
        Runs its inner route with the given alternative RoutingSettings.

        Parameters:
        settings - (undocumented)
        Returns:
        (undocumented)
      • mapSettings

        Directive<scala.runtime.BoxedUnit> mapSettings​(scala.Function1<RoutingSettings,​RoutingSettings> f)
        Runs the inner route with settings mapped by the given function.

        Parameters:
        f - (undocumented)
        Returns:
        (undocumented)
      • extractDataBytes

        Directive<scala.Tuple1<akka.stream.scaladsl.Source<akka.util.ByteString,​java.lang.Object>>> extractDataBytes()
        Extracts the entities dataBytes Source from the RequestContext.

        Returns:
        (undocumented)
      • extractStrictEntity

        Directive<scala.Tuple1<HttpEntity.Strict>> extractStrictEntity​(scala.concurrent.duration.FiniteDuration timeout)
        WARNING: This will read the entire request entity into memory and effectively disable streaming.

        To help protect against excessive memory use, the request will be aborted if the request is larger than allowed by the akka.http.parsing.max-to-strict-bytes configuration setting.

        Converts the HttpEntity from the RequestContext into an HttpEntity.Strict and extracts it, or fails the route if unable to drain the entire request body within the timeout.

        Parameters:
        timeout - The directive is failed if the stream isn't completed after the given timeout.
        Returns:
        (undocumented)
      • extractStrictEntity

        Directive<scala.Tuple1<HttpEntity.Strict>> extractStrictEntity​(scala.concurrent.duration.FiniteDuration timeout,
                                                                       long maxBytes)
        WARNING: This will read the entire request entity into memory and effectively disable streaming.

        To help protect against excessive memory use, the request will be aborted if the request is larger than allowed by the akka.http.parsing.max-to-strict-bytes configuration setting.

        Converts the HttpEntity from the RequestContext into an HttpEntity.Strict and extracts it, or fails the route if unable to drain the entire request body within the timeout.

        Parameters:
        timeout - The directive is failed if the stream isn't completed after the given timeout.
        maxBytes - (undocumented)
        Returns:
        (undocumented)
      • toStrictEntity

        Directive<scala.runtime.BoxedUnit> toStrictEntity​(scala.concurrent.duration.FiniteDuration timeout)
        WARNING: This will read the entire request entity into memory and effectively disable streaming.

        To help protect against excessive memory use, the request will be aborted if the request is larger than allowed by the akka.http.parsing.max-to-strict-bytes configuration setting.

        Extracts the RequestContext itself with the strict HTTP entity, or fails the route if unable to drain the entire request body within the timeout.

        Parameters:
        timeout - The directive is failed if the stream isn't completed after the given timeout.
        Returns:
        (undocumented)
      • toStrictEntity

        Directive<scala.runtime.BoxedUnit> toStrictEntity​(scala.concurrent.duration.FiniteDuration timeout,
                                                          long maxBytes)
        WARNING: This will read the entire request entity into memory and effectively disable streaming.

        To help protect against excessive memory use, the request will be aborted if the request is larger than allowed by the akka.http.parsing.max-to-strict-bytes configuration setting.

        Extracts the RequestContext itself with the strict HTTP entity, or fails the route if unable to drain the entire request body within the timeout.

        Parameters:
        timeout - The directive is failed if the stream isn't completed after the given timeout.
        maxBytes - (undocumented)
        Returns:
        (undocumented)