Spec-Zone.ru › Ruby on Rails 4.1

модуль ActiveRecord::AutosaveAssociation

Ассоциация Active Record с автоматическим сохранением

AutosaveAssociation — это модуль, который заботится об автоматическом сохранении связанных записей, когда сохраняется их родительская запись. Помимо сохранения, он также уничтожает любые связанные записи, помеченные на уничтожение. (См. mark_for_destruction и marked_for_destruction?).

Сохранение родительской записи, её ассоциаций и уничтожение помеченных ассоциаций происходит внутри транзакции. Это никогда не должно оставлять базу данных в несогласованном состоянии.

Если проверки для любой из ассоциаций завершатся неудачно, их сообщения об ошибках будут применены к родителю.

Обратите внимание, что это также означает, что ассоциации, помеченные на уничтожение, не будут уничтожены непосредственно. Однако они по-прежнему будут помечены на уничтожение.

Обратите внимание, что autosave: false не равно не объявлять :autosave. Когда параметр :autosave отсутствует, новые записи ассоциаций сохраняются, но обновлённые записи ассоциаций не сохраняются.

Проверка

Записи дочерних элементов проверяются, если :validate не false.

Обработчики событий

Ассоциация с опцией автоматического сохранения определяет несколько обработчиков событий в вашей модели (before_save, after_create, after_update). Обратите внимание, что обработчики событий выполняются в том порядке, в котором они были определены в модели. Следует избегать изменения содержимого ассоциации до выполнения обработчиков событий autosave. Размещение обработчиков событий после ассоциаций обычно является хорошей практикой.

Пример «один к одному»

class Post < ActiveRecord::Base
  has_one :author, autosave: true
end

Сохранение изменений в родительской и связанной модели теперь можно выполнять автоматически и атомарно:

post = Post.find(1)
post.title       # => "The current global position of migrating ducks"
post.author.name # => "alloy"

post.title = "On the migration of ducks"
post.author.name = "Eloy Duran"

post.save
post.reload
post.title       # => "On the migration of ducks"
post.author.name # => "Eloy Duran"

Уничтожение связанной модели в рамках действия сохранения родительской модели выполняется так же просто, как пометка её на уничтожение:

post.author.mark_for_destruction
post.author.marked_for_destruction? # => true

Обратите внимание, что модель ещё не удалена из базы данных:

id = post.author.id
Author.find_by(id: id).nil? # => false

post.save
post.reload.author # => nil

Теперь она уже удалена из базы данных:

Author.find_by(id: id).nil? # => true

Пример «один ко многим»

Когда :autosave не объявлен, новые дочерние элементы сохраняются при сохранении их родительского элемента:

class Post < ActiveRecord::Base
  has_many :comments # :autosave option is not declared
end

post = Post.new(title: 'ruby rocks')
post.comments.build(body: 'hello world')
post.save # => saves both post and comment

post = Post.create(title: 'ruby rocks')
post.comments.build(body: 'hello world')
post.save # => saves both post and comment

post = Post.create(title: 'ruby rocks')
post.comments.create(body: 'hello world')
post.save # => saves both post and comment

Когда :autosave имеет значение true, все дочерние элементы сохраняются, независимо от того, являются ли они новыми записями или нет:

class Post < ActiveRecord::Base
  has_many :comments, autosave: true
end

post = Post.create(title: 'ruby rocks')
post.comments.create(body: 'hello world')
post.comments[0].body = 'hi everyone'
post.comments.build(body: "good morning.")
post.title += "!"
post.save # => saves both post and comments.

Уничтожение одной из связанных моделей в рамках действия сохранения родительской модели выполняется так же просто, как пометка её на уничтожение:

post.comments # => [#<Comment id: 1, ...>, #<Comment id: 2, ...]>
post.comments[1].mark_for_destruction
post.comments[1].marked_for_destruction? # => true
post.comments.length # => 2

Обратите внимание, что модель ещё не удалена из базы данных:

id = post.comments.last.id
Comment.find_by(id: id).nil? # => false

post.save
post.reload.comments.length # => 1

Теперь она уже удалена из базы данных:

Comment.find_by(id: id).nil? # => true

Общедоступные методы экземпляров

changed_for_autosave?() Показать исходный код

Возвращает значение true, если эта запись каким-либо образом была изменена (включая то, были ли изменены какие-либо вложенные ассоциации autosave)

# File activerecord/lib/active_record/autosave_association.rb, line 264
def changed_for_autosave?
  new_record? || changed? || marked_for_destruction? || nested_records_changed_for_autosave?
end
destroyed_by_association() Показать исходный код

Возвращает ассоциацию для родительского элемента, который уничтожается.

Используется для того, чтобы избежать ненужного обновления кэша счётчика.

# File activerecord/lib/active_record/autosave_association.rb, line 258
def destroyed_by_association
  @destroyed_by_association
end
destroyed_by_association=(reflection) Показать исходный код

Записывает ассоциацию, которая уничтожается, и уничтожает эту запись в процессе.

# File activerecord/lib/active_record/autosave_association.rb, line 251
def destroyed_by_association=(reflection)
  @destroyed_by_association = reflection
end
mark_for_destruction() Показать исходный код

Помечает эту запись на уничтожение в рамках транзакции сохранения родительского элемента. Это не фактически уничтожает запись мгновенно, а скорее дочерняя запись будет уничтожена, когда будет вызван parent.save.

Полезно только в том случае, если параметр :autosave у родителя включён для этой связанной модели.

# File activerecord/lib/active_record/autosave_association.rb, line 238
def mark_for_destruction
  @marked_for_destruction = true
end
marked_for_destruction?() Показать исходный код

Возвращает значение true, если эта запись будет уничтожена в рамках транзакции сохранения родительского элемента.

Полезно только в том случае, если параметр :autosave у родителя включён для этой связанной модели.

# File activerecord/lib/active_record/autosave_association.rb, line 245
def marked_for_destruction?
  @marked_for_destruction
end
reload(options = nil) Показать исходный код

Перезагружает атрибуты объекта, как обычно, и очищает флаг marked_for_destruction.

Вызывает метод суперкласса
# File activerecord/lib/active_record/autosave_association.rb, line 227
def reload(options = nil)
  @marked_for_destruction = false
  @destroyed_by_association = nil
  super
end

© 2004–2016 David Heinemeier Hansson
Licensed under the MIT License.

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API