X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=blobdiff_plain;f=lib%2FDBIx%2FClass%2FException.pm;h=a5e9945ec8f885d4ed3b45c5de792511c1a570ea;hb=367eaf50970dd3fd223ce5e1f0337703f2a6c70e;hp=40426ad803d730415ef86de47b403db16b6ef91a;hpb=07037f89d4d9bf97c59a2c083de74f669521da47;p=dbsrgits%2FDBIx-Class.git

diff --git a/lib/DBIx/Class/Exception.pm b/lib/DBIx/Class/Exception.pm
index 40426ad..a5e9945 100644
--- a/lib/DBIx/Class/Exception.pm
+++ b/lib/DBIx/Class/Exception.pm
@@ -1,74 +1,103 @@
 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' );
-}
-
-package DBIx::Class::Exception::Base;
-
-use strict;
+# 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__) }++;
 
-=head1 NAME
+use DBIx::Class::Carp ();
 
-DBIx::Class::Exception - DBIC Exception Class
+use overload
+    '""' => sub { shift->{msg} },
+    fallback => 1;
 
-=head1 SYNOPSIS
-
-   DBIx::Class::Exception->throw( qq/Fatal exception/ );
+=head1 NAME
 
-See also L<DBIx::Class>.
+DBIx::Class::Exception - Exception objects for DBIx::Class
 
 =head1 DESCRIPTION
 
-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
+Exception objects of this class are used internally by
+the default error handling of L<DBIx::Class::Schema/throw_exception>
+and derivatives.
+
+These objects stringify to the contained error message, and use
+overload fallback to give natural boolean/numeric values.
 
 =head1 METHODS
 
+=head2 throw
+
 =over 4
 
-=item throw( $message )
+=item Arguments: $exception_scalar, $stacktrace
 
-=item throw( message => $message )
+=back
+
+This is meant for internal use by L<DBIx::Class>'s C<throw_exception>
+code, and shouldn't be used directly elsewhere.
 
-=item throw( error => $error )
+Expects a scalar exception message. The optional boolean C<$stacktrace>
+causes it to output a full trace similar to L<confess|Carp/DESCRIPTION>.
 
-Throws a fatal exception.
+  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(
+          '^' . CORE::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;
 }
 
-=back
+=head2 rethrow
+
+This method provides some syntactic sugar in order to
+re-throw exceptions.
 
-=head1 AUTHOR
+=cut
 
-Marcus Ramberg <mramberg@cpan.org>
+sub rethrow {
+    die shift;
+}
 
-=head1 THANKS
+=head1 FURTHER QUESTIONS?
 
-Thanks to the L<Catalyst> framework, where this module was borrowed
-from.
+Check the list of L<additional DBIC resources|DBIx::Class/GETTING HELP/SUPPORT>.
 
-=head1 COPYRIGHT
+=head1 COPYRIGHT AND LICENSE
 
-This program is free software, you can redistribute it and/or modify
-it under the same terms as Perl itself.
+This module is free software L<copyright|DBIx::Class/COPYRIGHT AND LICENSE>
+by the L<DBIx::Class (DBIC) authors|DBIx::Class/AUTHORS>. You can
+redistribute it and/or modify it under the same terms as the
+L<DBIx::Class library|DBIx::Class/COPYRIGHT AND LICENSE>.
 
 =cut