1 package # hide from PAUSE
2 DBIx::Class::Relationship::Accessor;
7 use DBIx::Class::_Util qw(quote_sub perlstring);
10 our %_pod_inherit_config =
12 class_map => { 'DBIx::Class::Relationship::Accessor' => 'DBIx::Class::Relationship' }
15 sub register_relationship {
16 my ($class, $rel, $info) = @_;
17 if (my $acc_type = $info->{attrs}{accessor}) {
18 $class->add_relationship_accessor($rel => $acc_type);
20 $class->next::method($rel => $info);
23 sub add_relationship_accessor {
24 my ($class, $rel, $acc_type) = @_;
26 if ($acc_type eq 'single') {
28 my @qsub_args = ( {}, {
30 DBIC_method_is_single_relationship_accessor
31 DBIC_method_is_generated_from_resultsource_metadata
36 quote_sub "${class}::${rel}" => sprintf(<<'EOC', perlstring $rel), @qsub_args;
40 $self->set_from_related( %1$s => @_ );
41 return $self->{_relationship_data}{%1$s} = $_[0];
43 elsif (exists $self->{_relationship_data}{%1$s}) {
44 return $self->{_relationship_data}{%1$s};
47 my $rsrc = $self->result_source;
49 my $relcond = $rsrc->_resolve_relationship_condition(
51 foreign_alias => %1$s,
53 self_result_object => $self,
57 $relcond->{join_free_condition}
59 $relcond->{join_free_condition} ne DBIx::Class::_Util::UNRESOLVABLE_CONDITION
61 scalar grep { not defined $_ } values %%{ $relcond->{join_free_condition} || {} }
63 $rsrc->relationship_info(%1$s)->{attrs}{undef_on_null_fk}
66 my $val = $self->related_resultset( %1$s )->single;
67 return $val unless $val; # $val instead of undef so that null-objects can go through
69 return $self->{_relationship_data}{%1$s} = $val;
73 elsif ($acc_type eq 'filter') {
75 my $rsrc = $class->result_source_instance;
77 $rsrc->throw_exception("No such column '$rel' to filter")
78 unless $rsrc->has_column($rel);
80 my $f_class = $rsrc->relationship_info($rel)->{class};
82 $class->inflate_column($rel, {
84 my ($val, $self) = @_;
85 return $self->find_or_new_related($rel, {});
88 my ($val, $self) = @_;
89 $self->throw_exception("'$val' isn't a $f_class") unless $val->isa($f_class);
91 # MASSIVE FIXME - this code assumes we pointed at the PK, but the belongs_to
92 # helper does not check any of this
93 # fixup the code a bit to make things saner, but ideally 'filter' needs to
94 # be deprecated ASAP and removed shortly after
95 # Not doing so before 0.08250 however, too many things in motion already
96 my ($pk_col, @rest) = $val->result_source->_pri_cols_or_die;
97 $self->throw_exception(
98 "Relationship '$rel' of type 'filter' can not work with a multicolumn primary key on source '$f_class'"
101 my $pk_val = $val->get_column($pk_col);
103 "Unable to deflate 'filter'-type relationship '$rel' (related object "
104 . "primary key not retrieved), assuming undef instead"
105 ) if ( ! defined $pk_val and $val->in_storage );
112 # god this is horrible...
114 $rsrc->columns_info->{$rel}{accessor}
119 # because CDBI may elect to never make an accessor at all...
120 if( my $main_cref = $class->can($acc) ) {
126 DBIC_method_is_filter_relationship_accessor
127 DBIC_method_is_generated_from_resultsource_metadata
131 if( my $extra_cref = $class->can("_${acc}_accessor") ) {
136 DBIC_method_is_filter_relationship_extra_accessor
137 DBIC_method_is_generated_from_resultsource_metadata
143 elsif ($acc_type eq 'multi') {
150 DBIC_method_is_multi_relationship_accessor
151 DBIC_method_is_generated_from_resultsource_metadata
152 DBIC_method_is_indirect_sugar
158 quote_sub "${class}::${rel}", sprintf( <<'EOC', perlstring $rel ), @qsub_args;
159 DBIx::Class::_ENV_::ASSERT_NO_INTERNAL_INDIRECT_CALLS and DBIx::Class::_Util::fail_on_internal_call;
160 DBIx::Class::_ENV_::ASSERT_NO_INTERNAL_WANTARRAY and my $sog = DBIx::Class::_Util::fail_on_internal_wantarray;
161 shift->related_resultset(%s)->search( @_ )
165 $qsub_args[1]{attributes}[0]
166 =~ s/^DBIC_method_is_multi_relationship_accessor$/DBIC_method_is_multi_relationship_extra_accessor/
167 or die "Unexpected attr '$qsub_args[1]{attributes}[0]' ...";
170 quote_sub "${class}::${rel}_rs", sprintf( <<'EOC', perlstring $rel ), @qsub_args;
171 DBIx::Class::_ENV_::ASSERT_NO_INTERNAL_INDIRECT_CALLS and DBIx::Class::_Util::fail_on_internal_call;
172 shift->related_resultset(%s)->search_rs( @_ )
176 quote_sub "${class}::add_to_${rel}", sprintf( <<'EOC', perlstring $rel ), @qsub_args;
177 DBIx::Class::_ENV_::ASSERT_NO_INTERNAL_INDIRECT_CALLS and DBIx::Class::_Util::fail_on_internal_call;
178 shift->create_related( %s => @_ );
183 $class->throw_exception("No such relationship accessor type '$acc_type'");