README

   1 NAME
   2     DBIx::Class - Extensible and flexible object <-> relational mapper.
   3
   4 SYNOPSIS
   5 DESCRIPTION
   6     This is an SQL to OO mapper, inspired by the Class::DBI framework, and
   7     meant to support compability with it, while restructuring the internals
   8     and making it possible to support some new features like self-joins,
   9     distinct, group bys and more.
  10
  11     This project is still at an early stage, so the maintainers don't make
  12     any absolute promise that full backwards-compatibility will be
  13     supported; however, if we can without compromising the improvements
  14     we're trying to make, we will, and any non-compatible changes will merit
  15     a full justification on the mailing list and a CPAN developer release
  16     for people to test against.
  17
  18     The community can be found via -
  19
  20       Mailing list: http://lists.rawmode.org/mailman/listinfo/dbix-class/
  21
  22       SVN: http://dev.catalyst.perl.org/repos/bast/trunk/DBIx-Class/
  23
  24       Wiki: http://dbix-class.shadowcatsystems.co.uk/
  25
  26       IRC: irc.perl.org#dbix-class
  27
  28 QUICKSTART
  29     If you're using Class::DBI, and want an easy and fast way of migrating
  30     to DBIx::Class, take a look at DBIx::Class::CDBICompat.
  31
  32     There are two ways of using DBIx::Class, the "simple" way and the
  33     "schema" way. The "simple" way of using DBIx::Class needs less classes
  34     than the "schema" way but doesn't give you the ability to easily use
  35     different database connections.
  36
  37     Some examples where different database connections are useful are:
  38
  39     different users with different rights different databases with the same
  40     schema.
  41
  42   Simple
  43     First you need to create a base class which all other classes will
  44     inherit from. See DBIx::Class::DB for information on how to do this.
  45
  46     Then you need to create a class for every table you want to use with
  47     DBIx::Class. See DBIx::Class::Table for information on how to do this.
  48
  49   Schema
  50     With this approach, the table classes inherit directly from
  51     DBIx::Class::Core, although it might be a good idea to create a "parent"
  52     class for all table classes that inherits from DBIx::Class::Core and
  53     adds additional methods needed by all table classes, e.g. reading a
  54     config file or loading auto primary key support.
  55
  56     Look at DBIx::Class::Schema for information on how to do this.
  57
  58     If you need more help, check out the introduction in the manual below.
  59
  60 SEE ALSO
  61     DBIx::Class::Core - DBIC Core Classes
  62     DBIx::Class::Manual - User's manual
  63     DBIx::Class::CDBICompat - Class::DBI Compat layer
  64     DBIx::Class::Schema
  65     DBIx::Class::ResultSet
  66     DBIx::Class::ResultSource
  67     DBIx::Class::Row - row-level methods
  68     DBIx::Class::PK - primary key methods
  69     DBIx::Class::Relationship - relationships between tables
  70
  71 AUTHOR
  72     Matt S. Trout <mst@shadowcatsystems.co.uk>
  73
  74 CONTRIBUTORS
  75     Andy Grundman <andy@hybridized.org>
  76
  77     Brian Cassidy <bricas@cpan.org>
  78
  79     Dan Kubb <dan.kubb-cpan@onautopilot.com>
  80
  81     Dan Sully <daniel@cpan.org>
  82
  83     David Kamholz <dkamholz@cpan.org>
  84
  85     Jules Bean
  86
  87     Marcus Ramberg <mramberg@cpan.org>
  88
  89     Paul Makepeace
  90
  91     CL Kao
  92
  93     Jess Robinson
  94
  95     Marcus Ramberg
  96
  97     Will Hawes
  98
  99     Todd Lipcon
 100
 101     Daniel Westermann-Clark <danieltwc@cpan.org>
 102
 103     Alexander Hartmaier <alex_hartmaier@hotmail.com>
 104
 105     Zbigniew Lukasiak
 106
 107     Nigel Metheringham <nigelm@cpan.org>
 108
 109     Jesper Krogh
 110
 111     Brandon Black
 112
 113     Scotty Allen <scotty@scottyallen.com>
 114
 115 LICENSE
 116     You may distribute this code under the same terms as Perl itself.
 117