Class: Mongoid::Relations::Bindings::Embedded::One

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

Overview

Binding class for embeds_one relations.

Constant Summary

Constants inherited from Mongoid::Relations::Binding

Mongoid::Relations::Binding::OPTIONS

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(options = {}) ⇒ 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 document.

person.name.bind(:continue => true)
person.name = Name.new

Parameters:

  • options (Hash) (defaults to: {})

    The options to pass through.

Options Hash (options):

  • :continue (true, false)

    Do we continue binding?

  • :binding (true, false)

    Are we in build mode?

Since:

  • 2.0.0.rc.1



26
27
28
29
30
31
32
33
34
35
# File 'lib/mongoid/relations/bindings/embedded/one.rb', line 26

def bind(options = {})
  if options[:continue]
    target.do_or_do_not(
      .inverse_setter(target),
      base,
      :binding => true,
      :continue => false
    )
  end
end

#unbind(options = {}) ⇒ Object Also known as: unbind_one

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

Examples:

Unbind the document.

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

Parameters:

  • options (Hash) (defaults to: {})

    The options to pass through.

Options Hash (options):

  • :continue (true, false)

    Do we continue unbinding?

  • :binding (true, false)

    Are we in build mode?

Since:

  • 2.0.0.rc.1



51
52
53
54
55
56
57
58
59
60
# File 'lib/mongoid/relations/bindings/embedded/one.rb', line 51

def unbind(options = {})
  if options[:continue]
    target.do_or_do_not(
      .inverse_setter(target),
      nil,
      :binding => true,
      :continue => false
    )
  end
end