Class: Mongoid::Association::Embedded::EmbedsOne::Binding

Relationships & Source Files
Super Chains via Extension / Inclusion / Inheritance
Instance Chain: self, `::Mongoid::Association::Bindable`, `::Mongoid::Threaded::Lifecycle`
Inherits:	Object
Defined in:	lib/mongoid/association/embedded/embeds_one/binding.rb

Overview

Binding class for all embeds_one associations.

#_association, #_base, #_target

#_assigning	Begin the assignment of attributes.
#_assigning?	Is the current thread in assigning mode?
#_binding	Execute a block in binding mode.
#_binding?	Is the current thread in binding mode?
#_building	Execute a block in building mode.
#_building?	Is the current thread in building mode?
#_creating?	Is the current thread in creating mode?
#_loading	Execute a block in loading mode.
#_loading?	Is the current thread in loading mode?

#bind_one

Binds the base object to the inverse of the association.
#unbind_one

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

#binding	Execute the provided block inside a binding.
#initialize	Create the new binding.
#bind_foreign_key	`::Set` the id of the related document in the foreign key field on the keyed document.
#bind_from_relational_parent	Bind the provided document with the base from the parent association.
#bind_inverse	Bind the inverse document to the child document so that the in memory instances are the same.
#bind_polymorphic_inverse_type	`::Set` the type of the related document on the foreign type field, used when associations are polymorphic.
#bind_polymorphic_type	`::Set` the type of the related document on the foreign type field, used when associations are polymorphic.
#check_inverse!	Check if the inverse is properly defined.
#record_id,
#remove_associated	Remove the associated document from the inverse’s association.
#remove_associated_in_to	Remove the associated document from the inverse’s association.
#remove_associated_many	Remove the associated document from the inverse’s association.
#set_base_association	Ensure that the association on the base is correct, for the cases where we have multiple belongs to definitions and were are setting different parents in memory in order.
#try_method	Convenience method to perform `#try` but return nil if the method argument is nil.
#unbind_from_relational_parent	Bind the provided document with the base from the parent association.

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 metadata on the inverse object as well as the document itself.

Examples:

Bind the document.

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

[ GitHub ]

# File 'lib/mongoid/association/embedded/embeds_one/binding.rb', line 22


def bind_one
  _target.parentize(_base)
  binding do
    try_method(_target, _association.inverse_setter(_target), _base)
  end
end

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

[ GitHub ]

# File 'lib/mongoid/association/embedded/embeds_one/binding.rb', line 35


def unbind_one
  binding do
    try_method(_target, _association.inverse_setter(_target), nil)
  end
end