-
-
29 Jan 2020 21:03:12 UTC
- Distribution: Dancer
- Module version: 1.3513
- Source (raw)
- Browse (raw)
- Changes
- Homepage
- How to Contribute
- Repository
- Issues
- Testers (2854 / 18 / 0)
- Kwalitee
Bus factor: 4- 86.23% Coverage
- License: perl_5
- Activity
24 month- Tools
- Download (382.32KB)
- MetaCPAN Explorer
- Permissions
- Subscribe to distribution
- Permalinks
- This version
- Latest version
and 182 contributors- Dancer Core Developers
-
1nickt
-
a-adam
-
Achim Adam
-
Adam J. Foxson
-
Adam Kennedy
-
Akash Ayare
-
alambike
-
Alan Haggai Alavi
-
Alberto Simoes
-
Alessandro Ranellucci
-
Alex C
-
Alexis Sukrieh
-
Alex Kalderimis
-
Alex Kapranoff
-
Alex Peters
-
Alfie John
-
Al Newkirk
-
Andrew Beverley
-
andy
-
Anirvan Chatterjee
-
Anton Gerasimov
-
asergei
-
Ashley Willis
-
A. Sinan Unur
-
Ask Bjørn Hansen
-
Assaf Gordon
-
Ben Hutton
-
Bernhard Reutner-Fischer
-
boris shomodjvarac
-
Brad Macpherson
-
Breno G. de Oliveira
-
Brian E. Lozier
-
Brian Hann
-
Brian Phillips
-
burnersk
-
Chris Andrews
-
chrisjrob
-
Chris Seymour
-
Christian Walde
-
chromatic
-
Colin Keith
-
Colin Kuskie
-
CPAN Service
-
Craig Treptow
-
Dagfinn Ilmari Mannsåker
-
Damien Krotkine
-
Damyan Ivanov
-
Dan Book
-
Danijel Tasov
-
Dave Doyle
-
David Cantrell
-
David Golden
-
David Moreno
-
David Steinbrunner
-
David Zurborg
-
Dennis Lichtenthaeler
-
Duncan Hutty
-
Emmanuel Rodriguez
-
Fabrice Gabolde
-
Fayland Lam
-
Felix Dorner
-
Flavio Poletti
-
Florian Larysch
-
Florian Sojer
-
Franck Cuny
-
François Charlier
-
Gabor Szabo
-
Gary Mullen
-
geistteufel
-
Gil Magno
-
Gonzalo Barco
-
Graham Knop
-
Grzegorz Rożniecki
-
Hagen Fuchs
-
Hans Dieter Pearcey
-
Ilmari Vacklin
-
Ilya Chesnokov
-
isync
-
Ivan Bessarabov
-
Ivan Paponov
-
Jacob Rideout
-
Jakob Voss
-
James Aitken
-
jamhed
-
Jess
-
Jesse van Herk
-
Jochen Lutz
-
Joel Roth
-
John Barrett
-
John Wittkoski
-
jonasreinsch
-
Jonathan "Duke" Leto
-
Jonathan Hall
-
Jonathan Otsuka
-
jonathan schatz
-
Jonathan Scott Duff
-
Joshua Barratt
-
JT Smith
-
Juan J. Martínez
-
Jury Gorky
-
Kaitlyn Parkhurst
-
Kent Fredric
-
Kirk Kimmel
-
Lars Thegler
-
Lee Carmichael
-
Lee Johnson
-
Manuel Weiss
-
Marc Chantreux
-
Mark Allen
-
Mark A. Stratman
-
Mark Stosberg
-
Martin Schut
-
Matthew Horsfall (alh)
-
Maurice
-
Maxim Ivanov
-
Max Maischein
-
Michael Genereux
-
Michael G. Schwern
-
Michal Wojciechowski
-
Mikolaj Kucharski
-
miyagawa
-
mlbarrow
-
Mohammad S Anwar
-
Murray
-
Natal Ngétal
-
Nate Jones
-
Naveed Massjouni
-
Naveed
-
Naveen
-
Neil Hooey
-
Nick Tonkin
-
Nicolas Oudard
-
niko
-
Nuno Carvalho
-
Oliver Gorwits
-
Olivier Mengué
-
Olof Johansson
-
Ovid
-
Paul Driver
-
Paul Fenwick
-
Paul Johnson
-
Paul Tomlin
-
pdl
-
Pedro Melo
-
Perlover
-
Phil Carmody
-
Philippe Bruhat (BooK)
-
ppisar
-
Richard Simões
-
Rick Myers
-
Rik Brown
-
Roberto Patriarca
-
Roman Galeev
-
Roman Nuritdinov
-
Rowan Thorpe
-
Russell Jenkins
-
Sam Kington
-
Sapphire Paw
-
Sawyer X
-
scoopio
-
Scott Penrose
-
sdeseille
-
Sean Smith
-
Sebastian de Castelberg
-
Skeeve
-
Slaven Rezic
-
Sniperovitch
-
Squeeks
-
Stefan Hornburg (Racke)
-
Steve Hay
-
Tatsuhiko Miyagawa
-
tednolan
-
Tim King
-
Tom Heady
-
Tom Hukins
-
Tom Wyant
-
Vyacheslav Matyukhin
-
William Wolf
-
Yanick Champoux
- YOUR_NAME <YOUR_EMAIL>
-
Zefram
- Dependencies
- Carp
- Cwd
- Data::Dumper
- Encode
- Exporter
- Fcntl
- File::Basename
- File::Copy
- File::Path
- File::Spec
- File::Spec::Functions
- File::Temp
- File::stat
- FindBin
- Getopt::Long
- HTTP::Body
- HTTP::Date
- HTTP::Headers
- HTTP::Server::Simple::PSGI
- HTTP::Tiny
- Hash::Merge::Simple
- IO::File
- MIME::Types
- Module::Runtime
- POSIX
- Pod::Usage
- Scalar::Util
- Test::Builder
- Test::More
- Time::HiRes
- Try::Tiny
- URI
- URI::Escape
- base
- bytes
- constant
- lib
- overload
- parent
- strict
- vars
- warnings
- Reverse dependencies
- CPAN Testers List
- Dependency graph
NAME
Dancer::Exception - class for throwing and catching exceptions
VERSION
version 1.3513
SYNOPSIS
use Dancer::Exception qw(:all); register_exception('DataProblem', message_pattern => "test message : %s" ); sub do_stuff { raise DataProblem => "we've lost data!"; } try { do_stuff() } catch { # an exception was thrown my ($exception) = @_; if ($exception->does('DataProblem')) { # handle the data problem my $message = $exception->message(); } else { $exception->rethrow } };
DESCRIPTION
Dancer::Exception is based on Try::Tiny. You can try and catch exceptions, like in Try::Tiny.
Exceptions are objects, from subclasses of Dancer::Exception::Base.
However, for internal Dancer usage, we introduce a special class of exceptions, called Dancer::Continuation. Exceptions that are from this class are not caught with a
catch
block, but only with acontinuation
. That's a cheap way to implement a workflow interruption. Dancer users should ignore this feature.What it means for Dancer users
Users can throw and catch exceptions, using
try
andcatch
. They can reuse some Dancer core exceptions (Dancer::Exception::Base::*
), but they can also create new exception classes, and use them for their own means. That way it's easy to use custom exceptions in a Dancer application. Have a look atregister_exception
,raise
, and the methods in Dancer::Exception::Base.METHODS
try
Same as in Try::Tiny
catch
Same as in Try::Tiny. The exception can be retrieved as the first parameter:
try { ... } catch { my ($exception) = @_; };
continuation
To be used by Dancer developers only, in Dancer core code.
raise
# raise Dancer::Exception::Base::Custom raise Custom => "user $username is unknown"; # raise Dancer::Exception::Base::Custom::Frontend raise 'Custom::Frontend' => "user $username is unknown"; # same, raise Dancer::Exception::Base::Custom::Frontend raise custom_frontend => "user $username is unknown"; # raise My::Own::ExceptionSystem::Invalid::Login raise '+My::Own::ExceptionSystem::Invalid::Login' => "user $username is unknown";
raise provides an easy way to throw an exception. First parameter is the name of the exception class, without the
Dancer::Exception::
prefix. other parameters are stored as raising arguments in the exception. Usually the parameters is an exception message, but it's left to the exception class implementation.If the exception class name starts with a
+
, then theDancer::Exception::
won't be added. This allows one to build their own exception class hierarchy, but you should first look atregister_exception
before implementing your own class hierarchy. If you really wish to build your own exception class hierarchy, we recommend that all exceptions inherit of Dancer::Exception::. Or at least it should implement its methods.The exception class can also be written as words separated by underscores, it'll be camelized automatically. So
'Exception::Foo'
and'exception_foo'
are equivalent. Be careful,'MyException'
can't be written'myexception'
, as it would be camelized into'Myexception'
.register_exception
This method allows one to register custom exceptions, usable by Dancer users in their route code (actually pretty much everywhere).
# simple exception register_exception ('InvalidCredentials', message_pattern => "invalid credentials : %s", );
This registers a new custom exception. To use it, do:
raise InvalidCredentials => "user Herbert not found";
The exception message can be retrieved with the
$exception->message
method, and we'll be"invalid credentials : user Herbert not found"
(see methods in Dancer::Exception::Base)# complex exception register_exception ('InvalidLogin', composed_from => [qw(Fatal InvalidCredentials)], message_pattern => "wrong login or password", );
In this example, the
InvalidLogin
is built as a composition of theFatal
andInvalidCredentials
exceptions. See thedoes
method in Dancer::Exception::Base.registered_exceptions
my @exception_classes = registered_exceptions;
Returns the list of exception class names. It will list core exceptions
and
custom exceptions (except the one you've registered with a leading+
, seeregister_exception
). The list is sorted.GLOBAL VARIABLE
$Dancer::Exception::Verbose
When set to 1, exceptions will stringify with a long stack trace. This variable is similar to
$Carp::Verbose
. I recommend you use it like that:local $Dancer::Exception::Verbose; $Dancer::Exception::Verbose = 1;
All the Carp global variables can also be used to alter the stacktrace generation.
AUTHOR
Dancer Core Developers
COPYRIGHT AND LICENSE
This software is copyright (c) 2010 by Alexis Sukrieh.
This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.
Module Install Instructions
To install Dancer, copy and paste the appropriate command in to your terminal.
cpanm Dancer
perl -MCPAN -e shell install Dancer
For more information on module installation, please visit the detailed CPAN module installation guide.