/ 
Error-Hierarchy-1.103530
River stage one • 6 direct dependents • 6 total dependents
/ Error::Hierarchy::Internal::DBI

NAME

Error::Hierarchy::Internal::DBI - DBI-related exception

VERSION

version 1.103530

SYNOPSIS

my $connect_string = '...';
my $dbuser         = '...';
my $dbpass         = '...';

my $dbh = DBI->connect($connect_string, $dbuser, $dbpass,
    { HandleError => Error::Hierarchy::Internal::DBI->handler });

DESCRIPTION

This class is the main part of the DBI-related exceptions. If you set it as the error handler in a DBI-connect()> call, it will turn the simple string errors thrown by DBI (and the database) into more meaningful exceptions.

METHODS

init

Initializes a newly constructed exception object. It transmutes the exception, then calls emit_warning() on the object.

transmute_exception

Give subclasses a chance to turn generic DBI exceptions into something more specific for their database schema. This method is supposed to bless the exception into the desired package or create a new one and must return it; it is called in init().

emit_warning

Warns via warn() unless the package global SkipWarning is set.

handler

Turns the DBI error into the appropriate Error::Hierarchy::Internal::DBI::* exception object.

PROPERTIES

This exception class inherits all properties of Error::Hierarchy::Internal::CustomMessage.

It has the following additional properties.

error
err
errstr
state
retval

INSTALLATION

See perlmodinstall for information and options on installing Perl modules.

BUGS AND LIMITATIONS

No bugs have been reported.

Please report any bugs or feature requests through the web interface at http://rt.cpan.org/Public/Dist/Display.html?Name=Error-Hierarchy.

AVAILABILITY

The latest version of this module is available from the Comprehensive Perl Archive Network (CPAN). Visit http://www.perl.com/CPAN/ to find a CPAN site near you, or see http://search.cpan.org/dist/Error-Hierarchy/.

The development version lives at http://github.com/hanekomu/Error-Hierarchy and may be cloned from git://github.com/hanekomu/Error-Hierarchy. Instead of sending patches, please fork this project using the standard git and github infrastructure.

AUTHOR

Marcel Gruenauer <marcel@cpan.org>

COPYRIGHT AND LICENSE

This software is copyright (c) 2004 by Marcel Gruenauer.

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.