overrideMethodWithParameter

overrideMethodWithParameter

Changes the HTTP method of the request to the value of the specified query string parameter.

Description

If the query string parameter is not specified this directive has no effect. If the query string is specified as something that is not a HTTP method, then this directive completes the request with a 501 Not Implemented response.

This directive is useful for:

  • Use in combination with JSONP (JSONP only supports GET)
  • Supporting older browsers that lack support for certain HTTP methods. E.g. IE8 does not support PATCH

Example

final Route route = route(
    overrideMethodWithParameter("method", () -> 
      route(
        get(() -> complete("This looks like a GET request.")),
        post(() -> complete("This looks like a POST request."))
      )
    )
);


// tests:
testRoute(route).run(HttpRequest.GET("/?method=POST")).assertEntity(
    "This looks like a POST request.");

testRoute(route).run(HttpRequest.POST("/?method=get"))
    .assertEntity("This looks like a GET request.");

testRoute(route).run(HttpRequest.GET("/?method=hallo")).assertEntity(
    "The server either does not recognize the request method, or it lacks the ability to fulfill the request.");

Contents