added tests for required modules, minor documentation update
[dbsrgits/DBIx-Class.git] / lib / DBIx / Class / Relationship / HasMany.pm
CommitLineData
75d07914 1package # hide from PAUSE
c0e7b4e5 2 DBIx::Class::Relationship::HasMany;
07037f89 3
4use strict;
5use warnings;
6
7sub has_many {
8 my ($class, $rel, $f_class, $cond, $attrs) = @_;
c037c03a 9
dcf8330b 10 unless (ref $cond) {
fd4df975 11 $class->ensure_class_loaded($f_class);
103647d5 12 my ($pri, $too_many) = $class->primary_columns;
fd4df975 13
14 $class->throw_exception(
15 "has_many can only infer join for a single primary key; ".
16 "${class} has more"
17 ) if $too_many;
aeb1bf75 18
e36de82e 19 $class->throw_exception(
20 "has_many needs a primary key to infer a join; ".
21 "${class} has none"
22 ) if !defined $pri && (!defined $cond || !length $cond);
23
aeb1bf75 24 my ($f_key,$guess);
07037f89 25 if (defined $cond && length $cond) {
26 $f_key = $cond;
dcf8330b 27 $guess = "caller specified foreign key '$f_key'";
07037f89 28 } else {
29 $class =~ /([^\:]+)$/;
dcf8330b 30 $f_key = lc $1; # go ahead and guess; best we can do
31 $guess = "using our class name '$class' as foreign key";
07037f89 32 }
aeb1bf75 33
34 my $f_class_loaded = eval { $f_class->columns };
303cf522 35 $class->throw_exception(
36 "No such column ${f_key} on foreign class ${f_class} ($guess)"
37 ) if $f_class_loaded && !$f_class->has_column($f_key);
aeb1bf75 38
8e04bf91 39 $cond = { "foreign.${f_key}" => "self.${pri}" };
07037f89 40 }
41
303cf522 42 $class->add_relationship($rel, $f_class, $cond, {
43 accessor => 'multi',
44 join_type => 'LEFT',
45 cascade_delete => 1,
46 cascade_copy => 1,
47 %{$attrs||{}}
48 });
07037f89 49}
50
511;