Tatsuhiko Miyagawa > Plack-0.9938 > Plack::Middleware::HTTPExceptions

Download:
Plack-0.9938.tar.gz

Dependencies

Annotate this POD

CPAN RT

New  1
Open  1
View/Report Bugs
Source   Latest Release: Plack-1.0032

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.

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

syntax highlighting: