Class: ActiveRecord::Associations::HasOneAssociation

Inherits:
BelongsToAssociation show all
Defined in:
lib/active_record/associations/has_one_association.rb

Overview

:nodoc:

Instance Attribute Summary

Attributes inherited from AssociationProxy

#reflection

Instance Method Summary collapse

Methods inherited from BelongsToAssociation

#updated?

Methods inherited from AssociationProxy

#===, #aliased_table_name, #conditions, #loaded, #loaded?, #proxy_owner, #proxy_reflection, #proxy_respond_to?, #proxy_target, #reload, #reset, #respond_to?, #target, #target=

Constructor Details

#initialize(owner, reflection) ⇒ HasOneAssociation

Returns a new instance of HasOneAssociation.



4
5
6
7
 
# File 'lib/active_record/associations/has_one_association.rb', line 4

def initialize(owner, reflection)
  super
  construct_sql
end

Dynamic Method Handling

This class handles dynamic methods through the method_missing method in the class ActiveRecord::Associations::AssociationProxy

Instance Method Details

#build(attributes = {}, replace_existing = true) ⇒ Object 



15
16
17
18
19
20
21
22
23
24
25
26
 
# File 'lib/active_record/associations/has_one_association.rb', line 15

def build(attributes = {}, replace_existing = true)
  record = @reflection.klass.new(attributes)

  if replace_existing
    replace(record, true) 
  else
    record[@reflection.primary_key_name] = @owner.id unless @owner.new_record?
    self.target = record
  end

  record
end

#create(attributes = {}, replace_existing = true) ⇒ Object 



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

def create(attributes = {}, replace_existing = true)
  record = build(attributes, replace_existing)
  record.save
  record
end

#replace(obj, dont_save = false) ⇒ Object 



28
29
30
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
 
# File 'lib/active_record/associations/has_one_association.rb', line 28

def replace(obj, dont_save = false)
  load_target

  unless @target.nil?
    if dependent? && !dont_save && @target != obj
      @target.destroy unless @target.new_record?
      @owner.clear_association_cache
    else
      @target[@reflection.primary_key_name] = nil
      @target.save unless @owner.new_record? || @target.new_record?
    end
  end

  if obj.nil?
    @target = nil
  else
    raise_on_type_mismatch(obj)
    set_belongs_to_association_for(obj)
    @target = (AssociationProxy === obj ? obj.target : obj)
  end

  @loaded = true

  unless @owner.new_record? or obj.nil? or dont_save
    return (obj.save ? self : false)
  else
    return (obj.nil? ? nil : self)
  end
end