X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=blobdiff_plain;f=lib%2FDBIx%2FClass%2FDB.pm;h=0fdb1844e9424380a91604dcf9808539e7c3b641;hb=5ef3e508fa20d477b62406146cdca0ae658c10dd;hp=e9ff08a7a3dc0ca765fdabc8f5d52cada959a770;hpb=480c6e79278a6ce76bd4db7269f561c60a4d4c5e;p=dbsrgits%2FDBIx-Class.git diff --git a/lib/DBIx/Class/DB.pm b/lib/DBIx/Class/DB.pm index e9ff08a..0fdb184 100644 --- a/lib/DBIx/Class/DB.pm +++ b/lib/DBIx/Class/DB.pm @@ -1,16 +1,31 @@ package DBIx::Class::DB; use base qw/DBIx::Class/; +use DBIx::Class::Schema; use DBIx::Class::Storage::DBI; use DBIx::Class::ClassResolver::PassThrough; use DBI; -*dbi_commit = \&tx_commit; -*dbi_rollback = \&tx_rollback; +__PACKAGE__->load_components(qw/ResultSetProxy/); + +*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 - Simple DBIx::Class Database connection by class inheritance +DBIx::Class::DB - Non-recommended classdata schema component =head1 SYNOPSIS @@ -24,13 +39,16 @@ DBIx::Class::DB - Simple DBIx::Class Database connection by class inheritance package MyDB::MyTable; use base qw/MyDB/; - __PACKAGE__->load_components('Core'); + __PACKAGE__->load_components('Core'); # just load this in MyDB if it will always be there ... =head1 DESCRIPTION -This class provides a simple way of specifying a database connection. +This class is designed to support the Class::DBI connection-as-classdata style +for DBIx::Class. You are *strongly* recommended to use a DBIx::Class::Schema +instead; DBIx::Class::DB will continue to be supported but new development +will be focused on Schema-based DBIx::Class setups. =head1 METHODS @@ -38,7 +56,7 @@ This class provides a simple way of specifying a database connection. Sets or gets the storage backend. Defaults to L. -=head2 class_resolver +=head2 class_resolver ****DEPRECATED**** Sets or gets the class to use for resolving a class. Defaults to L, which returns whatever you give @@ -46,7 +64,6 @@ it. See resolve_class below. =cut -__PACKAGE__->mk_classdata('storage'); __PACKAGE__->mk_classdata('class_resolver' => 'DBIx::Class::ClassResolver::PassThrough'); @@ -61,36 +78,58 @@ instantiate the class dbh when required. sub connection { my ($class, @info) = @_; - my $storage = DBIx::Class::Storage::DBI->new; - $storage->connect_info(\@info); - $class->storage($storage); + $class->setup_schema_instance unless $class->can('schema_instance'); + $class->schema_instance->connection(@info); +} + +=head2 setup_schema_instance + +Creates a class method ->schema_instance which contains a DBIx::Class::Schema; +all class-method operations are proxies through to this object. If you don't +call ->connection in your DBIx::Class::DB subclass at load time you *must* +call ->setup_schema_instance in order for subclasses to find the schema and +register themselves with it. + +=cut + +sub setup_schema_instance { + my $class = shift; + my $schema = bless({}, 'DBIx::Class::Schema'); + $class->mk_classdata('schema_instance' => $schema); } -=head2 tx_begin +=head2 txn_begin Begins a transaction (does nothing if AutoCommit is off). =cut -sub tx_begin { $_[0]->storage->tx_begin } +sub txn_begin { $_[0]->schema_instance->txn_begin } -=head2 tx_commit +=head2 txn_commit Commits the current transaction. =cut -sub tx_commit { $_[0]->storage->tx_commit } +sub txn_commit { $_[0]->schema_instance->txn_commit } -=head2 tx_rollback +=head2 txn_rollback Rolls back the current transaction. =cut -sub tx_rollback { $_[0]->storage->tx_rollback } +sub txn_rollback { $_[0]->schema_instance->txn_rollback } + +{ + my $warn; -sub resolve_class { return shift->class_resolver->class(@_); } + sub resolve_class { + warn "resolve_class deprecated as of 0.04999_02" unless $warn++; + return shift->class_resolver->class(@_); + } +} 1;