Class: ActiveRecord::Associations::ClassMethods::JoinDependency::JoinAssociation

Inherits:
JoinBase
  • Object
show all
Defined in:
lib/active_record/associations.rb

Overview

:nodoc:

Instance Attribute Summary collapse

Attributes inherited from JoinBase

#active_record, #table_joins

Instance Method Summary collapse

Methods inherited from JoinBase

#aliased_primary_key, #column_names_with_alias, #extract_record, #instantiate, #record_id

Constructor Details

#initialize(reflection, join_dependency, parent = nil) ⇒ JoinAssociation

Returns a new instance of JoinAssociation.



2068
2069
2070
2071
2072
2073
2074
2075
2076
2077
2078
2079
2080
2081
2082
2083
2084
2085
2086
2087
2088
2089
2090
2091
 
# File 'lib/active_record/associations.rb', line 2068

def initialize(reflection, join_dependency, parent = nil)
  reflection.check_validity!
  if reflection.options[:polymorphic]
    raise EagerLoadPolymorphicError.new(reflection)
  end

  super(reflection.klass)
  @join_dependency    = join_dependency
  @parent             = parent
  @reflection         = reflection
  @aliased_prefix     = "t#{ join_dependency.joins.size }"
  @parent_table_name  = parent.active_record.table_name
  @aliased_table_name = aliased_table_name_for(table_name)
  @join               = nil
  @join_class         = Arel::InnerJoin

  if reflection.macro == :has_and_belongs_to_many
    @aliased_join_table_name = aliased_table_name_for(reflection.options[:join_table], "_join")
  end

  if [:has_many, :has_one].include?(reflection.macro) && reflection.options[:through]
    @aliased_join_table_name = aliased_table_name_for(reflection.through_reflection.klass.table_name, "_join")
  end
end

Instance Attribute Details

#aliased_join_table_name ⇒ Object (readonly)

Returns the value of attribute aliased_join_table_name.



2065
2066
2067
 
# File 'lib/active_record/associations.rb', line 2065

def aliased_join_table_name
  @aliased_join_table_name
end

#aliased_prefix ⇒ Object (readonly)

Returns the value of attribute aliased_prefix.



2065
2066
2067
 
# File 'lib/active_record/associations.rb', line 2065

def aliased_prefix
  @aliased_prefix
end

#aliased_table_name ⇒ Object (readonly)

Returns the value of attribute aliased_table_name.



2065
2066
2067
 
# File 'lib/active_record/associations.rb', line 2065

def aliased_table_name
  @aliased_table_name
end

#join_class ⇒ Object (readonly)

Returns the value of attribute join_class.



2065
2066
2067
 
# File 'lib/active_record/associations.rb', line 2065

def join_class
  @join_class
end

#parent ⇒ Object (readonly)

Returns the value of attribute parent.



2065
2066
2067
 
# File 'lib/active_record/associations.rb', line 2065

def parent
  @parent
end

#parent_table_name ⇒ Object (readonly)

Returns the value of attribute parent_table_name.



2065
2066
2067
 
# File 'lib/active_record/associations.rb', line 2065

def parent_table_name
  @parent_table_name
end

#reflection ⇒ Object (readonly)

Returns the value of attribute reflection.



2065
2066
2067
 
# File 'lib/active_record/associations.rb', line 2065

def reflection
  @reflection
end

Instance Method Details

#==(other) ⇒ Object 



2093
2094
2095
2096
2097
 
# File 'lib/active_record/associations.rb', line 2093

def ==(other)
  other.class == self.class &&
  other.reflection == reflection &&
  other.parent == parent
end

#association_join ⇒ Object 



2110
2111
2112
2113
2114
2115
2116
2117
2118
2119
2120
2121
2122
2123
2124
2125
2126
2127
2128
2129
2130
2131
2132
2133
2134
2135
2136
2137
2138
2139
2140
2141
2142
2143
2144
2145
2146
2147
2148
2149
2150
2151
2152
2153
2154
2155
2156
2157
2158
2159
2160
2161
2162
2163
2164
2165
2166
2167
2168
2169
2170
2171
2172
2173
2174
2175
2176
2177
2178
2179
2180
2181
2182
2183
2184
2185
2186
2187
2188
2189
2190
2191
2192
2193
2194
 
# File 'lib/active_record/associations.rb', line 2110

