NAME

Plack::Middleware::HTTPExceptions - Catch HTTP exceptions

SYNOPSIS

  use HTTP::Exception;

  my $app = sub {
      # ...
      HTTP::Exception::500->throw;
  };

  builder {
      enable "HTTPExceptions";
      $app;
  };

DESCRIPTION

Plack::Middleware::HTTPExceptions is a PSGI middleware component to catch exceptions from applicaitions that can be translated into HTTP status code.

Your application is supposed to throw an object that implements code method which returns the HTTP status code such as 501 or 404. This middleware catches them and creates a valid response out of the code.

The exception object may also implement as_string, or overload the stringification, to represent the text of the error, which defaults to the status message of error codes, such as Service Unavailable for 503.

If the code is in the 3xx range and the exception implements the 'location' method (HTTP::Exception::3xx does), the Location header will be set in the response, so you can do redirects this way.

There's a CPAN module HTTP::Exception and they are pefect to throw from your application to let this middleware catch and display, but you can also implement your own exception class to throw.

All the other errors that can't be translated into HTTP errors are just rethrown to the outer frame.

AUTHOR

Tatsuhiko Miyagawa

SEE ALSO

paste.httpexceptions HTTP::Exception