Class: Mongoid::Association::Referenced::BelongsTo::Binding

Inherits:
Object
  • Object
show all
Includes:
Bindable
Defined in:
lib/mongoid/association/referenced/belongs_to/binding.rb

Overview

Binding class for belongs_to associations.

Instance Attribute Summary

Attributes included from Bindable

#_association, #_base, #_target

Instance Method Summary collapse

Methods included from Bindable

#binding, #initialize

Instance Method Details

#bind_one ⇒ Object

Binds the base object to the inverse of the association. This is so we are referenced to the actual objects themselves on both sides.

This case sets the association on the inverse object as well as the document itself.

Examples:

Bind the documents.

game.person.bind(:continue => true)
game.person = Person.new


20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
 
# File 'lib/mongoid/association/referenced/belongs_to/binding.rb', line 20

def bind_one
  binding do
    check_polymorphic_inverses!(_target)
    bind_foreign_key(_base, record_id(_target))

    # set the inverse type (e.g. "#{name}_type") for new polymorphic associations
    if _association.inverse_type && !_base.frozen?
      key = _association.resolver.default_key_for(_target)
      bind_polymorphic_inverse_type(_base, key)
    end

    if (inverse = _association.inverse(_target)) && set_base_association
      if _base.referenced_many?
        _target.__send__(inverse).push(_base)
      else
        remove_associated(_target)
        _target.set_relation(inverse, _base)
      end
    end
  end
end

#unbind_one ⇒ Object

Unbinds the base object and the inverse, caused by setting the reference to nil.

Examples:

Unbind the document.

game.person.unbind(:continue => true)
game.person = nil


48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
 
# File 'lib/mongoid/association/referenced/belongs_to/binding.rb', line 48

def unbind_one
  binding do
    inverse = _association.inverse(_target)
    bind_foreign_key(_base, nil)
    bind_polymorphic_inverse_type(_base, nil)
    if inverse
      set_base_association
      if _base.referenced_many?
        _target.__send__(inverse).delete(_base)
      else
        _target.set_relation(inverse, nil)
      end
    end
  end
end