Class: ActiveRecord::Associations::HasManyAssociation

Inherits:
CollectionAssociation show all
Includes:
ForeignAssociation
Defined in:
lib/active_record/associations/has_many_association.rb

Overview

This is the proxy that handles a has many association.

If the association has a :through option further specialization is provided by its child HasManyThroughAssociation.

Direct Known Subclasses

HasManyThroughAssociation

Instance Attribute Summary

Attributes inherited from Association

#inversed, #owner, #reflection, #target

Instance Method Summary collapse

Methods included from ForeignAssociation

#foreign_key_present?

Methods inherited from CollectionAssociation

#add_to_target, #any?, #build, #concat, #count, #create, #create!, #delete, #delete_all, #destroy, #destroy_all, #distinct, #fifth, #find, #first, #forty_two, #fourth, #ids_reader, #ids_writer, #include?, #last, #length, #load_target, #many?, #null_scope?, #reader, #replace, #replace_on_target, #reset, #scope, #second, #select, #size, #take, #third, #transaction, #writer

Methods inherited from Association

#aliased_table_name, #association_scope, #initialize, #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

This class inherits a constructor from ActiveRecord::Associations::Association

Instance Method Details

#empty? ⇒ Boolean

Returns:

  • (Boolean) 


45
46
47
48
49
50
51
 
# File 'lib/active_record/associations/has_many_association.rb', line 45

def empty?
  if has_cached_counter?
    size.zero?
  else
    super
  end
end

#handle_dependency ⇒ Object 



11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
 
# File 'lib/active_record/associations/has_many_association.rb', line 11

def handle_dependency
  case options[:dependent]
  when :restrict_with_exception
    raise ActiveRecord::DeleteRestrictionError.new(reflection.name) unless empty?

  when :restrict_with_error
    unless empty?
      record = klass.human_attribute_name(reflection.name).downcase
      owner.errors.add(:base, :"restrict_dependent_destroy.many", record: record)
      false
    end

  else
    if options[:dependent] == :destroy
      # No point in executing the counter update since we're going to destroy the parent anyway
      load_target.each { |t| t.destroyed_by_association = reflection }
      destroy_all
    else
      delete_all
    end
  end
end

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



34
35
36
37
38
39
40
41
42
43
 
# File 'lib/active_record/associations/has_many_association.rb', line 34

def insert_record(record, validate = true, raise = false)
  set_owner_attributes(record)
  set_inverse_instance(record)

  if raise
    record.save!(:validate => validate)
  else
    record.save(:validate => validate)
  end
end