X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=blobdiff_plain;f=lib%2FDBIx%2FClass%2FDB.pm;h=cf96a3702a0ef8c517d85a8c2c813b61ab7ec0eb;hb=91fa659e479fec2f148dad9084b14017915cc553;hp=213415447d3f59933e89d211fb53e1c96821ff35;hpb=95a70f01eae4b2c325a3a527a72cf8ae91796e8c;p=dbsrgits%2FDBIx-Class-Historic.git diff --git a/lib/DBIx/Class/DB.pm b/lib/DBIx/Class/DB.pm index 2134154..cf96a37 100644 --- a/lib/DBIx/Class/DB.pm +++ b/lib/DBIx/Class/DB.pm @@ -1,66 +1,124 @@ package DBIx::Class::DB; -use base qw/Class::Data::Inheritable/; +use base qw/DBIx::Class/; +use DBIx::Class::Schema; +use DBIx::Class::Storage::DBI; +use DBIx::Class::ClassResolver::PassThrough; use DBI; -__PACKAGE__->mk_classdata('_dbi_connect_info'); -__PACKAGE__->mk_classdata('_dbi_connect_package'); -__PACKAGE__->mk_classdata('_dbh'); +__PACKAGE__->load_components(qw/ResultSetInstance/); + +*dbi_commit = \&txn_commit; +*dbi_rollback = \&txn_rollback; + +sub storage { shift->schema_instance(@_)->storage; } + +sub resultset_instance { + my $class = shift; + my $source = $class->result_source_instance; + if ($source->result_class ne $class) { + $source = $source->new($source); + $source->result_class($class); + } + return $source->resultset; +} =head1 NAME -DBIx::Class::DB - DBIx::Class Database connection +DBIx::Class::DB - Simple DBIx::Class Database connection by class inheritance =head1 SYNOPSIS + package MyDB; + + use base qw/DBIx::Class/; + __PACKAGE__->load_components('DB'); + + __PACKAGE__->connection('dbi:...', 'user', 'pass', \%attrs); + + package MyDB::MyTable; + + use base qw/MyDB/; + __PACKAGE__->load_components('Core'); # just load this in MyDB if it will always be there + + ... + =head1 DESCRIPTION -This class represents the connection to the database +This class provides a simple way of specifying a database connection. =head1 METHODS -=over 4 +=head2 storage + +Sets or gets the storage backend. Defaults to L. + +=head2 class_resolver ****DEPRECATED**** + +Sets or gets the class to use for resolving a class. Defaults to +L, which returns whatever you give +it. See resolve_class below. =cut -sub _get_dbh { - my ($class) = @_; - my $dbh; - unless (($dbh = $class->_dbh) && $dbh->FETCH('Active') && $dbh->ping) { - $class->_populate_dbh; - } - return $class->_dbh; -} +__PACKAGE__->mk_classdata('class_resolver' => + 'DBIx::Class::ClassResolver::PassThrough'); -sub _populate_dbh { - my ($class) = @_; - my @info = @{$class->_dbi_connect_info || []}; - my $pkg = $class->_dbi_connect_package || $class; - $pkg->_dbh($class->_dbi_connect(@info)); -} +=head2 connection -sub _dbi_connect { - my ($class, @info) = @_; - return DBI->connect(@info); -} + __PACKAGE__->connection($dsn, $user, $pass, $attrs); + +Specifies the arguments that will be passed to DBI->connect(...) to +instantiate the class dbh when required. + +=cut sub connection { my ($class, @info) = @_; - $class->_dbi_connect_package($class); - $class->_dbi_connect_info(\@info); + my $storage = DBIx::Class::Storage::DBI->new; + $storage->connect_info(\@info); + my $schema = bless({ storage => $storage }, 'DBIx::Class::Schema'); + $class->mk_classdata('schema_instance' => $schema); } -sub dbi_commit { $_[0]->_get_dbh->commit; } +=head2 txn_begin -sub dbi_rollback { $_[0]->_get_dbh->rollback; } +Begins a transaction (does nothing if AutoCommit is off). -1; +=cut + +sub txn_begin { $_[0]->storage->txn_begin } + +=head2 txn_commit + +Commits the current transaction. + +=cut + +sub txn_commit { $_[0]->storage->txn_commit } -=back +=head2 txn_rollback + +Rolls back the current transaction. + +=cut + +sub txn_rollback { $_[0]->storage->txn_rollback } + +{ + my $warn; + + sub resolve_class { + warn "resolve_class deprecated as of 0.04999_02" unless $warn++; + return shift->class_resolver->class(@_); + } +} + +1; =head1 AUTHORS -Matt S. Trout +Matt S. Trout =head1 LICENSE