Class: ActiveRecord::Reflection::MacroReflection

Inherits:
AbstractReflection show all
Defined in:
lib/active_record/reflection.rb

Overview

Base class for AggregateReflection and AssociationReflection. Objects of AggregateReflection and AssociationReflection are returned by the Reflection::ClassMethods.

Direct Known Subclasses

AggregateReflection, AssociationReflection

Instance Attribute Summary collapse

Instance Method Summary collapse

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_active_cached_counter?, #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?, #strict_loading_violation_message, #table_name, #through_reflection?

Constructor Details

#initialize(name, scope, options, active_record) ⇒ MacroReflection

Returns a new instance of MacroReflection.



396
397
398
399
400
401
402
403
404
405
 
# File 'lib/active_record/reflection.rb', line 396

def initialize(name, scope, options, active_record)
  super()
  @name          = name
  @scope         = scope
  @options       = normalize_options(options)
  @active_record = active_record
  @klass         = options[:anonymous_class]
  @plural_name   = active_record.pluralize_table_names ?
                      name.to_s.pluralize : name.to_s
end

Instance Attribute Details

#active_record ⇒ Object (readonly)

Returns the value of attribute active_record.



392
393
394
 
# File 'lib/active_record/reflection.rb', line 392

def active_record
  @active_record
end

#name ⇒ Object (readonly)

Returns the name of the macro.

composed_of :balance, class_name: 'Money' returns :balance has_many :clients returns :clients



382
383
384
 
# File 'lib/active_record/reflection.rb', line 382

def name
  @name
end

#options ⇒ Object (readonly)

Returns the hash of options used for the macro.

composed_of :balance, class_name: 'Money' returns { class_name: "Money" } has_many :clients returns {}



390
391
392
 
# File 'lib/active_record/reflection.rb', line 390

def options
  @options
end

#plural_name ⇒ Object (readonly)

:nodoc:



394
395
396
 
# File 'lib/active_record/reflection.rb', line 394

def plural_name
  @plural_name
end

#scope ⇒ Object (readonly)

Returns the value of attribute scope.



384
385
386
 
# File 'lib/active_record/reflection.rb', line 384

def scope
  @scope
end

Instance Method Details

#==(other_aggregation) ⇒ Object

Returns true if self and other_aggregation have the same name attribute, active_record attribute, and other_aggregation has an options hash assigned to it.



448
449
450
451
452
453
454
 
# File 'lib/active_record/reflection.rb', line 448

def ==(other_aggregation)
  super ||
    other_aggregation.kind_of?(self.class) &&
    name == other_aggregation.name &&
    !other_aggregation.options.nil? &&
    active_record == other_aggregation.active_record
end

#_klass(class_name) ⇒ Object

:nodoc:



434
435
436
437
438
439
440
 
# File 'lib/active_record/reflection.rb', line 434

def _klass(class_name) # :nodoc:
  if active_record.name.demodulize == class_name
    return compute_class("::#{class_name}") rescue NameError
  end

  compute_class(class_name)
end

#autosave=(autosave) ⇒ Object 



407
408
409
410
411
412
413
 
# File 'lib/active_record/reflection.rb', line 407

def autosave=(autosave)
  @options[:autosave] = autosave
  parent_reflection = self.parent_reflection
  if parent_reflection
    parent_reflection.autosave = autosave
  end
end

#compute_class(name) ⇒ Object 



442
443
444
 
# File 'lib/active_record/reflection.rb', line 442

def compute_class(name)
  name.constantize
end

#klass ⇒ Object

Returns the class for the macro.

composed_of :balance, class_name: 'Money' returns the Money class has_many :clients returns the Client class

class Company < ActiveRecord::Base
  has_many :clients
end

Company.reflect_on_association(:clients).klass
# => Client

Note: Do not call klass.new or klass.create to instantiate a new association object. Use build_association or create_association instead. This allows plugins to hook into association object creation.



430
431
432
 
# File 'lib/active_record/reflection.rb', line 430

def klass
  @klass ||= _klass(class_name)
end

#scope_for(relation, owner = nil) ⇒ Object 



456
457
458
 
# File 'lib/active_record/reflection.rb', line 456

def scope_for(relation, owner = nil)
  relation.instance_exec(owner, &scope) || relation
end