Class: ActiveRecord::Associations::HasManyThroughAssociation

Inherits:
HasManyAssociation show all
Includes:
ThroughAssociation
Defined in:
activerecord/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?, #fifth, #find, #first, #forty_two, #fourth, #ids_reader, #ids_writer, #include?, #last, #length, #load_target, #many?, #null_scope?, #reader, #replace, #reset, #scope, #second, #select, #third, #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, #set_inverse_instance, #stale_target?, #target_scope

Constructor Details

- (HasManyThroughAssociation) initialize(owner, reflection)



8
9
10
11
12
13
# File 'activerecord/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

- (Object) concat(*records)



29
30
31
32
33
34
35
36
37
# File 'activerecord/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)
    end
  end

  super
end

- (Object) concat_records(records)



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

def concat_records(records)
  ensure_not_nested

  records = super(records, true)

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

  records
end

- (Object) insert_record(record, validate = true, raise = false)



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

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

- (Object) size

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 'activerecord/lib/active_record/associations/has_many_through_association.rb', line 19

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