A base implementation of the HttpRequestHandler that handles Scala actions. If you use Java actions in your application, you should override JavaCompatibleHttpRequestHandler; otherwise you can override this for your custom handler.
Technically, this is not the default request handler that Play uses, rather, the JavaCompatibleHttpRequestHandler is the default one, in order to provide support for Java actions.
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.
Value parameters
request
The request to handle
Attributes
Returns
The possibly modified/tagged request, and a handler to handle it
The default is to use the application router to find the appropriate action.
This method can be overridden if you want to provide some custom routing strategies, for example, using different routers based on various request parameters.
Value parameters
request
The request
Attributes
Returns
A handler to handle the request, if one can be found