/ 
DBIx-Class-0.04
River stage three • 349 direct dependents • 459 total dependents
/ DBIx::Class

NAME

DBIx::Class - Extensible and flexible object <-> relational mapper.

SYNOPSIS

DESCRIPTION

This is a sql to oop mapper, inspired by the Class::DBI framework, and meant to support compability with it, while restructuring the insides, and making it possible to support some new features like self-joins, distinct, group bys and more.

This project is still at an early stage so the maintainers don't make any absolute promise that full backwards-compatibility will be supported; however if we can without compromising the improvements we're trying to make, we will, and any non-compatible changes will merit a full justification on the mailing list and a CPAN developer release for people to test against.

The community can be found via -

Mailing list: http://lists.rawmode.org/mailman/listinfo/dbix-class/

SVN: http://dev.catalyst.perl.org/repos/bast/trunk/DBIx-Class/

Wiki: http://dbix-class.shadowcatsystems.co.uk/

IRC: irc.perl.org#dbix-class

QUICKSTART

If you're using Class::DBI, and want an easy and fast way of migrating to DBIx::Class look at DBIx::Class::CDBICompat.

There are two ways of using DBIx::Class, the 'simple' and the 'schema' one.

The 'simple' way of using DBIx::Class needs less classes than the 'schema' way but doesn't give you the ability to use different database connections.

Some examples where different database connections are useful are:

different users with different rights different databases with the same schema.

Simple

First you need to create a base class all other classes inherit from.

Look at DBIx::Class::DB how to do this

Next you need to create a class for every table you want to use with DBIx::Class.

Look at DBIx::Class::Table how to do this.

Schema

With this approach the table classes inherit directly from DBIx::Class::Core, although it might be a good idea to create a 'parent' class for all table classes which inherits from DBIx::Class::Core and adds additional methods needed by all table classes, e.g. reading a config file, loading auto primary key support.

Look at DBIx::Class::Schema how to do this.

If you need more hand-holding, check out the introduction in the manual below.

SEE ALSO

DBIx::Class::Core - DBIC Core Classes
DBIx::Class::CDBICompat - Class::DBI Compat layer.
DBIx::Class::Manual - User's manual.

AUTHOR

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

CONTRIBUTORS

Andy Grundman <andy@hybridized.org>

Brian Cassidy <bricas@cpan.org>

Dan Kubb <dan.kubb-cpan@onautopilot.com>

Dan Sully <daniel@cpan.org>

davekam

Marcus Ramberg <mramberg@cpan.org>

LICENSE

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