1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153
|
# frozen_string_literal: true
module ActiveRecord
module Associations
class Preloader
class Branch # :nodoc:
attr_reader :association, :children, :parent
attr_reader :scope, :associate_by_default
attr_writer :preloaded_records
def initialize(association:, children:, parent:, associate_by_default:, scope:)
@association = if association
begin
@association = association.to_sym
rescue NoMethodError
raise ArgumentError, "Association names must be Symbol or String, got: #{association.class.name}"
end
end
@parent = parent
@scope = scope
@associate_by_default = associate_by_default
@children = build_children(children)
@loaders = nil
end
def future_classes
(immediate_future_classes + children.flat_map(&:future_classes)).uniq
end
def immediate_future_classes
if parent.done?
loaders.flat_map(&:future_classes).uniq
else
likely_reflections.reject(&:polymorphic?).flat_map do |reflection|
reflection.
chain.
map(&:klass)
end.uniq
end
end
def target_classes
if done?
preloaded_records.map(&:klass).uniq
elsif parent.done?
loaders.map(&:klass).uniq
else
likely_reflections.reject(&:polymorphic?).map(&:klass).uniq
end
end
def likely_reflections
parent_classes = parent.target_classes
parent_classes.filter_map do |parent_klass|
parent_klass._reflect_on_association(@association)
end
end
def root?
parent.nil?
end
def source_records
@parent.preloaded_records
end
def preloaded_records
@preloaded_records ||= loaders.flat_map(&:preloaded_records)
end
def done?
root? || (@loaders && @loaders.all?(&:run?))
end
def runnable_loaders
loaders.flat_map(&:runnable_loaders).reject(&:run?)
end
def grouped_records
h = {}
polymorphic_parent = !root? && parent.polymorphic?
source_records.each do |record|
reflection = record.class._reflect_on_association(association)
next if polymorphic_parent && !reflection || !record.association(association).klass
(h[reflection] ||= []) << record
end
h
end
def preloaders_for_reflection(reflection, reflection_records)
reflection_records.group_by do |record|
klass = record.association(association).klass
if reflection.scope && reflection.scope.arity != 0
# For instance dependent scopes, the scope is potentially
# different for each record. To allow this we'll group each
# object separately into its own preloader
reflection_scope = reflection.join_scopes(klass.arel_table, klass.predicate_builder, klass, record).inject(&:merge!)
end
[klass, reflection_scope]
end.map do |(rhs_klass, reflection_scope), rs|
preloader_for(reflection).new(rhs_klass, rs, reflection, scope, reflection_scope, associate_by_default)
end
end
def polymorphic?
return false if root?
return @polymorphic if defined?(@polymorphic)
@polymorphic = source_records.any? do |record|
reflection = record.class._reflect_on_association(association)
reflection && reflection.options[:polymorphic]
end
end
def loaders
@loaders ||=
grouped_records.flat_map do |reflection, reflection_records|
preloaders_for_reflection(reflection, reflection_records)
end
end
private
def build_children(children)
Array.wrap(children).flat_map { |association|
Array(association).flat_map { |parent, child|
Branch.new(
parent: self,
association: parent,
children: child,
associate_by_default: associate_by_default,
scope: scope
)
}
}
end
# Returns a class containing the logic needed to load preload the data
# and attach it to a relation. The class returned implements a `run` method
# that accepts a preloader.
def preloader_for(reflection)
if reflection.options[:through]
ThroughAssociation
else
Association
end
end
end
end
end
end
|