extract

Signature

def extract[T](f: RequestContext 

Description

The extract directive is used as a building block for Custom Directives to extract data from the RequestContextRequestContext and provide it to the inner route. It is a special case for extracting one value of the more general textract directive that can be used to extract more than one value.

See Providing Values to Inner Routes for an overview of similar directives.

Example

Scala
sourceval uriLength = extract(_.request.uri.toString.length)
val route =
  uriLength { len =>
    complete(s"The length of the request URI is $len")
  }

// tests:
Get("/abcdef") ~> route ~> check {
  responseAs[String] shouldEqual "The length of the request URI is 25"
}
Java
sourceimport static org.apache.pekko.http.javadsl.server.Directives.extract;

final Route route =
    extract(
        ctx -> ctx.getRequest().getUri().toString().length(),
        len -> complete("The length of the request URI is " + len));

// tests:
testRoute(route)
    .run(HttpRequest.GET("/abcdef"))
    .assertEntity("The length of the request URI is 25");