# frozen_string_literal: true module ActiveRecord module Associations # = Active Record Through Association module ThroughAssociation #:nodoc: delegate :source_reflection, to: :reflection private def through_reflection @through_reflection ||= begin refl = reflection.through_reflection while refl.through_reflection? refl = refl.through_reflection end refl end end def through_association @through_association ||= owner.association(through_reflection.name) end # We merge in these scopes for two reasons: # # 1. To get the default_scope conditions for any of the other reflections in the chain # 2. To get the type conditions for any STI models in the chain def target_scope scope = super reflection.chain.drop(1).each do |reflection| relation = reflection.klass.scope_for_association scope.merge!( relation.except(:select, :create_with, :includes, :preload, :joins, :eager_load) ) end scope end # Construct attributes for :through pointing to owner and associate. This is used by the # methods which create and delete records on the association. # # We only support indirectly modifying through associations which have a belongs_to source. # This is the "has_many :tags, through: :taggings" situation, where the join model # typically has a belongs_to on both side. In other words, associations which could also # be represented as has_and_belongs_to_many associations. # # We do not support creating/deleting records on the association where the source has # some other type, because this opens up a whole can of worms, and in basically any # situation it is more natural for the user to just create or modify their join records # directly as required. def construct_join_attributes(*records) ensure_mutable association_primary_key = source_reflection.association_primary_key(reflection.klass) if association_primary_key == reflection.klass.primary_key && !options[:source_type] join_attributes = { source_reflection.name => records } else join_attributes = { source_reflection.foreign_key => records.map(&association_primary_key.to_sym) } end if options[:source_type] join_attributes[source_reflection.foreign_type] = [ options[:source_type] ] end if records.count == 1 join_attributes.transform_values!(&:first) else join_attributes end end # Note: this does not capture all cases, for example it would be crazy to try to # properly support stale-checking for nested associations. def stale_state if through_reflection.belongs_to? owner[through_reflection.foreign_key] && owner[through_reflection.foreign_key].to_s end end def foreign_key_present? through_reflection.belongs_to? && !owner[through_reflection.foreign_key].nil? end def ensure_mutable unless source_reflection.belongs_to? if reflection.has_one? raise HasOneThroughCantAssociateThroughHasOneOrManyReflection.new(owner, reflection) else raise HasManyThroughCantAssociateThroughHasOneOrManyReflection.new(owner, reflection) end end end def ensure_not_nested if reflection.nested? if reflection.has_one? raise HasOneThroughNestedAssociationsAreReadonly.new(owner, reflection) else raise HasManyThroughNestedAssociationsAreReadonly.new(owner, reflection) end end end def build_record(attributes) inverse = source_reflection.inverse_of target = through_association.target if inverse && target && !target.is_a?(Array) attributes[inverse.foreign_key] = target.id end super end end end end