1 package DBIx::DataSource::Driver;
11 DBIx::DataSource::Driver - Driver Writer's Guide and base class
15 perldoc DBIx::DataSource::Driver;
19 package DBIx::DataSource::FooBase;
20 use DBIx::DataSource::Driver;
21 @ISA = qw( DBIx::DataSource::Driver );
25 To implement a driver for your database:
27 1) If you can create a database with an SQL command through DBI/DBD, simply
28 provide a parse_dsn class method which returns a list consisting of the
29 *actual* data source to use in DBI->connect and the SQL.
31 package DBIx::DataSource::NewDatabase;
32 use DBIx::DataSource::Driver;
33 @ISA = qw( DBIx::DataSource::Driver );
36 my( $class, $action, $dsn ) = @_;
38 # $action is `create' or `drop'
39 # for example, if you parse parse $dsn for $database,
40 # $sql = "$action $database";
42 # you can die on errors - it'll be caught
47 2) Otherwise, you'll need to write B<create_database> and B<drop_database>
50 package DBIx::DataSource::NewDatabase;
53 my( $class, $dsn, $user, $pass ) = @_;
55 # for success, return true
56 # for failure, die (it'll be caught)
60 my( $class, $dsn, $user, $pass ) = @_;
62 # for success, return true
63 # for failure, die (it'll be caught)
68 sub create_database { shift->_sql('create', @_) };
69 sub drop_database { shift->_sql('drop', @_) };
72 my( $class, $action, $dsn, $user, $pass ) = @_;
73 my( $new_dsn, $sql ) = $class->parse_dsn($action, $dsn);
74 my $dbh = DBI->connect( $new_dsn, $user, $pass ) or die $DBI::errstr;
75 # $dbh->do($sql) or die $dbh->errstr;
76 # silly DBI. implicit DESTROY yummy.
77 $dbh->do($sql) or do { my $err = $dbh->errstr; $dbh->disconnect; die $err; };
78 $dbh->disconnect or die $dbh->errstr;
83 Ivan Kohler <ivan-dbix-datasource@420.am>
87 Copyright (c) 2000 Ivan Kohler
88 Copyright (c) 2000 Mail Abuse Prevention System LLC
90 This program is free software; you can redistribute it and/or modify it under
91 the same terms as Perl itself.
97 L<DBIx::DataSource>, L<DBIx::DataSource::mysql>, L<DBIx::DataSource::Pg>, L<DBI>