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

SYNOPSIS
DESCRIPTION
   This is an SQL to OO mapper, inspired by the Class::DBI framework, and
   meant to support compability with it, while restructuring the internals
   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, take a look at DBIx::Class::CDBICompat.

   There are two ways of using DBIx::Class, the "simple" way and the
   "schema" way. The "simple" way of using DBIx::Class needs less classes
   than the "schema" way but doesn't give you the ability to easily 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 which all other classes will
   inherit from. See DBIx::Class::DB for information on how to do this.

   Then you need to create a class for every table you want to use with
   DBIx::Class. See DBIx::Class::Table for information on 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 that inherits from DBIx::Class::Core and
   adds additional methods needed by all table classes, e.g. reading a
   config file or loading auto primary key support.

   Look at DBIx::Class::Schema for information on how to do this.

   If you need more help, check out the introduction in the manual below.

SEE ALSO
   DBIx::Class::Core - DBIC Core Classes
   DBIx::Class::Manual - User's manual
   DBIx::Class::CDBICompat - Class::DBI Compat layer
   DBIx::Class::Schema
   DBIx::Class::ResultSet
   DBIx::Class::ResultSource
   DBIx::Class::Row - row-level methods
   DBIx::Class::PK - primary key methods
   DBIx::Class::Relationship - relationships between tables

AUTHOR
   Matt S. Trout <[email protected]>

CONTRIBUTORS
   Andy Grundman <[email protected]>

   Brian Cassidy <[email protected]>

   Dan Kubb <[email protected]>

   Dan Sully <[email protected]>

   David Kamholz <[email protected]>

   Jules Bean

   Marcus Ramberg <[email protected]>

   Paul Makepeace

   CL Kao

   Jess Robinson

   Marcus Ramberg

   Will Hawes

   Todd Lipcon

   Daniel Westermann-Clark <[email protected]>

   Alexander Hartmaier <[email protected]>

   Zbigniew Lukasiak

   Nigel Metheringham <[email protected]>

   Jesper Krogh

   Brandon Black

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