Class: Mongoid::Relations::Bindings::Referenced::In

Inherits:
Mongoid::Relations::Binding show all
Defined in:
lib/mongoid/relations/bindings/referenced/in.rb

Overview

Binding class for all referenced_in relations.

Instance Attribute Summary

Attributes inherited from Mongoid::Relations::Binding

#base, #metadata, #target

Instance Method Summary collapse

Methods inherited from Mongoid::Relations::Binding

#initialize

Constructor Details

This class inherits a constructor from Mongoid::Relations::Binding

Instance Method Details

#bind ⇒ Object Also known as: bind_one

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

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

Examples:

Bind the documents.

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

Since:

  • 2.0.0.rc.1



21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
 
# File 'lib/mongoid/relations/bindings/referenced/in.rb', line 21

def bind
  unless _binding?
    _binding do
      inverse = metadata.inverse(target)
      base.you_must(metadata.foreign_key_setter, target.id)
      if metadata.inverse_type
        base.you_must(metadata.inverse_type_setter, target.class.model_name)
      end
      if inverse
        inverse_metadata = metadata.inverse_metadata(target)
        if inverse_metadata != metadata && !inverse_metadata.nil?
          base.metadata = inverse_metadata
          if base.referenced_many?
            target.send(inverse).push(base) unless Mongoid.identity_map_enabled?
          else
            target.do_or_do_not(metadata.inverse_setter(target), base)
          end
        end
      end
    end
  end
end

#unbind ⇒ Object Also known as: unbind_one

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

Since:

  • 2.0.0.rc.1



53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
 
# File 'lib/mongoid/relations/bindings/referenced/in.rb', line 53

def unbind
  unless _binding?
    _binding do
      inverse = metadata.inverse(target)
      base.you_must(metadata.foreign_key_setter, nil)
      if metadata.inverse_type
        base.you_must(metadata.inverse_type_setter, nil)
      end
      if inverse
        if base.referenced_many?
          target.send(inverse).delete(base)
        else
          target.send(metadata.inverse_setter(target), nil)
        end
      end
    end
  end
end