extractUnmatchedPath

Signature

def extractUnmatchedPath: Directive1[Uri.Path]

Description

Extracts the unmatched path from the request context.

The extractUnmatchedPath directive extracts the remaining path that was not yet matched by any of the PathDirectives (or any custom ones that change the unmatched path field of the request context). You can use it for building directives that handle complete suffixes of paths (like the getFromDirectory directives and similar ones).

Use mapUnmatchedPath to change the value of the unmatched path.

See also extractMatchedPath to see similar directive for matched path.

Example

Scala
val route =
  pathPrefix("abc") {
    extractUnmatchedPath { remaining =>
      complete(s"Unmatched: '$remaining'")
    }
  }

// tests:
Get("/abc") ~> route ~> check {
  responseAs[String] shouldEqual "Unmatched: ''"
}
Get("/abc/456") ~> route ~> check {
  responseAs[String] shouldEqual "Unmatched: '/456'"
}
Java
import static akka.http.javadsl.server.Directives.complete;
import static akka.http.javadsl.server.Directives.extractUnmatchedPath;

final Route route = pathPrefix("abc", () ->
  extractUnmatchedPath(remaining ->
    complete("Unmatched: '" + remaining + "'")
  )
);

// tests:
testRoute(route).run(HttpRequest.GET("/abc"))
  .assertEntity("Unmatched: ''");
testRoute(route).run(HttpRequest.GET("/abc/456"))
  .assertEntity("Unmatched: '/456'");
Found an error in this documentation? The source code for this page can be found here. Please feel free to edit and contribute a pull request.