Class: ActiveRecord::Reflection::AbstractReflection
- Inherits:
-
Object
- Object
- ActiveRecord::Reflection::AbstractReflection
show all
- Defined in:
- lib/active_record/reflection.rb
Overview
Defined Under Namespace
Classes: JoinKeys
Instance Method Summary
collapse
Instance Method Details
#alias_candidate(name) ⇒ Object
278
279
280
|
# File 'lib/active_record/reflection.rb', line 278
def alias_candidate(name)
"#{plural_name}_#{name}"
end
|
#build_association(attributes, &block) ⇒ Object
Returns a new, unsaved instance of the associated class. attributes
will be passed to the class’s constructor.
154
155
156
|
# File 'lib/active_record/reflection.rb', line 154
def build_association(attributes, &block)
klass.new(attributes, &block)
end
|
#build_scope(table, predicate_builder = predicate_builder(table)) ⇒ Object
290
291
292
|
# File 'lib/active_record/reflection.rb', line 290
def build_scope(table, predicate_builder = predicate_builder(table))
Relation.create(klass, table, predicate_builder)
end
|
#chain ⇒ Object
282
283
284
|
# File 'lib/active_record/reflection.rb', line 282
def chain
collect_join_chain
end
|
#check_validity_of_inverse! ⇒ Object
234
235
236
237
238
239
240
|
# File 'lib/active_record/reflection.rb', line 234
def check_validity_of_inverse!
unless polymorphic?
if has_inverse? && inverse_of.nil?
raise InverseOfAssociationNotFoundError.new(self)
end
end
end
|
#class_name ⇒ Object
Returns the class name for the macro.
composed_of :balance, class_name: 'Money'
returns 'Money'
has_many :clients
returns 'Client'
170
171
172
|
# File 'lib/active_record/reflection.rb', line 170
def class_name
@class_name ||= (options[:class_name] || derive_class_name).to_s
end
|
#constraints ⇒ Object
212
213
214
|
# File 'lib/active_record/reflection.rb', line 212
def constraints
chain.map(&:scopes).flatten
end
|
#counter_cache_column ⇒ Object
216
217
218
219
220
221
222
223
224
225
226
|
# File 'lib/active_record/reflection.rb', line 216
def counter_cache_column
if belongs_to?
if options[:counter_cache] == true
"#{active_record.name.demodulize.underscore.pluralize}_count"
elsif options[:counter_cache]
options[:counter_cache].to_s
end
else
options[:counter_cache] ? options[:counter_cache].to_s : "#{name}_count"
end
end
|
#counter_must_be_updated_by_has_many? ⇒ Boolean
274
275
276
|
# File 'lib/active_record/reflection.rb', line 274
def counter_must_be_updated_by_has_many?
!inverse_updates_counter_in_memory? && has_cached_counter?
end
|
#get_join_keys(association_klass) ⇒ Object
286
287
288
|
# File 'lib/active_record/reflection.rb', line 286
def get_join_keys(association_klass)
JoinKeys.new(join_pk(association_klass), join_fk)
end
|
#has_cached_counter? ⇒ Boolean
Returns whether a counter cache should be used for this association.
The counter_cache option must be given on either the owner or inverse association, and the column must be present on the owner.
268
269
270
271
272
|
# File 'lib/active_record/reflection.rb', line 268
def has_cached_counter?
options[:counter_cache] ||
inverse_which_updates_counter_cache && inverse_which_updates_counter_cache.options[:counter_cache] &&
!!active_record.columns_hash[counter_cache_column]
end
|
#inverse_of ⇒ Object
228
229
230
231
232
|
# File 'lib/active_record/reflection.rb', line 228
def inverse_of
return unless inverse_name
@inverse_of ||= klass._reflect_on_association inverse_name
end
|
#inverse_updates_counter_in_memory? ⇒ Boolean
260
261
262
|
# File 'lib/active_record/reflection.rb', line 260
def inverse_updates_counter_in_memory?
inverse_of && inverse_which_updates_counter_cache == inverse_of
end
|
#inverse_which_updates_counter_cache ⇒ Object
Also known as:
inverse_updates_counter_cache?
This shit is nasty. We need to avoid the following situation:
* An associated record is deleted via record.destroy
* Hence the callbacks run, and they find a belongs_to on the record with a
:counter_cache options which points back at our owner. So they update the
counter cache.
* In which case, we must make sure to *not* update the counter cache, or else
it will be decremented twice.
Hence this method.
252
253
254
255
256
257
|
# File 'lib/active_record/reflection.rb', line 252
def inverse_which_updates_counter_cache
return @inverse_which_updates_counter_cache if defined?(@inverse_which_updates_counter_cache)
@inverse_which_updates_counter_cache = klass.reflect_on_all_associations(:belongs_to).find do |inverse|
inverse.counter_cache_column == counter_cache_column
end
end
|
#join_keys ⇒ Object
176
177
178
|
# File 'lib/active_record/reflection.rb', line 176
def join_keys
get_join_keys klass
end
|
#join_scope(table) ⇒ Object
191
192
193
194
195
196
197
|
# File 'lib/active_record/reflection.rb', line 191
def join_scope(table)
predicate_builder = predicate_builder(table)
scope_chain_items = join_scopes(table, predicate_builder)
klass_scope = klass_join_scope(table, predicate_builder)
scope_chain_items.inject(klass_scope || scope_chain_items.shift, &:merge!)
end
|
#join_scopes(table, predicate_builder) ⇒ Object
199
200
201
202
203
204
205
|
# File 'lib/active_record/reflection.rb', line 199
def join_scopes(table, predicate_builder) if scope
[build_scope(table, predicate_builder).instance_exec(&scope)]
else
[]
end
end
|
#klass_join_scope(table, predicate_builder) ⇒ Object
207
208
209
210
|
# File 'lib/active_record/reflection.rb', line 207
def klass_join_scope(table, predicate_builder) relation = build_scope(table, predicate_builder)
klass.scope_for_association(relation)
end
|
#primary_key_type ⇒ Object
162
163
164
|
# File 'lib/active_record/reflection.rb', line 162
def primary_key_type
klass.type_for_attribute(klass.primary_key)
end
|
#quoted_table_name ⇒ Object
158
159
160
|
# File 'lib/active_record/reflection.rb', line 158
def quoted_table_name
klass.quoted_table_name
end
|
#scope_chain ⇒ Object
186
187
188
|
# File 'lib/active_record/reflection.rb', line 186
def scope_chain
chain.map(&:scopes)
end
|
#scopes ⇒ Object
Returns a list of scopes that should be applied for this Reflection object when querying the database.
182
183
184
|
# File 'lib/active_record/reflection.rb', line 182
def scopes
scope ? [scope] : []
end
|
#table_name ⇒ Object
148
149
150
|
# File 'lib/active_record/reflection.rb', line 148
def table_name
klass.table_name
end
|
#through_reflection? ⇒ Boolean
144
145
146
|
# File 'lib/active_record/reflection.rb', line 144
def through_reflection?
false
end
|