X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=blobdiff_plain;f=lib%2FDBIx%2FClass%2FRelationship.pm;h=48829243cbe5c63a37e703f456b8ae30fc3113cd;hb=be64931c710bcde7abe7334349b4c8a123645332;hp=29a7ffccfa76970fcd6087aa585f0553dce8a2f1;hpb=6c4f4d69a8ec24b5e76bef0eb9c0d837d8e694ab;p=dbsrgits%2FDBIx-Class.git diff --git a/lib/DBIx/Class/Relationship.pm b/lib/DBIx/Class/Relationship.pm index 29a7ffc..4882924 100644 --- a/lib/DBIx/Class/Relationship.pm +++ b/lib/DBIx/Class/Relationship.pm @@ -20,15 +20,15 @@ DBIx::Class::Relationship - Inter-table relationships =head1 SYNOPSIS ## Creating relationships - MyDB::Schema::Actor->has_many('actorroles' => 'MyDB::Schema::ActorRole', + MyApp::Schema::Actor->has_many('actorroles' => 'MyApp::Schema::ActorRole', 'actor'); - MyDB::Schema::Role->has_many('actorroles' => 'MyDB::Schema::ActorRole', + MyApp::Schema::Role->has_many('actorroles' => 'MyApp::Schema::ActorRole', 'role'); - MyDB::Schema::ActorRole->belongs_to('role' => 'MyDB::Schema::Role'); - MyDB::Schema::ActorRole->belongs_to('actor' => 'MyDB::Schema::Actor'); + MyApp::Schema::ActorRole->belongs_to('role' => 'MyApp::Schema::Role'); + MyApp::Schema::ActorRole->belongs_to('actor' => 'MyApp::Schema::Actor'); - MyDB::Schema::Role->many_to_many('actors' => 'actorroles', 'actor'); - MyDB::Schema::Actor->many_to_many('roles' => 'actorroles', 'role'); + MyApp::Schema::Role->many_to_many('actors' => 'actorroles', 'actor'); + MyApp::Schema::Actor->many_to_many('roles' => 'actorroles', 'role'); ## Using relationships $schema->resultset('Actor')->find({ id => 1})->roles(); @@ -159,14 +159,14 @@ OR =item cond A hashref, arrayref or coderef specifying a custom join expression. For -more info see L. +more info see L. =back # in a Book class (where Author has many Books) - My::DBIC::Schema::Book->belongs_to( - author => - 'My::DBIC::Schema::Author', + My::DBIC::Schema::Book->belongs_to( + author => + 'My::DBIC::Schema::Author', 'author_id' ); @@ -174,11 +174,11 @@ more info see L. My::DBIC::Schema::Book->belongs_to( author => 'My::DBIC::Schema::Author', - { 'foreign.author_id' => 'self.author_id' } + { 'foreign.author_id' => 'self.author_id' } ); # OR (similar result but uglier accessor name) - My::DBIC::Schema::Book->belongs_to( + My::DBIC::Schema::Book->belongs_to( author_id => 'My::DBIC::Schema::Author' ); @@ -203,9 +203,9 @@ declaration is shown below: # in a Book class (where Author has_many Books) __PACKAGE__->belongs_to( - author => + author => 'My::DBIC::Schema::Author', - 'author', + 'author', { join_type => 'left' } ); @@ -237,7 +237,7 @@ which can be assigned to relationships as well. Creates a one-to-many relationship where the foreign class refers to this class's primary key. This relationship refers to zero or more -records in the foreign table (e.g. a C). This relationship +records in the foreign table (e.g. a C). This relationship defaults to using the end of this classes namespace as the foreign key in C<$related_class> to resolve the join, unless C<$their_fk_column> specifies the foreign key column in C<$related_class> or C @@ -271,35 +271,35 @@ OR =item cond A hashref, arrayref or coderef specifying a custom join expression. For -more info see L. +more info see L. =back # in an Author class (where Author has_many Books) # assuming related class is storing our PK in "author_id" My::DBIC::Schema::Author->has_many( - books => - 'My::DBIC::Schema::Book', + books => + 'My::DBIC::Schema::Book', 'author_id' ); # OR (same result) My::DBIC::Schema::Author->has_many( - books => - 'My::DBIC::Schema::Book', + books => + 'My::DBIC::Schema::Book', { 'foreign.author_id' => 'self.id' }, ); # OR (similar result, assuming related_class is storing our PK, in "author") # (the "author" is guessed at from "Author" in the class namespace) My::DBIC::Schema::Author->has_many( - books => - 'My::DBIC::Schema::Book', + books => + 'My::DBIC::Schema::Book', ); # Usage - # resultset of Books belonging to author + # resultset of Books belonging to author my $booklist = $author->books; # resultset of Books belonging to author, restricted by author name @@ -392,7 +392,7 @@ OR =item cond A hashref, arrayref or coderef specifying a custom join expression. For -more info see L. +more info see L. =back @@ -487,26 +487,26 @@ OR =item cond A hashref, arrayref or coderef specifying a custom join expression. For -more info see L. +more info see L. =back # Every book has exactly one ISBN My::DBIC::Schema::Book->has_one( - isbn => + isbn => 'My::DBIC::Schema::ISBN', 'book_id', ); # OR (same result, assuming related_class stores our PK) My::DBIC::Schema::Book->has_one( - isbn => + isbn => 'My::DBIC::Schema::ISBN', ); # OR (same result) My::DBIC::Schema::Book->has_one( - isbn => + isbn => 'My::DBIC::Schema::ISBN', { 'foreign.book_id' => 'self.id' }, ); @@ -553,8 +553,8 @@ L. C is not strictly a relationship in its own right. Instead, it is a bridge between two resultsets which provide the same kind of convenience -accessors as true relationships provide. Although the accessor will return a -resultset or collection of objects just like has_many does, you cannot call +accessors as true relationships provide. Although the accessor will return a +resultset or collection of objects just like has_many does, you cannot call C and similar methods which operate on true relationships. =over