X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=blobdiff_plain;f=lib%2FDBIx%2FClass%2FRelationship%2FHasOne.pm;h=1578c63208a0213e7b5206bad6bb8167ff648687;hb=416e0bc0624a788f9e6389790b5beb20ced77a43;hp=ea97e7d6c7e8643328d8764f420a018db10e5f55;hpb=07037f89d4d9bf97c59a2c083de74f669521da47;p=dbsrgits%2FDBIx-Class.git diff --git a/lib/DBIx/Class/Relationship/HasOne.pm b/lib/DBIx/Class/Relationship/HasOne.pm index ea97e7d..1578c63 100644 --- a/lib/DBIx/Class/Relationship/HasOne.pm +++ b/lib/DBIx/Class/Relationship/HasOne.pm @@ -1,48 +1,90 @@ -package DBIx::Class::Relationship::HasOne; +package # hide from PAUSE + DBIx::Class::Relationship::HasOne; use strict; use warnings; +use Carp::Clan qw/^DBIx::Class/; + +our %_pod_inherit_config = + ( + class_map => { 'DBIx::Class::Relationship::HasOne' => 'DBIx::Class::Relationship' } + ); sub might_have { shift->_has_one('LEFT' => @_); } sub has_one { - shift->_has_one(undef => @_); + shift->_has_one(undef() => @_); } sub _has_one { - my ($class, $join_type, $rel, $f_class, @columns) = @_; - my $cond; - if (ref $columns[0]) { - $cond = shift @columns; - } else { - my ($pri, $too_many) = keys %{ $class->_primaries }; - $class->throw( "might_have/has_one can only infer join for a single primary key; ${class} has more" ) - if $too_many; - my $f_key; - if ($f_class->_columns->{$rel}) { + my ($class, $join_type, $rel, $f_class, $cond, $attrs) = @_; + unless (ref $cond) { + $class->ensure_class_loaded($f_class); + + my $pri = $class->_get_primary_key; + + $class->throw_exception( + "might_have/has_one needs a primary key to infer a join; ". + "${class} has none" + ) if !defined $pri && (!defined $cond || !length $cond); + + my $f_class_loaded = eval { $f_class->columns }; + my ($f_key,$too_many,$guess); + if (defined $cond && length $cond) { + $f_key = $cond; + $guess = "caller specified foreign key '$f_key'"; + } elsif ($f_class_loaded && $f_class->has_column($rel)) { $f_key = $rel; + $guess = "using given relationship '$rel' for foreign key"; } else { - ($f_key, $too_many) = keys %{ $f_class->_primaries }; - $class->throw( "might_have/has_one can only infer join for a single primary key; ${f_class} has more" ) - if $too_many; + $f_key = $class->_get_primary_key($f_class); + $guess = "using primary key of foreign class for foreign key"; } - $cond = { "foreign.${f_key}" => "self.${pri}" }, + $class->throw_exception( + "No such column ${f_key} on foreign class ${f_class} ($guess)" + ) if $f_class_loaded && !$f_class->has_column($f_key); + $cond = { "foreign.${f_key}" => "self.${pri}" }; } - shift(@columns) unless defined $columns[0]; # Explicit empty condition - my %attrs; - if (ref $columns[0] eq 'HASH') { - %attrs = %{shift @columns}; - } - shift(@columns) unless defined $columns[0]; # Explicit empty attrs + $class->_validate_cond($cond); $class->add_relationship($rel, $f_class, $cond, - { accessor => 'single', (@columns ? (proxy => \@columns) : ()), + { accessor => 'single', cascade_update => 1, cascade_delete => 1, ($join_type ? ('join_type' => $join_type) : ()), - %attrs }); + %{$attrs || {}} }); 1; } +sub _get_primary_key { + my ( $class, $target_class ) = @_; + $target_class ||= $class; + my ($pri, $too_many) = $target_class->primary_columns; + $class->throw_exception( + "might_have/has_one can only infer join for a single primary key; ". + "${class} has more" + ) if $too_many; + return $pri; +} + +sub _validate_cond { + my ($class, $cond ) = @_; + + return if $ENV{DBIC_DONT_VALIDATE_RELS}; + return unless 'HASH' eq ref $cond; + foreach my $foreign_id ( keys %$cond ) { + my $self_id = $cond->{$foreign_id}; + + # we can ignore a bad $self_id because add_relationship handles this + # warning + return unless $self_id =~ /^self\.(.*)$/; + my $key = $1; + my $column_info = $class->column_info($key); + if ( $column_info->{is_nullable} ) { + carp(qq'"might_have/has_one" must not be on columns with is_nullable set to true ($class/$key). This might indicate an incorrect use of those relationship helpers instead of belongs_to.'); + } + } +} + 1;