Class: ActiveRecord::Associations::HasOneAssociation

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

Overview

:nodoc:

Instance Method Summary collapse

Methods inherited from BelongsToAssociation

#reset

Methods inherited from AssociationProxy

#loaded, #loaded?, #method_missing, #proxy_respond_to?, #reload, #respond_to?, #target, #target=

Constructor Details

#initialize(owner, association_name, association_class_name, association_class_primary_key_name, options) ⇒ HasOneAssociation

Returns a new instance of HasOneAssociation.



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

def initialize(owner, association_name, association_class_name, association_class_primary_key_name, options)
  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 



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

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

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

  record
end

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



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

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

#replace(obj, dont_save = false) ⇒ Object 



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 29

def replace(obj, dont_save = false)
  load_target
  unless @target.nil?
    if dependent? && !dont_save     
      @target.destroy unless @target.new_record?
      @owner.clear_association_cache
    else
      @target[@association_class_primary_key_name] = nil
      @target.save unless @owner.new_record?
    end
  end

  if obj.nil?
    @target = nil
  else
    raise_on_type_mismatch(obj)
    
    obj[@association_class_primary_key_name] = @owner.id unless @owner.new_record?
    @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