X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=blobdiff_plain;f=lib%2FDBIx%2FClass%2FDB.pm;h=df232b305b0d71de03dbb8eee00648fa89353504;hb=97940e368df996e1fe6111fb14f560594dc4c0b2;hp=93eec5804e261fc25a24bd48408744fcb03eaa6d;hpb=11544e1d2d3ef6c010616c061563996a3b10df37;p=dbsrgits%2FDBIx-Class.git diff --git a/lib/DBIx/Class/DB.pm b/lib/DBIx/Class/DB.pm index 93eec58..df232b3 100644 --- a/lib/DBIx/Class/DB.pm +++ b/lib/DBIx/Class/DB.pm @@ -37,7 +37,9 @@ use, documentation has been removed as of 0.08000 Hidden. -=begin hidden head2 storage +=begin hidden + +=head2 storage Sets or gets the storage backend. Defaults to L. @@ -45,7 +47,9 @@ Sets or gets the storage backend. Defaults to L. =cut -=begin hidden head2 class_resolver +=begin hidden + +=head2 class_resolver ****DEPRECATED**** @@ -57,10 +61,12 @@ it. See resolve_class below. =cut -__PACKAGE__->mk_classdata('class_resolver' => +__PACKAGE__->mk_classaccessor('class_resolver' => 'DBIx::Class::ClassResolver::PassThrough'); -=begin hidden head2 connection +=begin hidden + +=head2 connection __PACKAGE__->connection($dsn, $user, $pass, $attrs); @@ -77,7 +83,9 @@ sub connection { $class->schema_instance->connection(@info); } -=begin hidden head2 setup_schema_instance +=begin hidden + +=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 @@ -93,10 +101,12 @@ sub setup_schema_instance { my $class = shift; my $schema = {}; bless $schema, 'DBIx::Class::Schema'; - $class->mk_classdata('schema_instance' => $schema); + $class->mk_classaccessor('schema_instance' => $schema); } -=begin hidden head2 txn_begin +=begin hidden + +=head2 txn_begin Begins a transaction (does nothing if AutoCommit is off). @@ -106,7 +116,9 @@ Begins a transaction (does nothing if AutoCommit is off). sub txn_begin { shift->schema_instance->txn_begin(@_); } -=begin hidden head2 txn_commit +=begin hidden + +=head2 txn_commit Commits the current transaction. @@ -116,7 +128,9 @@ Commits the current transaction. sub txn_commit { shift->schema_instance->txn_commit(@_); } -=begin hidden head2 txn_rollback +=begin hidden + +=head2 txn_rollback Rolls back the current transaction. @@ -126,7 +140,9 @@ Rolls back the current transaction. sub txn_rollback { shift->schema_instance->txn_rollback(@_); } -=begin hidden head2 txn_do +=begin hidden + +=head2 txn_do Executes a block of code transactionally. If this code reference throws an exception, the transaction is rolled back and the exception @@ -147,7 +163,9 @@ sub txn_do { shift->schema_instance->txn_do(@_); } } } -=begin hidden head2 resultset_instance +=begin hidden + +=head2 resultset_instance Returns an instance of a resultset for this class - effectively mapping the L connection-as-classdata paradigm into the @@ -158,10 +176,12 @@ native L system. =cut sub resultset_instance { - $_[0]->result_source_instance->resultset + $_[0]->result_source->resultset } -=begin hidden head2 result_source_instance +=begin hidden + +=head2 result_source_instance Returns an instance of the result source for this class @@ -169,12 +189,12 @@ Returns an instance of the result source for this class =cut -__PACKAGE__->mk_classdata('_result_source_instance' => []); +__PACKAGE__->mk_classaccessor('_result_source_instance' => []); # Yep. this is horrific. Basically what's happening here is that # (with good reason) DBIx::Class::Schema copies the result source for # registration. Because we have a retarded setup order forced on us we need -# to actually make our ->result_source_instance -be- the source used, and we +# to actually make our ->result_source -be- the source used, and we # need to get the source name and schema into ourselves. So this makes it # happen. @@ -202,22 +222,23 @@ sub result_source_instance { } my($source, $result_class) = @{$class->_result_source_instance}; - return unless blessed $source; + return undef unless blessed $source; if ($result_class ne $class) { # new class # Give this new class its own source and register it. - $source = $source->new({ - %$source, + $source = $source->clone( source_name => $class, result_class => $class - } ); + ); $class->_result_source_instance([$source, $class]); $class->_maybe_attach_source_to_schema($source); } return $source; } -=begin hidden head2 resolve_class +=begin hidden + +=head2 resolve_class ****DEPRECATED**** @@ -225,7 +246,9 @@ See L =end hidden -=begin hidden head2 dbi_commit +=begin hidden + +=head2 dbi_commit ****DEPRECATED**** @@ -233,7 +256,9 @@ Alias for L =end hidden -=begin hidden head2 dbi_rollback +=begin hidden + +=head2 dbi_rollback ****DEPRECATED**** @@ -241,13 +266,16 @@ Alias for L =end hidden -=head1 AUTHORS +=head1 FURTHER QUESTIONS? -Matt S. Trout +Check the list of L. -=head1 LICENSE +=head1 COPYRIGHT AND LICENSE -You may distribute this code under the same terms as Perl itself. +This module is free software L +by the L. You can +redistribute it and/or modify it under the same terms as the +L. =cut