<div class="slide">
<h1>Authors</h1>
<h4>Originally Leo Lapworth @ LPW 2009</h4>
- <h4>Matthew S. Trout</h4>
+ <h4>Amiri Barksdale</h4>
<h4>Justin D. Hunter</h4>
<h4>Arthur Axel "fREW" Schmidt</h4>
</div>
<div class="slide">
- <h1>assumptions</h1>
- <p>You know a little about Perl and using objects</p>
- <p>You know a little bit about databases and using foreign keys</p>
+ <h1>What's up guys?</h1>
<div class="notes">
<ul>
- <li>How many people have designed a database with Foreign Keys?</li>
<li>How many people have used any ORM?<ul>
<li>In Perl?<ul>
<li>DBIC?</li>
- <li> Class::DBI? </li>
- <li> Rose::DB? </li>
- <li> Fey? </li>
- <li> Others? </li>
+ <li>Class::DBI?</li>
+ <li>Rose::DB?</li>
+ <li>Fey?</li>
+ <li>Others?</li>
</ul></li>
- <li>AR? </li>
- <li> DataMapper? </li>
+ <li>AR?</li>
+ <li>DataMapper?</li>
<li>(N)Hibernate?</li>
</ul></li>
</ul>
</div>
<div class="slide">
+ <h1>Purpose</h1>
+ <p>The purpose of this talk is to show you as many features of
+ DBIx::Class in 40 minutes so that when you need to do something with
+ it later you will know what's possible</p>
+ </div>
+
+ <div class="slide">
<h1>DBIx::Class?</h1>
<ul>
<li>ORM (object relational mapper)</li>
<li>SQL <-> OO (using objects instead of SQL)</li>
- <li>Simple, powerful, complex, fab and confusing</li>
<li>There are many ORMs, DBIx::Class just happens to be the best in Perl (personal opinion)</li>
</ul>
</div>
<div class="slide">
- <h1>point of note</h1>
- <p><em>"Debugging is twice as hard as writing the code in the first
- place. Therefore, if you write the code as cleverly as possible,
- you are, by definition, not smart enough to debug it." - Brian
- W. Kernighan</em></p>
-
- <p>This talk is about making it easy so we are less likely to get
- confused</p>
- </div>
-
- <div class="slide">
- <h1>Examples Table Setup</h1>
- <ul>
- <li>Authors</li>
- <li>Books</li>
- </ul>
- <em>MySQL not recommended</em>
- </div>
-
- <div class="slide">
- <h1>authors table</h1>
-<pre>CREATE TABLE authors(
- id int(8) primary key auto_increment,
- name varchar(255)
-) engine = InnoDB DEFAULT CHARSET=utf8;</pre>
+ <h1>Meta</h1>
+ <p>These are reasons that are not technical or inherent to
+ the code of DBIC, but are totally awesome things about it.</p>
</div>
<div class="slide">
- <h1>tips</h1>
- <p>Name tables as simple plurals (<strong>add an S</strong>) - makes relationships easier to understand</p>
- <p>Use a character set (<strong>UTF8</strong>) from the start (for international characters)</p>
+ <h1>Large Community</h1>
+ <p>Currently there are 88 people listed as contributors to DBIC. That
+ ranges from documentation help, to test help, to added features,
+ to entire database support.</p>
</div>
<div class="slide">
- <h1>authors table</h1>
-<pre>CREATE TABLE author<strong>s</strong>(
- id int(8) primary key auto_increment,
- name varchar(255)
-) engine = <strong>InnoDB</strong> DEFAULT CHARSET=<strong>utf8</strong>;</pre>
+ <h1>Active Community</h1>
+ <p>Currently (June 9, 2010) 6 active branches (commited to in the last two weeks) in git. Last release (0.08122) had 14 new features, and 16 bug fixes. Of course that <a href="http://git.shadowcat.co.uk/gitweb/gitweb.cgi?p=dbsrgits/DBIx-Class.git;a=blob;f=Changes">ebbs and flows</a>.</p>
</div>
<div class="slide">
- <h1>books table</h1>
-<pre>CREATE TABLE books(
- id int(8) primary key auto_increment,
- title varchar(255),
- author_id int(8),foreign key (author)
- references authors(id)
-) engine = InnoDB DEFAULT CHARSET=utf8;</pre>
+ <h1>Responsive Community</h1>
+ <ul class="incremental">
+ <li>needed MSSQL Order by support, they helped me add support</li>
+ <li>generally very welcoming of people willing to help</li>
+ </ul>
</div>
-
<div class="slide">
- <h1>tips</h1>
- <p>Name link fields as singular</p>
- <p>Ensure foreign key is the same type and size in both tables</p>
+ <h1>General ORM</h1>
+ <p>These are things that are in most other ORMs, but are still reasons
+ to use DBIC over raw SQL.</p>
</div>
<div class="slide">
- <h1>books table</h1>
-<pre>CREATE TABLE books(
- id int(8) primary key auto_increment,
- title varchar(255),
- author_id <strong>int(8)</strong>,<strong>foreign key (<em>author</em>)</strong>
- <strong>references <em>authors(id)</em></strong>
-) engine = InnoDB DEFAULT CHARSET=utf8;</pre>
+ <h1>Cross DB</h1>
+ <p>The vast majority of code should run on all databases without needing tweaking</p>
</div>
<div class="slide">
- <h1>CRUD compared</h1>
- <ul>
+ <h1>Basic CRUD</h1>
+ <ul class="incremental">
<li><strong>C</strong> - Create</li>
<li><strong>R</strong> - Read</li>
<li><strong>U</strong> - Update</li>
</div>
<div class="slide">
- <h1>Manual (SQL)</h1>
- </div>
-
- <div class="slide">
<h1>SQL: Create</h1>
<pre>my $sth = $dbh->prepare('
INSERT INTO books
- (title, author)
+ (title, author_id)
values (?,?)
');
</div>
<div class="slide">
+ <h1>DBIC: Create</h1>
+<pre>my $book = $book_rs->create({
+ title => 'A book title',
+ author_id => $author_id,
+});</pre>
+ <ul class="incremental">
+ <li>No need to pair placeholders and values</li>
+ </ul>
+ </div>
+
+ <div class="slide">
<h1>SQL: Read</h1>
<pre>my $sth = $dbh->prepare('
SELECT title,
</div>
<div class="slide">
+ <h1>DBIC: Read</h1>
+<pre>my $book = $book_rs->find($book_id);
+
+my $book = $book_rs->search({
+ title => 'A book title',
+}, { rows => 1 })->single;
+
+my @books = $book_rs->search({
+ author => $author_id,
+})->all;</pre>
+ <ul class="incremental">
+ <li>TMTOWTDI</li>
+ </ul>
+ </div>
+
+ <div class="slide">
+ <h1>DBIC: Read</h1>
+<pre>while( my $book = $books_rs->next ) {
+ print 'Author of '
+ . $book->title
+ . ' is '
+ . $book->author->name
+ . "\n";
+}</pre>
+ </div>
+
+ <div class="slide">
<h1>SQL: Update</h1>
<pre>my $update = $dbh->prepare('
UPDATE books
</div>
<div class="slide">
+ <h1>DBIC: Update</h1>
+<pre>$book->update({
+ title => 'New title',
+});</pre>
+ </div>
+
+ <div class="slide">
<h1>SQL: Delete</h1>
<pre>my $delete = $dbh->prepare('
DELETE FROM books
</div>
<div class="slide">
- <h1>DBIx::Class</h1>
+ <h1>DBIC: Delete</h1>
+<pre>$book->delete;</pre>
</div>
<div class="slide">
- <h1>DBIC: Create</h1>
-<pre>my $book = $book_model->create({
- title => 'A book title',
- author => $author_id,
-});</pre>
- <p>Look ma, no SQL!</p>
+ <h1>OO Overidability</h1>
+ <ul class="incremental">
+ <li>Override new if you want to do validation</li>
+ <li>Override delete if you want to disable deletion</li>
+ <li>and on and on</li>
+ </ul>
+ <div class="notes">
+ <p>I got yelled at about this before by people, so
+ we don't get EVERYTHING from OO, but we do get a lot
+ so :-P</p>
+ </div>
</div>
<div class="slide">
- <h1>DBIC: Create</h1>
-<pre>my $pratchett = $author_model->create({
- name => 'Terry Pratchett',
-});</pre>
+ <h1>Convenience Methods</h1>
+ <ul class="incremental">
+ <li>find_or_create</li>
+ <li>create_or_update</li>
+ </ul>
</div>
<div class="slide">
- <h1>DBIC: Create</h1>
-<pre>my $book = $pratchett->create_related(
- <strong>books</strong> => {
- title => 'Another Discworld book',
-});</pre>
-<strong>or</strong>
-<pre>my $book = $pratchett->add_to_<strong>books</strong>({
- title => 'Another Discworld book',
-});</pre>
+ <h1>Non-column methods</h1>
+ <p>Need a method to get a user's gravatar URL? Add a
+ gravatar_url method to their Result class</p>
</div>
<div class="slide">
- <h1>DBIC: Read</h1>
- <p>DBIx::Class - Lots of ways to do the same thing...</p>
- <p><em>"There is more than one way to do it (TIMTOWTDI, usually pronounced "Tim Toady") is a Perl motto"</em></p>
+ <h1>RELATIONSHIPS</h1>
+ <ul class="incremental">
+ <li><a href="http://search.cpan.org/perldoc?DBIx::Class::Relationship#belongs_to">belongs_to</a></li>
+ <li><a href="http://search.cpan.org/perldoc?DBIx::Class::Relationship#has_many">has_many</a></li>
+ <li><a href="http://search.cpan.org/perldoc?DBIx::Class::Relationship#might_have">might_have</a></li>
+ <li><a href="http://search.cpan.org/perldoc?DBIx::Class::Relationship#has_one">has_one</a></li>
+ <li><a href="http://search.cpan.org/perldoc?DBIx::Class::Relationship#many_to_many">many_to_many</a> (technically not a relationship)</li>
+ <li>SET AND FORGET</li>
+ </ul>
</div>
<div class="slide">
- <h1>DBIC: Read</h1>
-<pre>my $book = $book_model->find($book_id);
-
-my $book = $book_model->search({
- title => 'A book title',
-}, { rows => 1 })->single;
-
-my @books = $book_model->search({
- author => $author_id,
-})->all;</pre>
+ <h1>DBIx::Class Specific Features</h1>
+ <p>These things may be in other ORM's, but they are very specific, so doubtful</p>
</div>
<div class="slide">
- <h1>DBIC: Read</h1>
-<pre>while( my $book = $books_rs->next ) {
- print 'Author of '
- . $book->title
- . ' is '
- . $book->author->name
- . "\n";
-}</pre>
+ <h1>->deploy</h1>
+ <p>Perl -> DB</p>
+<pre>my $schema = Foo::Schema->connect($dsn, $user, $pass);
+$schema->deploy
+</pre>
+<p>See also: <a href="http://search.cpan.org/perldoc?DBIx::Class::DeploymentHandler">DBIx::Class::DeploymentHandler</a></p>
</div>
<div class="slide">
- <h1>DBIC: Read</h1>
-<pre>my $books_rs = $book_rs->search({
- author => $author_id,
-});</pre>
- <p>Search takes SQL::Abstract formatted queries</p>
- <pre>> perldoc SQL::Abstract</p>
+ <h1>Schema::Loader</h1>
+ <p>DB -> Perl</p>
+<pre>package Foo::Schema;
+use strict; use warnings;
+use base 'DBIx::Class::Schema::Loader';
+__PACKAGE__->loader_options({
+ naming => 'v7',
+ debug => $ENV{DBIC_TRACE},
+});
+1;
+
+# elsewhere...
+
+my $schema = Foo::Schema->connect($dsn, $user, $pass);
+</pre>
</div>
<div class="slide">
- <h1>DBIC: Update</h1>
-<pre>$book->update({
- title => 'New title',
-});</pre>
+ <h1>Populate</h1>
+ <p>Made for inserting lots of rows very quicky into database</p>
+<pre>$schema->populate([ Users =>
+ [qw( username password )],
+ [qw( frew >=4char$ )],
+ [qw( ... )],
+ [qw( ... )],
+);
+</pre>
+ <ul class="incremental">
+ <li>I use this to <a href="http://blog.afoolishmanifesto.com/archives/1255">export our whole (200M~) db to SQLite</a></li>
+ </ul>
</div>
<div class="slide">
- <h1>DBIC: Delete</h1>
-<pre>$book->delete;</pre>
+ <h1>Multicreate</h1>
+ <p>Create an object and all of it's related objects all at once</p>
+<pre>$schema->resultset('Author')->create({
+ name => 'Stephen King',
+ books => [{ title => 'The Dark Tower' }],
+ address => {
+ street => '123 Turtle Back Lane',
+ state => { abbreviation => 'ME' },
+ city => { name => 'Lowell' },
+ },
+</pre>
+ <div class="notes">
+ <ul>
+ <li>books is a has_many</li>
+ <li>address is a belongs_to which in turn belongs to state and city each</li>
+ <li>for this to work right state and city must mark abbreviation and name as unique</li>
+ </ul>
+ </div>
</div>
<div class="slide">
- <h1>Creating models</h1>
+ <h1>Extensible</h1>
+ <p>DBIx::Class helped pioneer fast MI in Perl 5 with Class::C3, so it is made
+ to allow extensions to nearly every part of it.</p>
</div>
<div class="slide">
-<pre>package MyApp::Schema::Result::Author;
-use strict; use warnings;
-__PACKAGE__->table('authors');
-__PACKAGE__->add_columns(
- id => {
- data_type => 'int',
- size => 8,
- },
- title => {
- data_type => 'varchar',
- is_nullable => 1,
- size => 255,
- },
-);
-__PACKAGE__->set_primary_key('id');
-__PACKAGE__->has_many( books =>
- 'MyApp::Schema::Result::Book', 'author_id'
-);
-1;
-</pre>
+ <h1>Extensible: DBIC::Helpers</h1>
+ <ul class="incremental">
+ <li>DBIx::Class::Helper::ResultSet::IgnoreWantarray</li>
+ <li>DBIx::Class::Helper::ResultSet::Random</li>
+ <li>DBIx::Class::Helper::ResultSet::SetOperations</li>
+ <li>DBIx::Class::Helper::Row::JoinTable</li>
+ <li>DBIx::Class::Helper::Row::NumifyGet</li>
+ <li>DBIx::Class::Helper::Row::SubClass</li>
+ <li>DBIx::Class::Helper::Row::ToJSON</li>
+ </ul>
</div>
<div class="slide">
-<pre>package MyApp::Schema::Result::Book;
-use strict; use warnings;
-__PACKAGE__->table('books');
-__PACKAGE__->add_columns(
- id => {
- data_type => 'int',
- size => 8,
- },
- name => {
- data_type => 'varchar',
- is_nullable => 1,
- size => 255,
- },
- author_id => {
- data_type => 'int',
- size => 8,
- is_nullable => 1, # <-- probably should be 0
- },
-);
-__PACKAGE__->set_primary_key('id');
-__PACKAGE__->belongs_to( author =>
- 'MyApp::Schema::Result::Author', 'author_id'
-);
-1;
-</pre>
+ <h1>Extensible: DBIC::TimeStamp</h1>
+ <ul class="incremental">
+ <li>Cross DB</li>
+ <li>set_on_create</li>
+ <li>set_on_update</li>
+ </ul>
</div>
<div class="slide">
- <h1>Schema::Loader</h1>
- <p>DB -> Perl vs Perl -> DB</p>
-<pre>package MyApp::Schema;
-use strict; use warnings;
-use base 'DBIx::Class::Schema::Loader';
-__PACKAGE__->loader_options({
- naming => 'v7',
- debug => $ENV{DBIC_TRACE},
-});
-1;
-
-# elsewhere...
-
-my $schema = MyApp::Schema->connect($dsn, $user, $pass);
-</pre>
+ <h1>Extensible: DBIx::Class::Schema::KiokuDB</h1>
+ <ul class="incremental">
+ <li>Kioku is the new hotness</li>
+ <li>Mix RDBMS with Object DB</li>
+ <li>beta ( == sexy )</li>
+ </ul>
</div>
<div class="slide">
- <h1>splitting logic cleanly</h1>
- <p>Foo::Schema::Result::Foo = an individual row</p>
- <p>Foo::Schema::ResultSet::Foo = searches / results</p>
+ <h1>SQL::Abstract</h1>
+ <pre>my $resultset = $book_rs->search({
+ name => { -like => "%$nick%" },
+ });</pre>
+ <ul class="incremental">
+ <li>(kinda) introspectible</li>
+ <li>Prettier than SQL</li>
+ </ul>
</div>
<div class="slide">
- <h1>using your Schema</h1>
- <pre>example usage code goes here</pre>
+ <h1>Result vs ResultSet</h1>
+ <ul class="incremental">
+ <li>Result == Row</li>
+ <li>ResultSet == Query</li>
+ <li>(less important but...)</li>
+ <li>ResultSource == Table</li>
+ <li>Storage == Database</li>
+ </ul>
</div>
<div class="slide">
- <h1>DEBUGGING</h1>
- <pre>DBIC_TRACE=1 ./your_script.pl</pre>
+ <h1>ResultSet methods</h1>
+<pre>package MyApp::Schema::ResultSet::Book;
+use base 'DBIx::Class::ResultSet';
+sub good {
+ my $self = shift;
+ $self->search({
+ rating => { '>=' => 4 },
+ })
+};
+sub cheap {
+ my $self = shift;
+ $self->search({
+ price => { '<=' => 5}
+ })
+};
+# ...
+1;
+ </pre>
+ <ul class="incremental">
+ <li>All searches should be ResultSet methods</li>
+ <li>Name has obvious meaning</li>
+ </ul>
</div>
<div class="slide">
- <h1>Schema::Loader</h1>
-<pre>Foo::Schema::Result::Authors->table("authors");
-Foo::Schema::Result::Authors->add_columns(
- id => {
- data_type => "INT",
- default_value => undef,
- is_nullable => 0,
- size => 8
- },
- title => {
- data_type => "VARCHAR",
- default_value => undef,
- is_nullable => 1,
- size => 255,
- },
-);
-Foo::Schema::Result::Authors->set_primary_key("id");</pre>
+ <h1>ResultSet method in Action</h1>
+ <pre>$schema->resultset('Book')->good</pre>
</div>
<div class="slide">
- <h1>Schema::Loader</h1>
-<pre>Foo::Schema::Result::Books->table("books");
-Foo::Schema::Result::Books->add_columns(
- id => {
- data_type => "INT",
- default_value => undef,
- is_nullable => 0,
- size => 8
- },
- name => {
- data_type => "VARCHAR",
- default_value => undef,
- is_nullable => 1,
- size => 255,
- },
- author => {
- data_type => "INT",
- default_value => undef,
- is_nullable => 1,
- size => 8
- },
-);
-Foo::Schema::Result::Books->set_primary_key("id");</pre>
+ <h1>ResultSet Chaining</h1>
+<pre>$schema->resultset('Book')
+ ->good
+ ->cheap
+ ->recent
+</pre>
</div>
<div class="slide">
- <h1>Schema::Loader</h1>
-<pre>Foo::Schema::Result::Authors->has_many(books => "Foo::Schema::Books",
- { "foreign.author" => "self.id" });
-
-Foo::Schema::Result::Books->belongs_to(author => "Foo::Schema::Authors",
- { id => "author" });</pre>
+ <h1>DEBUGGING</h1>
+ <pre>DBIC_TRACE=1 ./your_script.pl</pre>
</div>
<div class="slide">
<div class="slide">
<h1>overloading</h1>
-<pre>Foo::Schema::Result::Books
-Foo::Schema::ResultSet::Books
-Foo::Schema::Result::Authors
-Foo::Schema::ResultSet::Books</pre>
+<pre>Foo::Schema::Result::Book
+Foo::Schema::ResultSet::Book
+Foo::Schema::Result::Author
+Foo::Schema::ResultSet::Book</pre>
</div>
<div class="slide">
<h1>Result::</h1>
-<pre>package Foo::Schema::Result::Books;
-use base 'DBIx::Class';
+<pre>package Foo::Schema::Result::Book;
+use base 'DBIx::Class::Core';
use strict;
use warnings;
+# Result code here
+
sub isbn {
my $self = shift;
<div class="slide">
<h1>Result:: (inflating)</h1>
-<pre>package Foo::Schema::Result::Books;
-use base 'DBIx::Class';
+<pre>package Foo::Schema::Result::Book;
+use base 'DBIx::Class::Core';
use strict;
use warnings;
+# Result code here
+
+__PACKAGE__->load_components('InflateColumn');
use DateTime::Format::MySQL;
__PACKAGE__-><strong>inflate_column</strong>(
<strong>date_published</strong> => {
inflate => sub { DateTime::Format::MySQL->parse_date(shift) },
deflate => sub { shift->ymd},
- }
-);
-# Automatic see: DBIx::Class::InflateColumn::DateTime</pre>
- </div>
-
- <div class="slide">
- <h1>Result:: (inflating)</h1>
-<pre>package Foo::Schema::Result::Books;
-use base 'DBIx::Class';
-use strict;
-use warnings;
-
-use DateTime::Format::MySQL;
-
-__PACKAGE__->inflate_column(
- date_published => {
- <strong>inflate => sub { DateTime::Format::MySQL->parse_date(shift) },
- deflate => sub { shift->ymd},</strong>
- }
+ },
);
-# Automatic see: DBIx::Class::InflateColumn::DateTime
-# Automatic see: DBIx::Class::InflateColumn::DateTime
# Automatic see: DBIx::Class::InflateColumn::DateTime</pre>
</div>
<div class="slide">
<h1>ResultSets::</h1>
-<pre>package Foo::Schema::<strong>ResultSet::Books</strong>;
-use base '<strong>DBIx::Class::ResultSet</strong>';
-sub the_ultimate_books {
- my $self = shift;
- <strong>return $self->search({ title => { -like => '%42%' } })</strong>
-}
-sub by_author {
- my ( $self, $author ) = @_;
- return $self->search({ author => $author->id })
-}
-
-1;</pre>
- </div>
-
- <div class="slide">
- <h1>ResultSets::</h1>
-<pre>package Foo::Schema::ResultSet::Books;
-use base 'DBIx::Class::ResultSet';
-sub the_ultimate_books {
- my $self = shift;
- return $self->search({ title => { -like => '%42%' } });
-}
-sub by_author {
- my ( $self, $author ) = @_;
- <strong>return $self->search({ author => $author->id })</strong>
-}
-
-1;</pre>
- </div>
-
- <div class="slide">
- <h1>ResultSets::</h1>
<pre>use Foo::Schema;
-my $book_model = Foo::Schema->resultset('Books');
-my $book_rs = $book_model->the_ultimate_books;
-my @books = $book_rs->all;</pre>
+my $schema = Foo::Schema->connect(...);
+my $book_rs = Foo::Schema->resultset('Book');
+my $book_search = $book_rs->the_ultimate_books;
+my @books = $book_search->all;</pre>
</div>
<div class="slide">
- <h1>ResultSets::chaining</h1>
-<pre>use Foo::Schema;
-my $book_model = Foo::Schema->resultset('Books');
-my $author_model = Foo::Schema->resultset('Authors');
-my $author = $author_model->search({ name => 'Douglas Adams' })->single;
-my $book_rs = $book_model->the_ultimate_books->by_author($author);
-my @books = $book_rs->all;</pre>
+ <h1>ResultSets: Chaining</h1>
+<pre>
+my $book_rs = $schema->resultset('Book');
+my $author_rs = $schema->resultset('Author');
+my $author = $author_rs->search({ name => 'Douglas Adams' })->single;
+$book_rs = $book_rs->the_ultimate_books->by_author($author);
+my @books = $book_rs->all;</pre>
</div>
<div class="slide">
- <h1>ResultSets::chaining</h1>
-<pre>my $book_rs = $book_model
+ <h1>ResultSets: Chaining</h1>
+<pre>$book_rs = $schema->resultset('Book')
->the_ultimate_books
->by_author($author);</pre>
or
-<pre>my $book_rs = $book_model
- ->the_ultimate_books();
+<pre>my $book_rs = $schema->resultset('Book')
+ ->the_ultimate_books;
$book_rs = $book_rs->by_author($author);</pre>
<pre># Debug (SQL):
</div>
<div class="slide">
- <h1>ResultSets::chaining</h1>
-<pre>my $rs = $book_model
+ <h1>ResultSets: Chaining</h1>
+<pre>my $rs = $book_rs
->category('childrens')
->by_author($author)
->published_after('1812')
<div class="slide">
<h1>overloading before new record</h1>
- </div>
-
- <div class="slide">
- <h1>overloading before new record</h1>
- <pre>package Foo::Schema::Result::Authors;
-use base 'DBIx::Class';
+ <pre>package Foo::Schema::Result::Author;
+use base 'DBIx::Class::Core';
sub new {
my ( $class, $attrs ) = @_;
1;</pre>
<div class="slide">
- <h1>relationships</h1>
+ <h1>Relationships</h1>
</div>
<div class="slide">
- <h1>multiple authors</h1>
+ <h1>Multiple Authors</h1>
+ <p>We want to allow a book to be by more than one author</p>
</div>
<div class="slide">
<h1>a few relationships</h1>
- (authors -- author_link_to_book -- books)
+ <img src="img/afewrels.png" />
</div>
<div class="slide">
- <h1>a few relationships</h1>
- !
- </div>
-
- <div class="slide">
- <h1>new join table</h1>
+ <h1>Join Table</h1>
<pre>CREATE TABLE author_and_books(
- id int(8) primary key auto_increment,
- book int(8),
- author int(8),
- foreign key (book) references books(id),
- foreign key (author) references authors(id)
+ book_id int(8),
+ author_id int(8),
+ foreign key (book_id) references books(id),
+ foreign key (author_id) references authors(id)
) engine = InnoDB DEFAULT CHARSET=utf8;
-ALTER TABLE `books` DROP `author`</pre>
- </div>
-
- <div class="slide">
- <h1>new join table</h1>
-<pre>CREATE TABLE author_and_books(
- id int(8) primary key auto_increment,
- book int(8),
- author int(8),
- <strong>foreign key (book) references books(id),
- foreign key (author) references authors(id)</strong>
-) engine = InnoDB DEFAULT CHARSET=utf8;
-
-ALTER TABLE `books` DROP `author`</pre>
+ALTER TABLE `books` DROP `author_id`;</pre>
</div>
<div class="slide">
<h1>has_many</h1>
+ <img src="img/hasmany1.png" />
</div>
<div class="slide">
<h1>has_many</h1>
-<pre>package Foo::Schema::<strong>Result::Books</strong>;
+<pre>package Foo::Schema::<strong>Result::Book</strong>;
-__PACKAGE__->has_many( author_and_books => "Foo::Schema::Result::AuthorAndBooks",
- { "foreign.book" => "self.id" },
+__PACKAGE__->has_many( author_and_books =>
+ 'Foo::Schema::Result::Author_Book', 'book_id'
);
-
-<strong># This is auto generated by Schema::Loader</strong></pre>
- </div>
-
- <div class="slide">
- <h1>has_many</h1>
-<pre>package Foo::Schema::<strong>Result::Books</strong>;
-
-__PACKAGE__->has_many(
-author_and_books => <strong># name of accessor</strong>
-"Foo::Schema::Result::AuthorAndBooks", <strong># related class</strong>
- { "foreign.book" => "self.id" } <strong># Relationship (magic often works if not
- # specified, but avoid!)</strong>
-);
-</pre>
</div>
<div class="slide">
<h1>belongs_to</h1>
+ <img src="img/belongsto1.png" />
</div>
<div class="slide">
<h1>belongs_to</h1>
-<pre>package Foo::Schema::<strong>Result::AuthorAndBooks</strong>;
+<pre>package Foo::Schema::<strong>Result::Author_Book</strong>;
__PACKAGE__->belongs_to(
- book => <strong># Accessor name</strong>
- "Foo::Schema::Result::Books", <strong># Related class</strong>
- { id => "book" } <strong># relationship</strong>
+ book =>
+ 'Foo::Schema::Result::Book', 'book_id'
);
</pre>
</div>
<div class="slide">
<h1>same for Authors</h1>
- </div>
-
- <div class="slide">
- <h1>with no coding...</h1>
+ <img src="img/authors.png" />
</div>
<div class="slide">
<h1>many_to_many</h1>
+ <img src="img/m2m.png" />
</div>
<div class="slide">
<h1>many_to_many</h1>
- <pre>package Foo::Schema::<strong>Result::Books</strong>;
-use base 'DBIx::Class';
+ <pre>package Foo::Schema::<strong>Result::Book</strong>;
+use base 'DBIx::Class::Core';
__PACKAGE__->many_to_many(
- authors => "author_and_books", 'author'
+ authors => 'author_and_books', 'author'
);
1;
-
-<strong> # This is <em>NOT</em> auto generated by Schema::Loader </strong></pre>
+</pre>
</div>
<div class="slide">
<h1>many_to_many</h1>
- <pre>package Foo::Schema::<strong>Result::Books</strong>;
-use base 'DBIx::Class';
+ <pre>package Foo::Schema::<strong>Result::Book</strong>;
+use base 'DBIx::Class::Core';
__PACKAGE__->many_to_many(
authors <strong># Accessor name</strong>
<div class="slide">
<h1>many_to_many</h1>
- <pre>package Foo::Schema::Result::Authors;
-use base 'DBIx::Class';
+ <pre>package Foo::Schema::Result::Author;
+use base 'DBIx::Class::Core';
__PACKAGE__->many_to_many(
"books" <strong># Accessor Name</strong>
);
1;
-
-<strong># This is <em>NOT</em> auto generated by Schema::Loader</strong></pre>
+</pre>
</div>
<div class="slide">
- <h1>using many_to_many</h1>
- <pre>#!/usr/bin/perl
-
+ <h1>Using many_to_many</h1>
+ <pre>#!perl
use Foo::Schema;
-
-my $author_model = Foo::Schema->resultset('Authors');
-my $author = $author_model->search({
+my $schema = Foo::Schema->connect(...);
+my $author_rs = $schema->resultset('Authors');
+my $author = $author_rs->search({
name => 'Douglas Adams',
})->single;
$author->add_to_books({
<div class="slide">
<h1>using many_to_many</h1>
- <pre>my $author = $author_model->search({
+ <pre>my $author = $author_rs->search({
name => 'Douglas Adams',
})->single;
<strong>$author->add_to_books({
</div>
<div class="slide">
- <h1>in 16 lines of code</h1>
- </div>
-
- <div class="slide">
<h1>errors</h1>
<p>Read them closely!</p>
</div>
<div class="slide">
<h1>error messages</h1>
- <pre>DBIx::Class::Schema::Loader::connection(): Failed to load external class definition for 'Foo::Schema::Result::Authors': Can't locate object method "many_to_many" via package "Foo::Schema::Result::Author" at lib/Foo/Schema/Result/Authors.pm line 9.Compilation failed in require at /Library/Perl/5.8.8/DBIx/Class/Schema/Loader/Base.pm line 292.</pre>
+<pre>DBIx::Class::Schema::Loader::connection(): Failed to load external
+class definition for 'Foo::Schema::Result::Authors': Can't locate object
+method "many_to_many" via package "Foo::Schema::Result::Author" at
+lib/Foo/Schema/Result/Authors.pm line 9.Compilation failed in require at
+/Library/Perl/5.8.8/DBIx/Class/Schema/Loader/Base.pm line 292.</pre>
</div>
<div class="slide">
<h1>error messages</h1>
- <pre>DBIx::Class::Schema::Loader::connection(): Failed to load external class definition for 'Foo::Schema::Result::Authors': Can't locate object method "many_to_many" via package "Foo::Schema::<strong>Result::Author</strong>" at lib/Foo/Schema/<strong>Result/Authors.pm</strong> line 9.Compilation failed in require at /Library/Perl/5.8.8/DBIx/Class/Schema/Loader/Base.pm line 292.</pre>
+<pre>DBIx::Class::Schema::Loader::connection(): Failed to load external
+class definition for 'Foo::Schema::Result::Authors': Can't locate object
+method "many_to_many" via package "Foo::Schema::<strong>Result::Author</strong>" at
+lib/Foo/Schema/<strong>Result/Authors.pm</strong> line 9.Compilation failed in require at
+/Library/Perl/5.8.8/DBIx/Class/Schema/Loader/Base.pm line 292.</pre>
</div>
<div class="slide">
</div>
<div class="slide">
+ <h1>LOTS more Features</h1>
+ <ul>
+ <li>FilterColumn</li>
+ <li>Transactions</li>
+ <li>HashRefInflator</li>
+ <li>Subqueries</li>
+ <li>ResultSetColumn</li>
+ <li>Aggregate Queries</li>
+ </ul>
+ </div>
+
+ <div class="slide">
<h1>bonus slides!</h1>
</div>
);
1;</pre>
- <p>Keep your Schema in a <em>separate</em> package to your Catalyst application</p>
+ <p>Keep your Schema in a <em>separate</em> package from your Catalyst application</p>
</div>
<div class="slide">
<pre>sub action_name : Local {
my ($self, $c) = @_;
- my $model = $c->model('Schema::Foo');
- my $author_model = $model->resultset('Authors');
+ my $schema = $c->model('Schema::Foo');
+ my $author_rs = $schema->resultset('Authors');
}
projects / dbsrgits/dbix-class-introduction-presentation.git / blobdiff