head

Matches requests with HTTP method HEAD.

Signature

def head: Directive0 

Description

This directive filters the incoming request by its HTTP method. Only requests with method HEAD are passed on to the inner route. All others are rejected with a MethodRejection, which is translated into a 405 Method Not Allowed response by the default RejectionHandler.

Note

By default, spray-can handles HEAD-requests transparently by dispatching a GET-request to the handler and stripping of the result body. See the spray.can.server.transparent-head-requests setting for how to disable this behavior.

Example

val route = head { complete("This is a HEAD request.") }

Head("/") ~> route ~> check {
  responseAs[String] === "This is a HEAD request."
}