play.http

Interface HttpRequestHandler

All Known Implementing Classes:

DefaultHttpRequestHandler

public interface HttpRequestHandler

An HTTP request handler

Method Summary

Modifier and Type	Method and Description
default play.api.http.HttpRequestHandler	asScala()
HandlerForRequest	handlerForRequest(Http.RequestHeader request) Get a handler for the given request.

Method Detail

handlerForRequest

HandlerForRequest handlerForRequest(Http.RequestHeader request)

Get a handler for the given request.

In addition to retrieving a handler for the request, the request itself may be modified - typically it will be tagged with routing information. It is also acceptable to simply return the request as is. Play will switch to using the returned request from this point in in its request handling.

The reason why the API allows returning a modified request, rather than just wrapping the Handler in a new Handler that modifies the request, is so that Play can pass this request to other handlers, such as error handlers, or filters, and they will get the tagged/modified request.

Parameters:

request - The request to handle

Returns:

The possibly modified/tagged request, and a handler to handle it

asScala

default play.api.http.HttpRequestHandler asScala()

Returns:

a Scala HttpRequestHandler