Contentment::Exception(3)

NAME
Contentment::Exception - Used to throw exceptions in Contentment

SYNOPSIS
  use Contentment::Exception;

  # Throw a general exception...
  Contentment::Exception->throw(
      status  => 404,
      title   => 'Not Found',
      message => 'Couldn't find it.'
      details => 'Well, it's kind of a long story. First, I looked...',
  );

DESCRIPTION
Exceptions for Contentment based upon Exception::Class. In addition to the features of that class, it provides these additional fields:

status
    This is the HTTP status that the exception should result in if it propogates all the way to the top-level request. The default is 500.

title
    This is the title of the error. This defaults to the status code names found in RFC-2616. (These can be found at the W3C web site: <http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html>). A table of these is stored in the %Contentment::Exception::status_code_titles variable.

details
    This should be any additional debugging information that should be associated with the message, but not shown to general users.

location
    If the exception is set to use a 3xx status code (in particular, 301 Moved Permanently and 302 Found), this is the URI that the client should be resent to. If the exception reaches the top level.

AUTHOR
Andrew Sterling Hanenkamp, <hanenkamp@cpan.org>

LICENSE AND COPYRIGHT
Copyright 2005 Andrew Sterling Hanenkamp <hanenkamp@cpan.org>. All Rights Reserved.

This module is free software; you can redistribute it and/or modify it under the same terms as Perl itself. See perlartistic.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.