module Roda::RodaPlugins::InvalidRequestBody

The invalid_request_body plugin allows for custom handling of invalid request bodies. Roda uses Rack for parsing request bodies, so by default, any invalid request bodies would result in Rack raising an exception, and the exception could change for different reasons the request body is invalid. This plugin overrides RodaRequest#POST (which parses parameters from request bodies), and if parsing raises an exception, it allows for custom behavior.

If you want to treat an invalid request body as the submission of no parameters, you can use the :empty_hash argument when loading the plugin:

plugin :invalid_request_body, :empty_hash

If you want to return a empty 400 (Bad Request) response if an invalid request body is submitted, you can use the :empty_400 argument when loading the plugin:

plugin :invalid_request_body, :empty_400

If you want to raise a Roda::RodaPlugins::InvalidRequestBody::Error exception if an invalid request body is submitted (which makes it easier to handle these exceptions when using the error_handler plugin), you can use the :raise argument when loading the plugin:

plugin :invalid_request_body, :raise

For custom behavior, you can pass a block when loading the plugin. The block is called with the exception Rack raised when parsing the body. The block will be used to define a method in the application’s RodaRequest class. It can either return a hash of parameters, or you can raise a different exception, or you can halt processing and return a response:

plugin :invalid_request_body do |exception|
  # To treat the exception raised as a submitted parameter
  {body_error: exception}
end