X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=blobdiff_plain;f=lib%2FDBIx%2FClass%2FRelationship.pm;h=48829243cbe5c63a37e703f456b8ae30fc3113cd;hb=d6b39e463d43250ea171fa983b2364227172266f;hp=d4141d13c01f3bfdfdf5c34f56ebfeb16adbc7be;hpb=03460bef425a7626fc5e3ce4b25b66fa347f5c23;p=dbsrgits%2FDBIx-Class.git diff --git a/lib/DBIx/Class/Relationship.pm b/lib/DBIx/Class/Relationship.pm index d4141d1..4882924 100644 --- a/lib/DBIx/Class/Relationship.pm +++ b/lib/DBIx/Class/Relationship.pm @@ -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