optionalAttribute • Akka HTTP (original) (raw)

Signature

def optionalAttribute[T](key: AttributeKey[T]): Directive1[Option[T]]

Description

Optionally extracts the value of the request attribute with the given key.

The optionalAttribute directive is similar to the attribute directive but always extracts an Option Optional value instead of rejecting the request if no matching attribute could be found.

Example

Scala

source`val userId = AttributeKeyString

val route = optionalAttribute(userId) { case Some(userId) => complete(s"The user is $userId") case None => complete(s"No user was provided") } ~ // can also be written as: optionalAttribute(userId) { userId => complete { userId match { case Some(u) => s"The user is $u" case _ => "No user was provided" } } }

// tests: Get("/") ~> addAttribute(userId, "Joe42") ~> route ~> check { responseAs[String] shouldEqual "The user is Joe42" } Get("/") ~> Route.seal(route) ~> check { responseAs[String] shouldEqual "No user was provided" }`

Java

source`AttributeKey userId = AttributeKey.create("user-id", String.class);

final Route route = optionalAttribute(userId, id -> { if (id.isPresent()) { return complete("The user is " + id.get()); } else { return complete("No user was provided"); } });

// tests: testRoute(route).run(HttpRequest.GET("/").addAttribute(userId, "Joe42")) .assertEntity("The user is Joe42");

testRoute(route).run(HttpRequest.GET("/")).assertEntity("No user was provided");`

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.