Class: ActiveRecord::Associations::HasManyThroughAssociation

Inherits:
HasManyAssociation show all
Includes:
ThroughAssociation
Defined in:
lib/active_record/associations/has_many_through_association.rb

Overview

:nodoc:

Instance Attribute Summary

Attributes inherited from Association

#inversed, #owner, #reflection, #target

Instance Method Summary collapse

Methods inherited from HasManyAssociation

#handle_dependency

Methods inherited from CollectionAssociation

#add_to_target, #any?, #build, #count, #create, #create!, #delete, #delete_all, #destroy, #destroy_all, #distinct, #empty?, #find, #first, #ids_reader, #ids_writer, #include?, #last, #length, #load_target, #many?, #null_scope?, #reader, #replace, #reset, #scope, #select, #transaction, #writer

Methods inherited from Association

#aliased_table_name, #association_scope, #initialize_attributes, #interpolate, #klass, #load_target, #loaded!, #loaded?, #marshal_dump, #marshal_load, #reload, #reset, #reset_scope, #scope, #scoped, #set_inverse_instance, #stale_target?, #target_scope

Constructor Details

#initialize(owner, reflection) ⇒ HasManyThroughAssociation

Returns a new instance of HasManyThroughAssociation.



8
9
10
11
12
13
 
# File 'lib/active_record/associations/has_many_through_association.rb', line 8

def initialize(owner, reflection)
  super

  @through_records     = {}
  @through_association = nil
end

Instance Method Details

#concat(*records) ⇒ Object 



29
30
31
32
33
34
35
36
37
38
 
# File 'lib/active_record/associations/has_many_through_association.rb', line 29

def concat(*records)
  unless owner.new_record?
    records.flatten.each do |record|
      raise_on_type_mismatch!(record)
      record.save! if record.new_record?
    end
  end

  super
end

#concat_records(records) ⇒ Object 



40
41
42
43
44
45
46
47
48
49
50
51
52
 
# File 'lib/active_record/associations/has_many_through_association.rb', line 40

def concat_records(records)
  ensure_not_nested

  records = super

  if owner.new_record? && records
    records.flatten.each do |record|
      build_through_record(record)
    end
  end

  records
end

#insert_record(record, validate = true, raise = false) ⇒ Object 



54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
 
# File 'lib/active_record/associations/has_many_through_association.rb', line 54

def insert_record(record, validate = true, raise = false)
  ensure_not_nested

  if record.new_record?
    if raise
      record.save!(:validate => validate)
    else
      return unless record.save(:validate => validate)
    end
  end

  save_through_record(record)
  update_counter(1)
  record
end

#size ⇒ Object

Returns the size of the collection by executing a SELECT COUNT(*) query if the collection hasn’t been loaded and calling collection.size if it has. If it’s more likely than not that the collection does have a size larger than zero, and you need to fetch that collection afterwards, it’ll take one fewer SELECT query if you use #length.



19
20
21
22
23
24
25
26
27
 
# File 'lib/active_record/associations/has_many_through_association.rb', line 19

def size
  if has_cached_counter?
    owner.send(:read_attribute, cached_counter_attribute_name)
  elsif loaded?
    target.size
  else
    count
  end
end