DBIx::DataSource::Driver(3pm)

DBIx::DataSource::Driver3pm

Driver writer's guide and base class

Usage

  perldoc DBIx::DataSource::Driver;
  or
  package DBIx::DataSource::FooBase;
  use DBIx::DataSource::Driver;
  @ISA = qw( DBIx::DataSource::Driver );

Overview

To implement a driver for your database:

1) If you can create a database with an SQL command through DBI/DBD, simply
provide a parse_dsn class method which returns a list consisting of the
*actual* data source to use in DBI->connect and the SQL.

       package DBIx::DataSource::NewDatabase;
       use DBIx::DataSource::Driver;
       @ISA = qw( DBIx::DataSource::Driver );
       sub parse_dsn {
         my( $class, $action, $dsn ) = @_;
         # $action is `create' or `drop'
         # for example, if you parse parse $dsn for $database,
         # $sql = "$action $database";
         # you can die on errors - it'll be caught
         ( $new_dsn, $sql );
       }

2) Otherwise, you'll need to write create_database and drop_database
class methods.

       package DBIx::DataSource::NewDatabase;
       sub create_database {
         my( $class, $dsn, $user, $pass ) = @_;
         # for success, return true
         # for failure, die (it'll be caught)
       }
       sub drop_database {
         my( $class, $dsn, $user, $pass ) = @_;
         # for success, return true
         # for failure, die (it'll be caught)
       }

Releases

12 releases since Debian 3.0 (Woody); the text changed 4 times.

  1. 3.0
  2. 3.1–7
  3. 8–9
  4. 10–11
  5. 12–13

Author

Ivan Kohler <[email protected]>

Bugs

From libdbix-datasource-perl 0.02-6 in Debian 13 (Trixie). Parsed by carta from the page's man source.