package DBIx::Class::Exception;
use strict;
-use vars qw[@ISA $DBIC_EXCEPTION_CLASS];
-use UNIVERSAL::require;
+use warnings;
-BEGIN {
- push( @ISA, $DBIC_EXCEPTION_CLASS || 'DBIx::Class::Exception::Base' );
-}
+# load Carp early to prevent tickling of the ::Internal stash being
+# interpreted as "Carp is already loaded" by some braindead loader
+use Carp ();
+$Carp::Internal{ (__PACKAGE__) }++;
-package DBIx::Class::Exception::Base;
+use DBIx::Class::Carp ();
-use strict;
-use Carp ();
+use overload
+ '""' => sub { shift->{msg} },
+ fallback => 1;
=head1 NAME
-DBIx::Class::Exception - DBIC Exception Class
+DBIx::Class::Exception - Exception objects for DBIx::Class
-=head1 SYNOPSIS
+=head1 DESCRIPTION
- DBIx::Class::Exception->throw( qq/Fatal exception/ );
+Exception objects of this class are used internally by
+the default error handling of L<DBIx::Class::Schema/throw_exception>
+and derivatives.
-See also L<DBIx::Class>.
+These objects stringify to the contained error message, and use
+overload fallback to give natural boolean/numeric values.
-=head1 DESCRIPTION
+=head1 METHODS
-This is a generic Exception class for DBIx::Class. You can easily
-replace this with any mechanism implementing 'throw' by setting
-$DBix::Class::Exception::DBIC_EXCEPTION_CLASS
+=head2 throw
-=head1 METHODS
+=over 4
-=head2 throw( $message )
+=item Arguments: $exception_scalar, $stacktrace
-=head2 throw( message => $message )
+=back
-=head2 throw( error => $error )
+This is meant for internal use by L<DBIx::Class>'s C<throw_exception>
+code, and shouldn't be used directly elsewhere.
-Throws a fatal exception.
+Expects a scalar exception message. The optional argument
+C<$stacktrace> tells it to output a full trace similar to L<Carp/confess>.
+
+ DBIx::Class::Exception->throw('Foo');
+ try { ... } catch { DBIx::Class::Exception->throw(shift) }
=cut
sub throw {
- my $class = shift;
- my %params = @_ == 1 ? ( error => $_[0] ) : @_;
+ my ($class, $msg, $stacktrace) = @_;
+
+ # Don't re-encapsulate exception objects of any kind
+ die $msg if ref($msg);
+
+ # all exceptions include a caller
+ $msg =~ s/\n$//;
+
+ if(!$stacktrace) {
+ # skip all frames that match the original caller, or any of
+ # the dbic-wide classdata patterns
+ my ($ln, $calling) = DBIx::Class::Carp::__find_caller(
+ '^' . caller() . '$',
+ 'DBIx::Class',
+ );
- my $message = $params{message} || $params{error} || $! || '';
+ $msg = "${calling}${msg} ${ln}\n";
+ }
+ else {
+ $msg = Carp::longmess($msg);
+ }
- local $Carp::CarpLevel = (caller(1) eq 'NEXT' ? 2 : 1);
+ my $self = { msg => $msg };
+ bless $self => $class;
- Carp::croak($message);
+ die $self;
}
-=head1 AUTHOR
+=head2 rethrow
-Marcus Ramberg <mramberg@cpan.org>
+This method provides some syntactic sugar in order to
+re-throw exceptions.
+
+=cut
+
+sub rethrow {
+ die shift;
+}
-=head1 THANKS
+=head1 AUTHOR AND CONTRIBUTORS
-Thanks to the L<Catalyst> framework, where this module was borrowed
-from.
+See L<AUTHOR|DBIx::Class/AUTHOR> and L<CONTRIBUTORS|DBIx::Class/CONTRIBUTORS> in DBIx::Class
-=head1 COPYRIGHT
+=head1 LICENSE
-This program is free software, you can redistribute it and/or modify
-it under the same terms as Perl itself.
+You may distribute this code under the same terms as Perl itself.
=cut