def association_join
  return @join if @join

  aliased_table = Arel::Table.new(table_name, :as => @aliased_table_name, :engine => arel_engine)
  parent_table = Arel::Table.new(parent.table_name, :as => parent.aliased_table_name, :engine => arel_engine)

  @join = case reflection.macro
  when :has_and_belongs_to_many
    join_table = Arel::Table.new(options[:join_table], :as => aliased_join_table_name, :engine => arel_engine)
    fk = options[:foreign_key] || reflection.active_record.to_s.foreign_key
    klass_fk = options[:association_foreign_key] || klass.to_s.foreign_key

    [
      join_table[fk].eq(parent_table[reflection.active_record.primary_key]),
      aliased_table[klass.primary_key].eq(join_table[klass_fk])
    ]
  when :has_many, :has_one
    if reflection.options[:through]
      join_table = Arel::Table.new(through_reflection.klass.table_name, :as => aliased_join_table_name, :engine => arel_engine)
      jt_foreign_key = jt_as_extra = jt_source_extra = jt_sti_extra = nil
      first_key = second_key = as_extra = nil

      if through_reflection.options[:as] # has_many :through against a polymorphic join
        jt_foreign_key = through_reflection.options[:as].to_s + '_id'
        jt_as_extra = join_table[through_reflection.options[:as].to_s + '_type'].eq(parent.active_record.base_class.name)
      else
        jt_foreign_key = through_reflection.primary_key_name
      end

      case source_reflection.macro
      when :has_many
        if source_reflection.options[:as]
          first_key   = "#{source_reflection.options[:as]}_id"
          second_key  = options[:foreign_key] || primary_key
          as_extra    = aliased_table["#{source_reflection.options[:as]}_type"].eq(source_reflection.active_record.base_class.name)
        else
          first_key   = through_reflection.klass.base_class.to_s.foreign_key
          second_key  = options[:foreign_key] || primary_key
        end

        unless through_reflection.klass.descends_from_active_record?
          jt_sti_extra = join_table[through_reflection.active_record.inheritance_column].eq(through_reflection.klass.sti_name)
        end
      when :belongs_to
        first_key = primary_key
        if reflection.options[:source_type]
          second_key = source_reflection.association_foreign_key
          jt_source_extra = join_table[reflection.source_reflection.options[:foreign_type]].eq(reflection.options[:source_type])
        else
          second_key = source_reflection.primary_key_name
        end
      end

      [
        [parent_table[parent.primary_key].eq(join_table[jt_foreign_key]), jt_as_extra, jt_source_extra, jt_sti_extra].reject{|x| x.blank? },
        aliased_table[first_key].eq(join_table[second_key])
      ]
    elsif reflection.options[:as]
      id_rel = aliased_table["#{reflection.options[:as]}_id"].eq(parent_table[parent.primary_key])
      type_rel = aliased_table["#{reflection.options[:as]}_type"].eq(parent.active_record.base_class.name)
      [id_rel, type_rel]
    else
      foreign_key = options[:foreign_key] || reflection.active_record.name.foreign_key
      [aliased_table[foreign_key].eq(parent_table[reflection.options[:primary_key] || parent.primary_key])]
    end
  when :belongs_to
    [aliased_table[options[:primary_key] || reflection.klass.primary_key].eq(parent_table[options[:foreign_key] || reflection.primary_key_name])]
  end

  unless klass.descends_from_active_record?
    sti_column = aliased_table[klass.inheritance_column]
    sti_condition = sti_column.eq(klass.sti_name)
    klass.descendants.each {|subclass| sti_condition = sti_condition.or(sti_column.eq(subclass.sti_name)) }

    @join << sti_condition
  end

  [through_reflection, reflection].each do |ref|
    if ref && ref.options[:conditions]
      @join << interpolate_sql(sanitize_sql(ref.options[:conditions], aliased_table_name))
    end
  end

  @join
end

#find_parent_in(other_join_dependency) ⇒ Object 



2099
2100
2101
2102
2103
 
# File 'lib/active_record/associations.rb', line 2099

def find_parent_in(other_join_dependency)
  other_join_dependency.joins.detect do |join|
    self.parent == join
  end
end

#join_relation(joining_relation, join = nil) ⇒ Object 



2208
2209
2210
 
# File 'lib/active_record/associations.rb', line 2208

def join_relation(joining_relation, join = nil)
  joining_relation.joins(self.with_join_class(Arel::OuterJoin))
end

#relation ⇒ Object 



2196
2197
2198
2199
2200
2201
2202
2203
2204
2205
2206
 
# File 'lib/active_record/associations.rb', line 2196

def relation
  aliased = Arel::Table.new(table_name, :as => @aliased_table_name, :engine => arel_engine)

  if reflection.macro == :has_and_belongs_to_many
    [Arel::Table.new(options[:join_table], :as => aliased_join_table_name, :engine => arel_engine), aliased]
  elsif reflection.options[:through]
    [Arel::Table.new(through_reflection.klass.table_name, :as => aliased_join_table_name, :engine => arel_engine), aliased]
  else
    aliased
  end
end

#with_join_class(join_class) ⇒ Object 



2105
2106
2107
2108
 
# File 'lib/active_record/associations.rb', line 2105

def with_join_class(join_class)
  @join_class = join_class
  self
end