The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.

NAME

DBIx::Class::DB - (DEPRECATED) classdata schema component

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

  ...

DESCRIPTION

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 not undergo new development and will be moved to being a CDBICompat-only component before 1.0.

METHODS

storage

Sets or gets the storage backend. Defaults to DBIx::Class::Storage::DBI.

class_resolver

****DEPRECATED****

Sets or gets the class to use for resolving a class. Defaults to DBIx::Class::ClassResolver::Passthrough, which returns whatever you give it. See resolve_class below.

connection

  __PACKAGE__->connection($dsn, $user, $pass, $attrs);

Specifies the arguments that will be passed to DBI->connect(...) to instantiate the class dbh when required.

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.

txn_begin

Begins a transaction (does nothing if AutoCommit is off).

txn_commit

Commits the current transaction.

txn_rollback

Rolls back the current transaction.

txn_do

Executes a block of code transactionally. If this code reference throws an exception, the transaction is rolled back and the exception is rethrown. See "txn_do" in DBIx::Class::Schema for more details.

resultset_instance

Returns an instance of a resultset for this class - effectively mapping the Class::DBI connection-as-classdata paradigm into the native DBIx::Class::ResultSet system.

resolve_class

****DEPRECATED****

See class_resolver

dbi_commit

****DEPRECATED****

Alias for txn_commit

dbi_rollback

****DEPRECATED****

Alias for txn_rollback

AUTHORS

Matt S. Trout <mst@shadowcatsystems.co.uk>

LICENSE

You may distribute this code under the same terms as Perl itself.