Commit | Line | Data |
996be9ee |
1 | package DBIx::Class::Schema::Loader::RelBuilder; |
2 | |
3 | use strict; |
4 | use warnings; |
1ad8e8c3 |
5 | use base 'Class::Accessor::Grouped'; |
942bd5e0 |
6 | use mro 'c3'; |
fa994d3c |
7 | use Carp::Clan qw/^DBIx::Class/; |
1ad8e8c3 |
8 | use Scalar::Util 'weaken'; |
ecf22f0a |
9 | use DBIx::Class::Schema::Loader::Utils qw/split_name slurp_file array_eq apply uniq/; |
1ad8e8c3 |
10 | use Try::Tiny; |
ecf22f0a |
11 | use List::Util qw/all any first/; |
1ad8e8c3 |
12 | use namespace::clean; |
c4a69b87 |
13 | use Lingua::EN::Inflect::Phrase (); |
14 | use Lingua::EN::Tagger (); |
5975bbe6 |
15 | use String::ToIdentifier::EN (); |
16 | use String::ToIdentifier::EN::Unicode (); |
c4a69b87 |
17 | use Class::Unload (); |
18 | use Class::Inspector (); |
996be9ee |
19 | |
6bef6696 |
20 | our $VERSION = '0.07043'; |
32f784fc |
21 | |
6e4b7bb1 |
22 | # Glossary: |
23 | # |
d75f8e79 |
24 | # local_relname -- name of relationship from the local table referring to the remote table |
25 | # remote_relname -- name of relationship from the remote table referring to the local table |
6e4b7bb1 |
26 | # remote_method -- relationship type from remote table to local table, usually has_many |
27 | |
996be9ee |
28 | =head1 NAME |
29 | |
30 | DBIx::Class::Schema::Loader::RelBuilder - Builds relationships for DBIx::Class::Schema::Loader |
31 | |
32 | =head1 SYNOPSIS |
33 | |
19b7d71c |
34 | See L<DBIx::Class::Schema::Loader> and L<DBIx::Class::Schema::Loader::Base>. |
996be9ee |
35 | |
36 | =head1 DESCRIPTION |
37 | |
38 | This class builds relationships for L<DBIx::Class::Schema::Loader>. This |
39 | is module is not (yet) for external use. |
40 | |
41 | =head1 METHODS |
42 | |
43 | =head2 new |
44 | |
404aefa4 |
45 | Arguments: $loader object |
996be9ee |
46 | |
47 | =head2 generate_code |
48 | |
9dedee1f |
49 | Arguments: |
50 | |
c4a69b87 |
51 | [ |
52 | [ local_moniker1 (scalar), fk_info1 (arrayref), uniq_info1 (arrayref) ] |
53 | [ local_moniker2 (scalar), fk_info2 (arrayref), uniq_info2 (arrayref) ] |
dc379dc6 |
54 | ... |
c4a69b87 |
55 | ] |
e8ad6491 |
56 | |
dc379dc6 |
57 | This generates the code for the relationships of each table. |
e8ad6491 |
58 | |
59 | C<local_moniker> is the moniker name of the table which had the REFERENCES |
60 | statements. The fk_info arrayref's contents should take the form: |
61 | |
62 | [ |
63 | { |
c4a69b87 |
64 | local_table => 'some_table', |
65 | local_moniker => 'SomeTable', |
66 | local_columns => [ 'col2', 'col3' ], |
67 | remote_table => 'another_table_moniker', |
e8ad6491 |
68 | remote_moniker => 'AnotherTableMoniker', |
c4a69b87 |
69 | remote_columns => [ 'col5', 'col7' ], |
e8ad6491 |
70 | }, |
71 | { |
c4a69b87 |
72 | local_table => 'some_other_table', |
73 | local_moniker => 'SomeOtherTable', |
74 | local_columns => [ 'col1', 'col4' ], |
75 | remote_table => 'yet_another_table_moniker', |
e8ad6491 |
76 | remote_moniker => 'YetAnotherTableMoniker', |
c4a69b87 |
77 | remote_columns => [ 'col1', 'col2' ], |
e8ad6491 |
78 | }, |
79 | # ... |
80 | ], |
81 | |
dc379dc6 |
82 | The uniq_info arrayref's contents should take the form: |
83 | |
84 | [ |
85 | [ |
86 | uniq_constraint_name => [ 'col1', 'col2' ], |
87 | ], |
88 | [ |
89 | another_uniq_constraint_name => [ 'col1', 'col2' ], |
90 | ], |
91 | ], |
92 | |
e8ad6491 |
93 | This method will return the generated relationships as a hashref keyed on the |
94 | class names. The values are arrayrefs of hashes containing method name and |
95 | arguments, like so: |
996be9ee |
96 | |
494e0205 |
97 | { |
98 | 'Some::Source::Class' => [ |
99 | { method => 'belongs_to', arguments => [ |
100 | 'col1', 'Another::Source::Class' ] }, |
101 | { method => 'has_many', arguments => [ |
102 | 'anothers', 'Yet::Another::Source::Class', 'col15' ] }, |
103 | ], |
104 | 'Another::Source::Class' => [ |
105 | # ... |
106 | ], |
107 | # ... |
108 | } |
8f9d7ce5 |
109 | |
996be9ee |
110 | =cut |
111 | |
1ad8e8c3 |
112 | __PACKAGE__->mk_group_accessors('simple', qw/ |
404aefa4 |
113 | loader |
1ad8e8c3 |
114 | schema |
115 | inflect_plural |
116 | inflect_singular |
117 | relationship_attrs |
a7116285 |
118 | rel_collision_map |
59388920 |
119 | rel_name_map |
f08818c4 |
120 | allow_extra_m2m_cols |
1ad8e8c3 |
121 | _temp_classes |
dc379dc6 |
122 | __tagger |
1ad8e8c3 |
123 | /); |
4c7b5f46 |
124 | |
996be9ee |
125 | sub new { |
404aefa4 |
126 | my ($class, $loader) = @_; |
4c7b5f46 |
127 | |
128 | # from old POD about this constructor: |
129 | # C<$schema_class> should be a schema class name, where the source |
130 | # classes have already been set up and registered. Column info, |
131 | # primary key, and unique constraints will be drawn from this |
132 | # schema for all of the existing source monikers. |
133 | |
134 | # Options inflect_plural and inflect_singular are optional, and |
135 | # are better documented in L<DBIx::Class::Schema::Loader::Base>. |
996be9ee |
136 | |
137 | my $self = { |
404aefa4 |
138 | loader => $loader, |
f08818c4 |
139 | (map { $_ => $loader->$_ } qw( |
140 | schema inflect_plural inflect_singular |
141 | relationship_attrs rel_collision_map |
142 | rel_name_map allow_extra_m2m_cols |
143 | )), |
1ad8e8c3 |
144 | _temp_classes => [], |
996be9ee |
145 | }; |
146 | |
404aefa4 |
147 | weaken $self->{loader}; #< don't leak |
1ad8e8c3 |
148 | |
149 | bless $self => $class; |
4c7b5f46 |
150 | |
c8c27020 |
151 | # validate the relationship_attrs arg |
1ad8e8c3 |
152 | if( defined $self->relationship_attrs ) { |
7b6a8d73 |
153 | (ref $self->relationship_attrs eq 'HASH' || ref $self->relationship_attrs eq 'CODE') |
154 | or croak "relationship_attrs must be a hashref or coderef"; |
c8c27020 |
155 | } |
996be9ee |
156 | |
1ad8e8c3 |
157 | return $self; |
996be9ee |
158 | } |
159 | |
160 | |
161 | # pluralize a relationship name |
162 | sub _inflect_plural { |
ecf930e6 |
163 | my ($self, $relname) = @_; |
996be9ee |
164 | |
39ef3bfe |
165 | return '' if !defined $relname || $relname eq ''; |
166 | |
59388920 |
167 | my $result; |
168 | my $mapped = 0; |
169 | |
1ad8e8c3 |
170 | if( ref $self->inflect_plural eq 'HASH' ) { |
59388920 |
171 | if (exists $self->inflect_plural->{$relname}) { |
172 | $result = $self->inflect_plural->{$relname}; |
173 | $mapped = 1; |
174 | } |
996be9ee |
175 | } |
1ad8e8c3 |
176 | elsif( ref $self->inflect_plural eq 'CODE' ) { |
177 | my $inflected = $self->inflect_plural->($relname); |
59388920 |
178 | if ($inflected) { |
179 | $result = $inflected; |
180 | $mapped = 1; |
181 | } |
996be9ee |
182 | } |
183 | |
59388920 |
184 | return ($result, $mapped) if $mapped; |
185 | |
186 | return ($self->_to_PL($relname), 0); |
996be9ee |
187 | } |
188 | |
189 | # Singularize a relationship name |
190 | sub _inflect_singular { |
ecf930e6 |
191 | my ($self, $relname) = @_; |
996be9ee |
192 | |
39ef3bfe |
193 | return '' if !defined $relname || $relname eq ''; |
194 | |
59388920 |
195 | my $result; |
196 | my $mapped = 0; |
197 | |
1ad8e8c3 |
198 | if( ref $self->inflect_singular eq 'HASH' ) { |
59388920 |
199 | if (exists $self->inflect_singular->{$relname}) { |
200 | $result = $self->inflect_singular->{$relname}; |
201 | $mapped = 1; |
202 | } |
996be9ee |
203 | } |
1ad8e8c3 |
204 | elsif( ref $self->inflect_singular eq 'CODE' ) { |
205 | my $inflected = $self->inflect_singular->($relname); |
59388920 |
206 | if ($inflected) { |
207 | $result = $inflected; |
208 | $mapped = 1; |
209 | } |
996be9ee |
210 | } |
211 | |
59388920 |
212 | return ($result, $mapped) if $mapped; |
213 | |
214 | return ($self->_to_S($relname), 0); |
c496748b |
215 | } |
216 | |
217 | sub _to_PL { |
218 | my ($self, $name) = @_; |
219 | |
220 | $name =~ s/_/ /g; |
39b22ca9 |
221 | my $plural = Lingua::EN::Inflect::Phrase::to_PL($name); |
c496748b |
222 | $plural =~ s/ /_/g; |
223 | |
224 | return $plural; |
225 | } |
226 | |
c496748b |
227 | sub _to_S { |
228 | my ($self, $name) = @_; |
229 | |
39b22ca9 |
230 | $name =~ s/_/ /g; |
231 | my $singular = Lingua::EN::Inflect::Phrase::to_S($name); |
232 | $singular =~ s/ /_/g; |
233 | |
234 | return $singular; |
996be9ee |
235 | } |
236 | |
53ef681d |
237 | sub _default_relationship_attrs { +{ |
238 | has_many => { |
239 | cascade_delete => 0, |
240 | cascade_copy => 0, |
241 | }, |
242 | might_have => { |
243 | cascade_delete => 0, |
244 | cascade_copy => 0, |
245 | }, |
246 | belongs_to => { |
247 | on_delete => 'CASCADE', |
248 | on_update => 'CASCADE', |
aa0867ee |
249 | is_deferrable => 1, |
53ef681d |
250 | }, |
251 | } } |
252 | |
9dedee1f |
253 | # Accessor for options to be passed to each generated relationship type. takes |
254 | # the relationship type name and optionally any attributes from the database |
255 | # (such as FK ON DELETE/UPDATE and DEFERRABLE clauses), and returns a |
256 | # hashref or undef if nothing is set. |
257 | # |
258 | # The attributes from the database override the default attributes, which in |
259 | # turn are overridden by user supplied attributes. |
c8c27020 |
260 | sub _relationship_attrs { |
7b6a8d73 |
261 | my ( $self, $reltype, $db_attrs, $params ) = @_; |
1ad8e8c3 |
262 | my $r = $self->relationship_attrs; |
c8c27020 |
263 | |
53ef681d |
264 | my %composite = ( |
265 | %{ $self->_default_relationship_attrs->{$reltype} || {} }, |
9dedee1f |
266 | %{ $db_attrs || {} }, |
7b6a8d73 |
267 | ( |
268 | ref $r eq 'HASH' ? ( |
269 | %{ $r->{all} || {} }, |
270 | %{ $r->{$reltype} || {} }, |
271 | ) |
272 | : |
273 | () |
274 | ), |
53ef681d |
275 | ); |
276 | |
7b6a8d73 |
277 | if (ref $r eq 'CODE') { |
278 | $params->{attrs} = \%composite; |
279 | |
280 | my %ret = %{ $r->(%$params) || {} }; |
281 | |
282 | %composite = %ret if %ret; |
283 | } |
284 | |
9dedee1f |
285 | return %composite ? \%composite : undef; |
c8c27020 |
286 | } |
287 | |
ccf9b8a6 |
288 | sub _strip_id_postfix { |
289 | my ($self, $name) = @_; |
290 | |
291 | $name =~ s/_?(?:id|ref|cd|code|num)\z//i; |
292 | |
293 | return $name; |
294 | } |
295 | |
c39e403e |
296 | sub _remote_attrs { |
7b6a8d73 |
297 | my ($self, $local_moniker, $local_cols, $fk_attrs, $params) = @_; |
c39e403e |
298 | |
9dedee1f |
299 | # get our set of attrs from _relationship_attrs, which uses the FK attrs if available |
7b6a8d73 |
300 | my $attrs = $self->_relationship_attrs('belongs_to', $fk_attrs, $params) || {}; |
c8c27020 |
301 | |
eaf23084 |
302 | # If any referring column is nullable, make 'belongs_to' an |
c496748b |
303 | # outer join, unless explicitly set by relationship_attrs |
eaf23084 |
304 | my $nullable = first { $self->schema->source($local_moniker)->column_info($_)->{is_nullable} } @$local_cols; |
c496748b |
305 | $attrs->{join_type} = 'LEFT' if $nullable && !defined $attrs->{join_type}; |
c39e403e |
306 | |
c496748b |
307 | return $attrs; |
c39e403e |
308 | } |
309 | |
414c61a0 |
310 | sub _sanitize_name { |
311 | my ($self, $name) = @_; |
312 | |
df35916c |
313 | $name = $self->loader->_to_identifier('relationships', $name, '_'); |
314 | |
315 | $name =~ s/\W+/_/g; # if naming >= 8 to_identifier takes care of it |
414c61a0 |
316 | |
317 | return $name; |
318 | } |
319 | |
19b7d71c |
320 | sub _normalize_name { |
321 | my ($self, $name) = @_; |
322 | |
414c61a0 |
323 | $name = $self->_sanitize_name($name); |
324 | |
ea3b8f03 |
325 | my @words = split_name $name, $self->loader->_get_naming_v('relationships'); |
19b7d71c |
326 | |
327 | return join '_', map lc, @words; |
328 | } |
329 | |
d75f8e79 |
330 | sub _local_relname { |
f2fc8d01 |
331 | my ($self, $remote_table, $cond) = @_; |
332 | |
d75f8e79 |
333 | my $local_relname; |
f2fc8d01 |
334 | # for single-column case, set the remote relname to the column |
335 | # name, to make filter accessors work, but strip trailing _id |
336 | if(scalar keys %{$cond} == 1) { |
337 | my ($col) = values %{$cond}; |
ccf9b8a6 |
338 | $col = $self->_strip_id_postfix($self->_normalize_name($col)); |
d75f8e79 |
339 | ($local_relname) = $self->_inflect_singular($col); |
f2fc8d01 |
340 | } |
341 | else { |
d75f8e79 |
342 | ($local_relname) = $self->_inflect_singular($self->_normalize_name($remote_table)); |
f2fc8d01 |
343 | } |
344 | |
d75f8e79 |
345 | return $local_relname; |
f2fc8d01 |
346 | } |
347 | |
a7116285 |
348 | sub _resolve_relname_collision { |
349 | my ($self, $moniker, $cols, $relname) = @_; |
350 | |
351 | return $relname if $relname eq 'id'; # this shouldn't happen, but just in case |
352 | |
c4a69b87 |
353 | my $table = $self->loader->moniker_to_table->{$moniker}; |
dc379dc6 |
354 | |
404aefa4 |
355 | if ($self->loader->_is_result_class_method($relname, $table)) { |
a7116285 |
356 | if (my $map = $self->rel_collision_map) { |
357 | for my $re (keys %$map) { |
358 | if (my @matches = $relname =~ /$re/) { |
359 | return sprintf $map->{$re}, @matches; |
360 | } |
361 | } |
362 | } |
363 | |
364 | my $new_relname = $relname; |
404aefa4 |
365 | while ($self->loader->_is_result_class_method($new_relname, $table)) { |
a7116285 |
366 | $new_relname .= '_rel' |
367 | } |
368 | |
369 | warn <<"EOF"; |
c4a69b87 |
370 | Relationship '$relname' in source '$moniker' for columns '@{[ join ',', @$cols ]}' collides with an inherited method. Renaming to '$new_relname'. |
a7116285 |
371 | See "RELATIONSHIP NAME COLLISIONS" in perldoc DBIx::Class::Schema::Loader::Base . |
372 | EOF |
373 | |
374 | return $new_relname; |
375 | } |
376 | |
377 | return $relname; |
378 | } |
379 | |
996be9ee |
380 | sub generate_code { |
dc379dc6 |
381 | my ($self, $tables) = @_; |
9dedee1f |
382 | |
dc379dc6 |
383 | # make a copy to destroy |
384 | my @tables = @$tables; |
996be9ee |
385 | |
386 | my $all_code = {}; |
387 | |
dc379dc6 |
388 | while (my ($local_moniker, $rels, $uniqs) = @{ shift @tables || [] }) { |
389 | my $local_class = $self->schema->class($local_moniker); |
057fbb08 |
390 | |
dc379dc6 |
391 | my %counters; |
392 | foreach my $rel (@$rels) { |
393 | next if !$rel->{remote_source}; |
394 | $counters{$rel->{remote_source}}++; |
395 | } |
e8ad6491 |
396 | |
dc379dc6 |
397 | foreach my $rel (@$rels) { |
398 | my $remote_moniker = $rel->{remote_source} |
399 | or next; |
057fbb08 |
400 | |
dc379dc6 |
401 | my $remote_class = $self->schema->class($remote_moniker); |
402 | my $remote_obj = $self->schema->source($remote_moniker); |
403 | my $remote_cols = $rel->{remote_columns} || [ $remote_obj->primary_columns ]; |
057fbb08 |
404 | |
dc379dc6 |
405 | my $local_cols = $rel->{local_columns}; |
e8ad6491 |
406 | |
dc379dc6 |
407 | if($#$local_cols != $#$remote_cols) { |
408 | croak "Column count mismatch: $local_moniker (@$local_cols) " |
409 | . "$remote_moniker (@$remote_cols)"; |
410 | } |
996be9ee |
411 | |
dc379dc6 |
412 | my %cond; |
a00a81fd |
413 | @cond{@$remote_cols} = @$local_cols; |
dc379dc6 |
414 | |
45b70e6c |
415 | my ( $local_relname, $remote_relname, $remote_method ) = |
dc379dc6 |
416 | $self->_relnames_and_method( $local_moniker, $rel, \%cond, $uniqs, \%counters ); |
59388920 |
417 | my $local_method = 'belongs_to'; |
418 | |
d75f8e79 |
419 | ($local_relname) = $self->_rel_name_map( |
420 | $local_relname, $local_method, |
edf3eb39 |
421 | $local_class, $local_moniker, $local_cols, |
422 | $remote_class, $remote_moniker, $remote_cols, |
423 | ); |
d75f8e79 |
424 | ($remote_relname) = $self->_rel_name_map( |
425 | $remote_relname, $remote_method, |
edf3eb39 |
426 | $remote_class, $remote_moniker, $remote_cols, |
427 | $local_class, $local_moniker, $local_cols, |
428 | ); |
dc379dc6 |
429 | |
edf3eb39 |
430 | $local_relname = $self->_resolve_relname_collision( |
d75f8e79 |
431 | $local_moniker, $local_cols, $local_relname, |
432 | ); |
433 | $remote_relname = $self->_resolve_relname_collision( |
434 | $remote_moniker, $remote_cols, $remote_relname, |
edf3eb39 |
435 | ); |
dc379dc6 |
436 | |
7b6a8d73 |
437 | my $rel_attrs_params = { |
d75f8e79 |
438 | rel_name => $local_relname, |
3492170f |
439 | rel_type => $local_method, |
7b6a8d73 |
440 | local_source => $self->schema->source($local_moniker), |
441 | remote_source => $self->schema->source($remote_moniker), |
442 | local_table => $rel->{local_table}, |
443 | local_cols => $local_cols, |
444 | remote_table => $rel->{remote_table}, |
445 | remote_cols => $remote_cols, |
446 | }; |
447 | |
edf3eb39 |
448 | push @{$all_code->{$local_class}}, { |
449 | method => $local_method, |
450 | args => [ |
d75f8e79 |
451 | $local_relname, |
edf3eb39 |
452 | $remote_class, |
453 | \%cond, |
454 | $self->_remote_attrs($local_moniker, $local_cols, $rel->{attrs}, $rel_attrs_params), |
455 | ], |
456 | extra => { |
457 | local_class => $local_class, |
458 | local_moniker => $local_moniker, |
459 | remote_moniker => $remote_moniker, |
460 | }, |
461 | }; |
dc379dc6 |
462 | |
463 | my %rev_cond = reverse %cond; |
464 | for (keys %rev_cond) { |
465 | $rev_cond{"foreign.$_"} = "self.".$rev_cond{$_}; |
466 | delete $rev_cond{$_}; |
467 | } |
468 | |
7b6a8d73 |
469 | $rel_attrs_params = { |
d75f8e79 |
470 | rel_name => $remote_relname, |
3492170f |
471 | rel_type => $remote_method, |
7b6a8d73 |
472 | local_source => $self->schema->source($remote_moniker), |
473 | remote_source => $self->schema->source($local_moniker), |
474 | local_table => $rel->{remote_table}, |
475 | local_cols => $remote_cols, |
476 | remote_table => $rel->{local_table}, |
477 | remote_cols => $local_cols, |
478 | }; |
479 | |
edf3eb39 |
480 | push @{$all_code->{$remote_class}}, { |
481 | method => $remote_method, |
482 | args => [ |
d75f8e79 |
483 | $remote_relname, |
edf3eb39 |
484 | $local_class, |
485 | \%rev_cond, |
486 | $self->_relationship_attrs($remote_method, {}, $rel_attrs_params), |
487 | ], |
488 | extra => { |
489 | local_class => $remote_class, |
490 | local_moniker => $remote_moniker, |
491 | remote_moniker => $local_moniker, |
492 | }, |
493 | }; |
e8ad6491 |
494 | } |
dc379dc6 |
495 | } |
496 | |
eaf23084 |
497 | $self->_generate_m2ms($all_code); |
498 | |
dc379dc6 |
499 | # disambiguate rels with the same name |
500 | foreach my $class (keys %$all_code) { |
501 | my $dups = $self->_duplicates($all_code->{$class}); |
996be9ee |
502 | |
eaf23084 |
503 | $self->_disambiguate($all_code, $class, $dups) if $dups; |
dc379dc6 |
504 | } |
505 | |
506 | $self->_cleanup; |
507 | |
508 | return $all_code; |
509 | } |
510 | |
eaf23084 |
511 | # Find classes with only 2 FKs which are the PK and make many_to_many bridges for them. |
512 | sub _generate_m2ms { |
513 | my ($self, $all_code) = @_; |
514 | |
dab9a47a |
515 | LINK_CLASS: |
516 | foreach my $link_class (sort keys %$all_code) { |
517 | my @rels = grep $_->{method} eq 'belongs_to', @{$all_code->{$link_class}}; |
518 | next unless @rels == 2; |
eaf23084 |
519 | |
dab9a47a |
520 | my @class; |
521 | foreach my $this (0, 1) { |
522 | my $that = $this ? 0 : 1; |
523 | my %class; |
524 | $class[$this] = \%class; |
525 | $class{local_moniker} = $rels[$this]{extra}{remote_moniker}; |
526 | $class{remote_moniker} = $rels[$that]{extra}{remote_moniker}; |
eaf23084 |
527 | |
dab9a47a |
528 | $class{class} = $rels[$this]{args}[1]; |
eaf23084 |
529 | |
239fa6bc |
530 | my %link_cols = map { $_ => 1 } apply { s/^self\.//i } values %{ $rels[$this]{args}[2] }; |
531 | |
dab9a47a |
532 | $class{link_table_rel} = first { |
239fa6bc |
533 | $_->{method} eq 'has_many' |
534 | and |
535 | $_->{args}[1] eq $link_class |
536 | and |
537 | all { $link_cols{$_} } apply { s/^foreign\.//i } keys %{$_->{args}[2]} |
dab9a47a |
538 | } @{ $all_code->{$class{class}} }; |
eaf23084 |
539 | |
dab9a47a |
540 | next LINK_CLASS unless $class{link_table_rel}; |
eaf23084 |
541 | |
dab9a47a |
542 | $class{link_table_rel_name} = $class{link_table_rel}{args}[0]; |
e3c0a681 |
543 | |
dab9a47a |
544 | $class{link_rel} = $rels[$that]{args}[0]; |
eaf23084 |
545 | |
dab9a47a |
546 | $class{from_cols} = [ apply { s/^self\.//i } values %{ |
547 | $class{link_table_rel}->{args}[2] |
548 | } ]; |
eaf23084 |
549 | |
dab9a47a |
550 | $class{to_cols} = [ apply { s/^foreign\.//i } keys %{ $rels[$that]{args}[2] } ]; |
2fa358b6 |
551 | |
552 | $class{from_link_cols} = [ apply { s/^self\.//i } values %{ $rels[$this]{args}[2] } ]; |
dab9a47a |
553 | } |
eaf23084 |
554 | |
dab9a47a |
555 | my $link_moniker = $rels[0]{extra}{local_moniker}; |
da7342ae |
556 | |
eaf23084 |
557 | my @link_table_cols = |
da7342ae |
558 | @{[ $self->schema->source($link_moniker)->columns ]}; |
eaf23084 |
559 | |
560 | my @link_table_primary_cols = |
da7342ae |
561 | @{[ $self->schema->source($link_moniker)->primary_columns ]}; |
eaf23084 |
562 | |
f08818c4 |
563 | next unless array_eq( |
564 | [ sort +uniq @{$class[0]{from_link_cols}}, @{$class[1]{from_link_cols}} ], |
565 | [ sort @link_table_primary_cols ], |
566 | ) && ($self->allow_extra_m2m_cols || @link_table_cols == @link_table_primary_cols); |
eaf23084 |
567 | |
dab9a47a |
568 | foreach my $this (0, 1) { |
569 | my $that = $this ? 0 : 1; |
570 | ($class[$this]{m2m_relname}) = $self->_rel_name_map( |
571 | ($self->_inflect_plural($class[$this]{link_rel}))[0], |
572 | 'many_to_many', |
573 | @{$class[$this]}{qw(class local_moniker from_cols)}, |
574 | $class[$that]{class}, |
575 | @{$class[$this]}{qw(remote_moniker to_cols)}, |
576 | { |
577 | link_class => $link_class, |
578 | link_moniker => $link_moniker, |
579 | link_rel_name => $class[$this]{link_table_rel_name}, |
580 | }, |
581 | ); |
582 | |
583 | $class[$this]{m2m_relname} = $self->_resolve_relname_collision( |
584 | @{$class[$this]}{qw(local_moniker from_cols m2m_relname)}, |
585 | ); |
586 | } |
587 | |
588 | for my $this (0, 1) { |
589 | my $that = $this ? 0 : 1; |
590 | |
591 | push @{$all_code->{$class[$this]{class}}}, { |
592 | method => 'many_to_many', |
593 | args => [ |
594 | @{$class[$this]}{qw(m2m_relname link_table_rel_name link_rel)}, |
595 | $self->_relationship_attrs('many_to_many', {}, { |
596 | rel_type => 'many_to_many', |
597 | rel_name => $class[$this]{class2_relname}, |
598 | local_source => $self->schema->source($class[$this]{local_moniker}), |
599 | remote_source => $self->schema->source($class[$this]{remote_moniker}), |
600 | local_table => $self->loader->class_to_table->{$class[$this]{class}}, |
601 | local_cols => $class[$this]{from_cols}, |
602 | remote_table => $self->loader->class_to_table->{$class[$that]{class}}, |
603 | remote_cols => $class[$that]{from_cols}, |
604 | }) || (), |
605 | ], |
606 | extra => { |
607 | local_class => $class[$this]{class}, |
608 | link_class => $link_class, |
609 | local_moniker => $class[$this]{local_moniker}, |
610 | remote_moniker => $class[$this]{remote_moniker}, |
611 | }, |
612 | }; |
613 | } |
eaf23084 |
614 | } |
615 | } |
616 | |
dc379dc6 |
617 | sub _duplicates { |
618 | my ($self, $rels) = @_; |
619 | |
620 | my @rels = map [ $_->{args}[0] => $_ ], @$rels; |
621 | my %rel_names; |
622 | $rel_names{$_}++ foreach map $_->[0], @rels; |
623 | |
624 | my @dups = grep $rel_names{$_} > 1, keys %rel_names; |
625 | |
626 | my %dups; |
627 | |
628 | foreach my $dup (@dups) { |
629 | $dups{$dup} = [ map $_->[1], grep { $_->[0] eq $dup } @rels ]; |
630 | } |
631 | |
632 | return if not %dups; |
633 | |
634 | return \%dups; |
635 | } |
636 | |
637 | sub _tagger { |
638 | my $self = shift; |
639 | |
640 | $self->__tagger(Lingua::EN::Tagger->new) unless $self->__tagger; |
641 | |
642 | return $self->__tagger; |
643 | } |
7dba7c70 |
644 | |
dc379dc6 |
645 | sub _adjectives { |
646 | my ($self, @cols) = @_; |
a7116285 |
647 | |
dc379dc6 |
648 | my @adjectives; |
649 | |
650 | foreach my $col (@cols) { |
651 | my @words = split_name $col; |
652 | |
653 | my $tagged = $self->_tagger->get_readable(join ' ', @words); |
654 | |
655 | push @adjectives, $tagged =~ m{\G(\w+)/JJ\s+}g; |
656 | } |
657 | |
658 | return @adjectives; |
659 | } |
660 | |
5975bbe6 |
661 | sub _name_to_identifier { |
662 | my ($self, $name) = @_; |
663 | |
664 | my $to_identifier = $self->loader->naming->{force_ascii} ? |
665 | \&String::ToIdentifier::EN::to_identifier |
666 | : \&String::ToIdentifier::EN::Unicode::to_identifier; |
667 | |
668 | return join '_', map lc, split_name $to_identifier->($name, '_'); |
669 | } |
670 | |
dc379dc6 |
671 | sub _disambiguate { |
eaf23084 |
672 | my ($self, $all_code, $in_class, $dups) = @_; |
dc379dc6 |
673 | |
5975bbe6 |
674 | DUP: foreach my $dup (keys %$dups) { |
dc379dc6 |
675 | my @rels = @{ $dups->{$dup} }; |
676 | |
5975bbe6 |
677 | # Check if there are rels to the same table name in different |
678 | # schemas/databases, if so qualify them. |
679 | my @tables = map $self->loader->moniker_to_table->{$_->{extra}{remote_moniker}}, |
680 | @rels; |
681 | |
682 | # databases are different, prepend database |
683 | if ($tables[0]->can('database') && (uniq map $_->database||'', @tables) > 1) { |
684 | # If any rels are in the same database, we have to distinguish by |
685 | # both schema and database. |
686 | my %db_counts; |
687 | $db_counts{$_}++ for map $_->database, @tables; |
688 | my $use_schema = any { $_ > 1 } values %db_counts; |
689 | |
690 | foreach my $i (0..$#rels) { |
691 | my $rel = $rels[$i]; |
692 | my $table = $tables[$i]; |
693 | |
694 | $rel->{args}[0] = $self->_name_to_identifier($table->database) |
695 | . ($use_schema ? ('_' . $self->name_to_identifier($table->schema)) : '') |
696 | . '_' . $rel->{args}[0]; |
697 | } |
698 | next DUP; |
699 | } |
700 | # schemas are different, prepend schema |
701 | elsif ((uniq map $_->schema||'', @tables) > 1) { |
702 | foreach my $i (0..$#rels) { |
703 | my $rel = $rels[$i]; |
704 | my $table = $tables[$i]; |
705 | |
706 | $rel->{args}[0] = $self->_name_to_identifier($table->schema) |
707 | . '_' . $rel->{args}[0]; |
708 | } |
709 | next DUP; |
710 | } |
711 | |
dc379dc6 |
712 | foreach my $rel (@rels) { |
eaf23084 |
713 | next if $rel->{method} =~ /^(?:belongs_to|many_to_many)\z/; |
dc379dc6 |
714 | |
715 | my @to_cols = apply { s/^foreign\.//i } |
716 | keys %{ $rel->{args}[2] }; |
717 | |
718 | my @adjectives = $self->_adjectives(@to_cols); |
719 | |
720 | # If there are no adjectives, and there is only one might_have |
721 | # rel to that class, we hardcode 'active'. |
722 | |
723 | my $to_class = $rel->{args}[1]; |
724 | |
725 | if ((not @adjectives) |
726 | && (grep { $_->{method} eq 'might_have' |
eaf23084 |
727 | && $_->{args}[1] eq $to_class } @{ $all_code->{$in_class} }) == 1) { |
dc379dc6 |
728 | |
729 | @adjectives = 'active'; |
996be9ee |
730 | } |
e8ad6491 |
731 | |
dc379dc6 |
732 | if (@adjectives) { |
733 | my $rel_name = join '_', sort(@adjectives), $rel->{args}[0]; |
734 | |
59388920 |
735 | ($rel_name) = $rel->{method} eq 'might_have' ? |
dc379dc6 |
736 | $self->_inflect_singular($rel_name) |
737 | : |
738 | $self->_inflect_plural($rel_name); |
739 | |
59388920 |
740 | my ($local_class, $local_moniker, $remote_moniker) |
741 | = @{ $rel->{extra} } |
742 | {qw/local_class local_moniker remote_moniker/}; |
dc379dc6 |
743 | |
744 | my @from_cols = apply { s/^self\.//i } |
745 | values %{ $rel->{args}[2] }; |
057fbb08 |
746 | |
59388920 |
747 | ($rel_name) = $self->_rel_name_map($rel_name, $rel->{method}, $local_class, $local_moniker, \@from_cols, $to_class, $remote_moniker, \@to_cols); |
748 | |
749 | $rel_name = $self->_resolve_relname_collision($local_moniker, \@from_cols, $rel_name); |
dc379dc6 |
750 | |
751 | $rel->{args}[0] = $rel_name; |
e8ad6491 |
752 | } |
dc379dc6 |
753 | } |
996be9ee |
754 | } |
755 | |
dc379dc6 |
756 | # Check again for duplicates, since the heuristics above may not have resolved them all. |
757 | |
eaf23084 |
758 | if ($dups = $self->_duplicates($all_code->{$in_class})) { |
dc379dc6 |
759 | foreach my $dup (keys %$dups) { |
760 | # sort by method |
761 | my @rels = map $_->[1], sort { $a->[0] <=> $b->[0] } map [ |
eaf23084 |
762 | { |
763 | belongs_to => 3, |
764 | has_many => 2, |
765 | might_have => 1, |
766 | many_to_many => 0, |
767 | }->{$_->{method}}, $_ |
dc379dc6 |
768 | ], @{ $dups->{$dup} }; |
769 | |
770 | my $rel_num = 2; |
771 | |
772 | foreach my $rel (@rels[1 .. $#rels]) { |
eaf23084 |
773 | my $inflect_type = $rel->{method} =~ /^(?:many_to_many|has_many)\z/ ? |
dc379dc6 |
774 | 'inflect_plural' |
775 | : |
776 | 'inflect_singular'; |
777 | |
778 | my $inflect_method = "_$inflect_type"; |
779 | |
59388920 |
780 | my $relname_new_uninflected = $rel->{args}[0] . "_$rel_num"; |
dc379dc6 |
781 | |
782 | $rel_num++; |
783 | |
59388920 |
784 | my ($local_class, $local_moniker, $remote_moniker) |
785 | = @{ $rel->{extra} } |
786 | {qw/local_class local_moniker remote_moniker/}; |
dc379dc6 |
787 | |
eaf23084 |
788 | my (@from_cols, @to_cols, $to_class); |
789 | |
790 | if ($rel->{method} eq 'many_to_many') { |
791 | @from_cols = apply { s/^self\.//i } values %{ |
792 | (first { $_->{args}[0] eq $rel->{args}[1] } @{ $all_code->{$local_class} }) |
793 | ->{args}[2] |
794 | }; |
795 | @to_cols = apply { s/^foreign\.//i } keys %{ |
796 | (first { $_->{args}[0] eq $rel->{args}[2] } |
797 | @{ $all_code->{ $rel->{extra}{link_class} } }) |
798 | ->{args}[2] |
799 | }; |
800 | $to_class = $self->schema->source($remote_moniker)->result_class; |
801 | } |
802 | else { |
803 | @from_cols = apply { s/^self\.//i } values %{ $rel->{args}[2] }; |
804 | @to_cols = apply { s/^foreign\.//i } keys %{ $rel->{args}[2] }; |
805 | $to_class = $rel->{args}[1]; |
806 | } |
59388920 |
807 | |
808 | my ($relname_new, $inflect_mapped) = |
809 | $self->$inflect_method($relname_new_uninflected); |
810 | |
811 | my $rel_name_mapped; |
812 | |
813 | ($relname_new, $rel_name_mapped) = $self->_rel_name_map($relname_new, $rel->{method}, $local_class, $local_moniker, \@from_cols, $to_class, $remote_moniker, \@to_cols); |
9dedee1f |
814 | |
59388920 |
815 | my $mapped = $inflect_mapped || $rel_name_mapped; |
816 | |
817 | warn <<"EOF" unless $mapped; |
818 | Could not find a proper name for relationship '$relname_new' in source |
819 | '$local_moniker' for columns '@{[ join ',', @from_cols ]}'. Supply a value in |
eaf23084 |
820 | '$inflect_type' for '$relname_new_uninflected' or 'rel_name_map' for |
821 | '$relname_new' to name this relationship. |
dc379dc6 |
822 | EOF |
823 | |
59388920 |
824 | $relname_new = $self->_resolve_relname_collision($local_moniker, \@from_cols, $relname_new); |
aa608e1a |
825 | |
dc379dc6 |
826 | $rel->{args}[0] = $relname_new; |
827 | } |
828 | } |
829 | } |
996be9ee |
830 | } |
831 | |
39ef3bfe |
832 | sub _relnames_and_method { |
057fbb08 |
833 | my ( $self, $local_moniker, $rel, $cond, $uniqs, $counters ) = @_; |
e9c09ed9 |
834 | |
59388920 |
835 | my $remote_moniker = $rel->{remote_source}; |
836 | my $remote_obj = $self->schema->source( $remote_moniker ); |
837 | my $remote_class = $self->schema->class( $remote_moniker ); |
d75f8e79 |
838 | my $local_relname = $self->_local_relname( $rel->{remote_table}, $cond); |
fa6f8d4e |
839 | |
59388920 |
840 | my $local_cols = $rel->{local_columns}; |
c4a69b87 |
841 | my $local_table = $rel->{local_table}; |
59388920 |
842 | my $local_class = $self->schema->class($local_moniker); |
843 | my $local_source = $self->schema->source($local_moniker); |
057fbb08 |
844 | |
d75f8e79 |
845 | my $remote_relname_uninflected = $self->_normalize_name($local_table); |
846 | my ($remote_relname) = $self->_inflect_plural($self->_normalize_name($local_table)); |
fa6f8d4e |
847 | |
057fbb08 |
848 | my $remote_method = 'has_many'; |
849 | |
850 | # If the local columns have a UNIQUE constraint, this is a one-to-one rel |
50b95db6 |
851 | if (array_eq([ $local_source->primary_columns ], $local_cols) || |
eaf23084 |
852 | first { array_eq($_->[1], $local_cols) } @$uniqs) { |
59388920 |
853 | $remote_method = 'might_have'; |
d75f8e79 |
854 | ($remote_relname) = $self->_inflect_singular($remote_relname_uninflected); |
057fbb08 |
855 | } |
fa6f8d4e |
856 | |
1ad8e8c3 |
857 | # If more than one rel between this pair of tables, use the local |
858 | # col names to distinguish, unless the rel was created previously. |
859 | if ($counters->{$remote_moniker} > 1) { |
860 | my $relationship_exists = 0; |
861 | |
404aefa4 |
862 | if (-f (my $existing_remote_file = $self->loader->get_dump_filename($remote_class))) { |
1ad8e8c3 |
863 | my $class = "${remote_class}Temporary"; |
864 | |
8c70d2c7 |
865 | if (not Class::Inspector->loaded($class)) { |
fcf328c7 |
866 | my $code = slurp_file $existing_remote_file; |
1ad8e8c3 |
867 | |
868 | $code =~ s/(?<=package $remote_class)/Temporary/g; |
869 | |
6e4b7bb1 |
870 | $code =~ s/__PACKAGE__->meta->make_immutable[^;]*;//g; |
1ad8e8c3 |
871 | |
872 | eval $code; |
873 | die $@ if $@; |
874 | |
875 | push @{ $self->_temp_classes }, $class; |
876 | } |
877 | |
d75f8e79 |
878 | if ($class->has_relationship($remote_relname)) { |
1ad8e8c3 |
879 | my $rel_cols = [ sort { $a cmp $b } apply { s/^foreign\.//i } |
d75f8e79 |
880 | (keys %{ $class->relationship_info($remote_relname)->{cond} }) ]; |
1ad8e8c3 |
881 | |
50b95db6 |
882 | $relationship_exists = 1 if array_eq([ sort @$local_cols ], $rel_cols); |
1ad8e8c3 |
883 | } |
884 | } |
885 | |
886 | if (not $relationship_exists) { |
887 | my $colnames = q{_} . $self->_normalize_name(join '_', @$local_cols); |
d75f8e79 |
888 | $local_relname .= $colnames if keys %$cond > 1; |
1ad8e8c3 |
889 | |
d75f8e79 |
890 | $remote_relname = $self->_strip_id_postfix($self->_normalize_name($local_table . $colnames)); |
1ad8e8c3 |
891 | |
d75f8e79 |
892 | $remote_relname_uninflected = $remote_relname; |
893 | ($remote_relname) = $self->_inflect_plural($remote_relname); |
1ad8e8c3 |
894 | |
895 | # if colnames were added and this is a might_have, re-inflect |
896 | if ($remote_method eq 'might_have') { |
d75f8e79 |
897 | ($remote_relname) = $self->_inflect_singular($remote_relname_uninflected); |
1ad8e8c3 |
898 | } |
899 | } |
900 | } |
901 | |
45b70e6c |
902 | return ($local_relname, $remote_relname, $remote_method); |
59388920 |
903 | } |
904 | |
905 | sub _rel_name_map { |
906 | my ($self, $relname, $method, $local_class, $local_moniker, $local_cols, |
da7342ae |
907 | $remote_class, $remote_moniker, $remote_cols, $extra) = @_; |
59388920 |
908 | |
909 | my $info = { |
da7342ae |
910 | %{$extra || {}}, |
59388920 |
911 | name => $relname, |
912 | type => $method, |
913 | local_class => $local_class, |
914 | local_moniker => $local_moniker, |
915 | local_columns => $local_cols, |
916 | remote_class => $remote_class, |
917 | remote_moniker => $remote_moniker, |
918 | remote_columns => $remote_cols, |
919 | }; |
920 | |
c4d629ab |
921 | $self->_run_user_map($self->rel_name_map, $info); |
922 | } |
923 | |
924 | sub _run_user_map { |
925 | my ($self, $map, $info) = @_; |
59388920 |
926 | |
c4d629ab |
927 | my $new_name = $info->{name}; |
59388920 |
928 | my $mapped = 0; |
929 | |
930 | if ('HASH' eq ref($map)) { |
931 | my $name = $info->{name}; |
932 | my $moniker = $info->{local_moniker}; |
933 | if ($map->{$moniker} and 'HASH' eq ref($map->{$moniker}) |
934 | and $map->{$moniker}{$name} |
935 | ) { |
936 | $new_name = $map->{$moniker}{$name}; |
937 | $mapped = 1; |
938 | } |
939 | elsif ($map->{$name} and not 'HASH' eq ref($map->{$name})) { |
940 | $new_name = $map->{$name}; |
941 | $mapped = 1; |
942 | } |
943 | } |
944 | elsif ('CODE' eq ref($map)) { |
c4d629ab |
945 | my $cb = sub { |
946 | my ($cb_map) = @_; |
947 | croak "reentered rel_name_map must be a hashref" |
948 | unless 'HASH' eq ref($cb_map); |
949 | my ($cb_name, $cb_mapped) = $self->_run_user_map($cb_map, $info); |
950 | return $cb_mapped && $cb_name; |
951 | }; |
952 | my $name = $map->($info, $cb); |
59388920 |
953 | if ($name) { |
954 | $new_name = $name; |
955 | $mapped = 1; |
956 | } |
957 | } |
958 | |
959 | return ($new_name, $mapped); |
fa6f8d4e |
960 | } |
961 | |
dc379dc6 |
962 | sub _cleanup { |
1ad8e8c3 |
963 | my $self = shift; |
964 | |
965 | for my $class (@{ $self->_temp_classes }) { |
966 | Class::Unload->unload($class); |
967 | } |
968 | |
969 | $self->_temp_classes([]); |
970 | } |
971 | |
b87ab391 |
972 | =head1 AUTHORS |
be80bba7 |
973 | |
b87ab391 |
974 | See L<DBIx::Class::Schema::Loader/AUTHORS>. |
be80bba7 |
975 | |
976 | =head1 LICENSE |
977 | |
978 | This library is free software; you can redistribute it and/or modify it under |
979 | the same terms as Perl itself. |
980 | |
981 | =cut |
982 | |
996be9ee |
983 | 1; |
19b7d71c |
984 | # vim:et sts=4 sw=4 tw=0: |