head

Matches requests with HTTP method HEAD.

Signature

defhead: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 405MethodNotAllowed 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

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