DBIx::DataSource::Driver.3pm

Langue: en

Version: 2000-09-25 (debian - 07/07/09)

Section: 3 (Bibliothèques de fonctions)

NAME

DBIx::DataSource::Driver - Driver Writer's Guide and base class

SYNOPSIS

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

DESCRIPTION

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)
        }
 
 

AUTHOR

Ivan Kohler <ivan-dbix-datasource@420.am> Copyright (c) 2000 Ivan Kohler Copyright (c) 2000 Mail Abuse Prevention System LLC All rights reserved. This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

BUGS

SEE ALSO

DBIx::DataSource, DBIx::DataSource::mysql, DBIx::DataSource::Pg, DBI