Class: ActiveRecord::Reflection::AssociationReflection
- Inherits:
-
MacroReflection
- Object
- AbstractReflection
- MacroReflection
- ActiveRecord::Reflection::AssociationReflection
- Defined in:
- lib/active_record/reflection.rb
Overview
Holds all the metadata about an association as it was specified in the Active Record class.
Direct Known Subclasses
BelongsToReflection, HasAndBelongsToManyReflection, HasManyReflection, HasOneReflection
Instance Attribute Summary collapse
-
#foreign_type ⇒ Object
readonly
Returns the value of attribute foreign_type.
-
#parent_reflection ⇒ Object
Reflection.
-
#type ⇒ Object
readonly
Returns the value of attribute type.
Attributes inherited from MacroReflection
#active_record, #name, #options, #plural_name, #scope
Instance Method Summary collapse
- #active_record_primary_key ⇒ Object
- #add_as_polymorphic_through(reflection, seed) ⇒ Object
- #add_as_source(seed) ⇒ Object
- #add_as_through(seed) ⇒ Object
- #association_class ⇒ Object
- #association_foreign_key ⇒ Object
- #association_primary_key(klass = nil) ⇒ Object
- #association_scope_cache(klass, owner, &block) ⇒ Object
-
#belongs_to? ⇒ Boolean
Returns
true
ifself
is abelongs_to
reflection. - #check_eager_loadable! ⇒ Object
- #check_validity! ⇒ Object
-
#clear_association_scope_cache ⇒ Object
This is for clearing cache on the reflection.
-
#collect_join_chain ⇒ Object
A chain of reflections from this one back to the owner.
-
#collection? ⇒ Boolean
Returns whether or not this association reflection is for a collection association.
-
#compute_class(name) ⇒ Object
:nodoc:.
- #extensions ⇒ Object
- #foreign_key ⇒ Object
- #has_inverse? ⇒ Boolean
-
#has_one? ⇒ Boolean
Returns
true
ifself
is ahas_one
reflection. - #has_scope? ⇒ Boolean
-
#initialize(name, scope, options, active_record) ⇒ AssociationReflection
constructor
A new instance of AssociationReflection.
- #join_foreign_key ⇒ Object
-
#join_id_for(owner) ⇒ Object
:nodoc:.
- #join_primary_key(klass = nil) ⇒ Object
- #join_table ⇒ Object
-
#macro ⇒ Object
Returns the macro type.
- #nested? ⇒ Boolean
- #polymorphic? ⇒ Boolean
- #polymorphic_inverse_of(associated_class) ⇒ Object
- #source_reflection ⇒ Object
- #through_reflection ⇒ Object
-
#validate? ⇒ Boolean
Returns whether or not the association should be validated as part of the parent’s validation.
Methods inherited from MacroReflection
#==, #autosave=, #klass, #scope_for
Methods inherited from AbstractReflection
#alias_candidate, #build_association, #build_scope, #chain, #check_validity_of_inverse!, #class_name, #constraints, #counter_cache_column, #counter_must_be_updated_by_has_many?, #has_cached_counter?, #inverse_of, #inverse_updates_counter_in_memory?, #inverse_which_updates_counter_cache, #join_scope, #join_scopes, #klass_join_scope, #scopes, #strict_loading?, #table_name, #through_reflection?
Constructor Details
#initialize(name, scope, options, active_record) ⇒ AssociationReflection
Returns a new instance of AssociationReflection.
442 443 444 445 446 447 448 |
# File 'lib/active_record/reflection.rb', line 442 def initialize(name, scope, , active_record) super @type = -([:foreign_type]&.to_s || "#{[:as]}_type") if [:as] @foreign_type = -([:foreign_type]&.to_s || "#{name}_type") if [:polymorphic] ensure_option_not_given_as_class!(:class_name) end |
Instance Attribute Details
#foreign_type ⇒ Object (readonly)
Returns the value of attribute foreign_type.
439 440 441 |
# File 'lib/active_record/reflection.rb', line 439 def foreign_type @foreign_type end |
#parent_reflection ⇒ Object
Reflection
440 441 442 |
# File 'lib/active_record/reflection.rb', line 440 def parent_reflection @parent_reflection end |
#type ⇒ Object (readonly)
Returns the value of attribute type.
439 440 441 |
# File 'lib/active_record/reflection.rb', line 439 def type @type end |
Instance Method Details
#active_record_primary_key ⇒ Object
474 475 476 |
# File 'lib/active_record/reflection.rb', line 474 def active_record_primary_key @active_record_primary_key ||= -([:primary_key]&.to_s || primary_key(active_record)) end |
#add_as_polymorphic_through(reflection, seed) ⇒ Object
589 590 591 |
# File 'lib/active_record/reflection.rb', line 589 def add_as_polymorphic_through(reflection, seed) seed + [PolymorphicReflection.new(self, reflection)] end |
#add_as_source(seed) ⇒ Object
585 586 587 |
# File 'lib/active_record/reflection.rb', line 585 def add_as_source(seed) seed end |
#add_as_through(seed) ⇒ Object
593 594 595 |
# File 'lib/active_record/reflection.rb', line 593 def add_as_through(seed) seed + [self] end |
#association_class ⇒ Object
579 |
# File 'lib/active_record/reflection.rb', line 579 def association_class; raise NotImplementedError; end |
#association_foreign_key ⇒ Object
466 467 468 |
# File 'lib/active_record/reflection.rb', line 466 def association_foreign_key @association_foreign_key ||= -([:association_foreign_key]&.to_s || class_name.foreign_key) end |
#association_primary_key(klass = nil) ⇒ Object
470 471 472 |
# File 'lib/active_record/reflection.rb', line 470 def association_primary_key(klass = nil) primary_key(klass || self.klass) end |
#association_scope_cache(klass, owner, &block) ⇒ Object
450 451 452 453 454 455 456 |
# File 'lib/active_record/reflection.rb', line 450 def association_scope_cache(klass, owner, &block) key = self if polymorphic? key = [key, owner._read_attribute(@foreign_type)] end klass.cached_find_by_statement(key, &block) end |
#belongs_to? ⇒ Boolean
Returns true
if self
is a belongs_to
reflection.
574 |
# File 'lib/active_record/reflection.rb', line 574 def belongs_to?; false; end |
#check_eager_loadable! ⇒ Object
490 491 492 493 494 495 496 497 498 499 500 |
# File 'lib/active_record/reflection.rb', line 490 def check_eager_loadable! return unless scope unless scope.arity == 0 raise ArgumentError, <<-MSG.squish The association scope '#{name}' is instance dependent (the scope block takes an argument). Eager loading instance dependent scopes is not supported. MSG end end |
#check_validity! ⇒ Object
486 487 488 |
# File 'lib/active_record/reflection.rb', line 486 def check_validity! check_validity_of_inverse! end |
#clear_association_scope_cache ⇒ Object
This is for clearing cache on the reflection. Useful for tests that need to compare SQL queries on associations.
522 523 524 |
# File 'lib/active_record/reflection.rb', line 522 def clear_association_scope_cache # :nodoc: klass.initialize_find_by_cache end |
#collect_join_chain ⇒ Object
A chain of reflections from this one back to the owner. For more see the explanation in ThroughReflection.
516 517 518 |
# File 'lib/active_record/reflection.rb', line 516 def collect_join_chain [self] end |
#collection? ⇒ Boolean
Returns whether or not this association reflection is for a collection association. Returns true
if the macro
is either has_many
or has_and_belongs_to_many
, false
otherwise.
556 557 558 |
# File 'lib/active_record/reflection.rb', line 556 def collection? false end |
#compute_class(name) ⇒ Object
:nodoc:
415 416 417 418 419 420 421 422 423 424 425 426 427 428 429 430 431 432 433 434 435 436 437 |
# File 'lib/active_record/reflection.rb', line 415 def compute_class(name) if polymorphic? raise ArgumentError, "Polymorphic associations do not support computing the class." end msg = <<-MSG.squish Rails couldn't find a valid model for #{name} association. Please provide the :class_name option on the association declaration. If :class_name is already provided, make sure it's an ActiveRecord::Base subclass. MSG begin klass = active_record.send(:compute_type, name) unless klass < ActiveRecord::Base raise ArgumentError, msg end klass rescue NameError raise NameError, msg end end |
#extensions ⇒ Object
597 598 599 |
# File 'lib/active_record/reflection.rb', line 597 def extensions Array([:extend]) end |
#foreign_key ⇒ Object
462 463 464 |
# File 'lib/active_record/reflection.rb', line 462 def foreign_key @foreign_key ||= -([:foreign_key]&.to_s || derive_foreign_key) end |
#has_inverse? ⇒ Boolean
534 535 536 |
# File 'lib/active_record/reflection.rb', line 534 def has_inverse? inverse_name end |
#has_one? ⇒ Boolean
Returns true
if self
is a has_one
reflection.
577 |
# File 'lib/active_record/reflection.rb', line 577 def has_one?; false; end |
#has_scope? ⇒ Boolean
530 531 532 |
# File 'lib/active_record/reflection.rb', line 530 def has_scope? scope end |
#join_foreign_key ⇒ Object
482 483 484 |
# File 'lib/active_record/reflection.rb', line 482 def join_foreign_key active_record_primary_key end |
#join_id_for(owner) ⇒ Object
:nodoc:
502 503 504 |
# File 'lib/active_record/reflection.rb', line 502 def join_id_for(owner) # :nodoc: owner[join_foreign_key] end |
#join_primary_key(klass = nil) ⇒ Object
478 479 480 |
# File 'lib/active_record/reflection.rb', line 478 def join_primary_key(klass = nil) foreign_key end |
#join_table ⇒ Object
458 459 460 |
# File 'lib/active_record/reflection.rb', line 458 def join_table @join_table ||= -([:join_table]&.to_s || derive_join_table) end |
#macro ⇒ Object
Returns the macro type.
has_many :clients
returns :has_many
551 |
# File 'lib/active_record/reflection.rb', line 551 def macro; raise NotImplementedError; end |
#nested? ⇒ Boolean
526 527 528 |
# File 'lib/active_record/reflection.rb', line 526 def nested? false end |
#polymorphic? ⇒ Boolean
581 582 583 |
# File 'lib/active_record/reflection.rb', line 581 def polymorphic? [:polymorphic] end |
#polymorphic_inverse_of(associated_class) ⇒ Object
538 539 540 541 542 543 544 545 546 |
# File 'lib/active_record/reflection.rb', line 538 def polymorphic_inverse_of(associated_class) if has_inverse? if inverse_relationship = associated_class._reflect_on_association([:inverse_of]) inverse_relationship else raise InverseOfAssociationNotFoundError.new(self, associated_class) end end end |
#source_reflection ⇒ Object
510 511 512 |
# File 'lib/active_record/reflection.rb', line 510 def source_reflection self end |
#through_reflection ⇒ Object
506 507 508 |
# File 'lib/active_record/reflection.rb', line 506 def through_reflection nil end |
#validate? ⇒ Boolean
Returns whether or not the association should be validated as part of the parent’s validation.
Unless you explicitly disable validation with validate: false
, validation will take place when:
-
you explicitly enable validation;
validate: true
-
you use autosave;
autosave: true
-
the association is a
has_many
association
569 570 571 |
# File 'lib/active_record/reflection.rb', line 569 def validate? ![:validate].nil? ? [:validate] : ([:autosave] == true || collection?) end |