man DBIx::Class::Schema () - composable schemas
NAME
DBIx::Class::Schema - composable schemas
SYNOPSIS
in My/Schema.pm
package My::Schema;
use base qw/DBIx::Class::Schema/;
__PACKAGE__->load_classes(qw/Foo Bar Baz/);
in My/Schema/Foo.pm
package My::Schema::Foo;
use base qw/DBIx::Class/;
__PACKAGE__->load_components(qw/Core PK::Auto::Pg/); # for example
__PACKAGE__->table('foo');
...
in My/DB.pm
use My::Schema;
My::Schema->compose_connection('My::DB', $dsn, $user, $pass, $attrs);
then in app code
my @obj = My::DB::Foo->search({}); # My::DB::Foo isa My::Schema::Foo My::DB
DESCRIPTION
Creates database classes based on a schema. This allows you to have more than one concurrent connection using the same database classes, by making subclasses under a new namespace for each connection. If you only need one class, you should probably use DBIx::Class::DB directly instead.
NB: If you're used to Class::DBI it's worth reading the SYNOPSIS carefully as DBIx::Class does things a little differently. Note in particular which module inherits off which.
METHODS
register_class <component> <component_class>
Registers the class in the schema's class_registrations. This is a hash containing database classes, keyed by their monikers. It's used by compose_connection to create/modify all the existing database classes.
registered_classes
Simple read-only accessor for the schema's registered classes. See register_class above if you want to modify it.
load_classes [<classes>, (<class>, <class>), {<namespace> => [<classes>]}]
Uses Module::Find to find all classes under the database class' namespace, or uses the classes you select. Then it loads the component (using use), and registers them (using register_class);
It is possible to comment out classes with a leading '#', but note that perl will think it's a mistake (trying to use a comment in a qw list) so you'll need to add no warnings 'qw'; before your load_classes call.
compose_connection <target> <@db_info>
This is the most important method in this class. it takes a target namespace, as well as dbh connection info, and creates a DBIx::Class::DB class as well as subclasses for each of your database classes in this namespace, using this connection.
It will also setup a ->table method on the target class, which lets you resolve database classes based on the schema component name, for example
MyApp::DB->table('Foo') # returns MyApp::DB::Foo,
# which ISA MyApp::Schema::Foo
This is the recommended API for accessing Schema generated classes, and using it might give you instant advantages with future versions of DBIC.
setup_connection_class <$target> <@info>
Sets up a database connection class to inject between the schema and the subclasses the schema creates.
AUTHORS
Matt S. Trout <mst@shadowcatsystems.co.uk>
LICENSE
You may distribute this code under the same terms as Perl itself.