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()
default Action	createAction(Http.Request request, java.lang.reflect.Method actionMethod) Deprecated. Use ActionCreator instead.
HandlerForRequest	handlerForRequest(Http.RequestHeader request) Get a handler for the given request.
default Action	wrapAction(Action action) Deprecated. Use ActionCreator instead.

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

createAction

@Deprecated
default Action createAction(Http.Request request,
                                        java.lang.reflect.Method actionMethod)

Deprecated. Use ActionCreator instead.

Call to create the root Action of a request for a Java application. The request and actionMethod values are passed for information. Implementations of this method should create an instance of Action that invokes the injected action delegate.

Parameters:

request - The HTTP Request

actionMethod - The action method containing the user code for this Action.

Returns:

The default implementation returns a raw Action calling the method.

wrapAction

@Deprecated
default Action wrapAction(Action action)

Deprecated. Use ActionCreator instead.

Call to wrap the outer action of a Java application. This method is passed a fully composed action, allowing a last final global interceptor to be added to the action if required.

Parameters:

action - The action to wrap.

Returns:

A wrapped action.

asScala

default play.api.http.HttpRequestHandler asScala()

Returns:

a Scala HttpRequestHandler