Class: ActiveRecord::Associations::HasOneAssociation

Inherits:
SingularAssociation show all
Includes:
ForeignAssociation
Defined in:
lib/active_record/associations/has_one_association.rb

Overview

:nodoc:

Direct Known Subclasses

HasOneThroughAssociation

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 SingularAssociation

#build, #create, #create!, #reader, #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

#delete(method = options[:dependent]) ⇒ Object 



60
61
62
63
64
65
66
67
68
69
70
71
 
# File 'lib/active_record/associations/has_one_association.rb', line 60

def delete(method = options[:dependent])
  if load_target
    case method
      when :delete
        target.delete
      when :destroy
        target.destroy
      when :nullify
        target.update_columns(reflection.foreign_key => nil) if target.persisted?
    end
  end
end

#handle_dependency ⇒ Object 



7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
 
# File 'lib/active_record/associations/has_one_association.rb', line 7

def handle_dependency
  case options[:dependent]
  when :restrict_with_exception
    raise ActiveRecord::DeleteRestrictionError.new(reflection.name) if load_target

  when :restrict_with_error
    if load_target
      record = owner.class.human_attribute_name(reflection.name).downcase
      message = owner.errors.generate_message(:base, :'restrict_dependent_destroy.one', record: record, raise: true) rescue nil
      if message
        ActiveSupport::Deprecation.warn(<<-MESSAGE.squish)
          The error key `:'restrict_dependent_destroy.one'` has been deprecated and will be removed in Rails 5.1.
          Please use `:'restrict_dependent_destroy.has_one'` instead.
        MESSAGE
      end
      owner.errors.add(:base, message || :'restrict_dependent_destroy.has_one', record: record)
      throw(:abort)
    end

  else
    delete
  end
end

#replace(record, save = true) ⇒ Object 



31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
 
# File 'lib/active_record/associations/has_one_association.rb', line 31

def replace(record, save = true)
  raise_on_type_mismatch!(record) if record
  load_target

  return self.target if !(target || record)

  assigning_another_record = target != record
  if assigning_another_record || record.changed?
    save &&= owner.persisted?

    transaction_if(save) do
      remove_target!(options[:dependent]) if target && !target.destroyed? && assigning_another_record

      if record
        set_owner_attributes(record)
        set_inverse_instance(record)

        if save && !record.save
          nullify_owner_attributes(record)
          set_owner_attributes(target) if target
          raise RecordNotSaved, "Failed to save the new associated #{reflection.name}."
        end
      end
    end
  end

  self.target = record
end