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

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

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

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

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

Обратите внимание, что autosave: false — это не то же самое, что не объявлять :autosave. Если параметр :autosave не указан, новые записи ассоциаций сохраняются, а обновлённые записи ассоциаций — нет.

Проверка

Дочерние записи проверяются, если только :validate не равно false.

Обратные вызовы

Ассоциация с параметром autosave определяет несколько обратных вызовов для вашей модели (around_save, 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')
comment = post.comments.create(body: 'hello world')
comment.body = 'hi everyone'
post.save # => saves post, but not comment

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

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

post = Post.create(title: 'ruby rocks')
comment = post.comments.create(body: 'hello world')
comment.body = 'hi everyone'
post.comments.build(body: "good morning.")
post.save # => saves post and both 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

Ограничения

Обратите внимание, что autosave срабатывает для уже сохранённых записей ассоциаций только в том случае, если сами эти записи были изменены. Это предотвращает SystemStackError, вызванные циклическими проверками ассоциаций. Исключение составляет использование пользовательского контекста проверки: в этом случае проверки связанных записей выполняются всегда.