модуль ActiveRecord::AutosaveAssociation
Связь Active Record Autosave
AutosaveAssociation — это модуль, который заботится об автоматическом сохранении связанных записей при сохранении родительской записи. Помимо сохранения, он также удаляет любые связанные записи, помеченные для удаления. (См. mark_for_destruction и marked_for_destruction?).
Сохранение родителя, его ассоциаций и удаление помеченных ассоциаций происходит внутри транзакции. Это никогда не должно оставлять базу данных в несогласованном состоянии.
Если проверки для любой из ассоциаций завершаются неудачно, их сообщения об ошибках будут применены к родителю.
Обратите внимание, что это также означает, что ассоциации, помеченные для удаления, не будут удалены напрямую. Однако они все равно будут помечены для удаления.
Обратите внимание, что autosave: false не эквивалентно тому, что :autosave не объявлено. Когда опция :autosave отсутствует, новые записи ассоциаций сохраняются, но обновленные записи ассоциаций не сохраняются.
Проверка
Записи потомков проверяются, если :validate не false.
Обработчики событий
Ассоциация с параметром autosave определяет несколько обработчиков событий в вашей модели (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
Методы открытого экземпляра
# File activerecord/lib/active_record/autosave_association.rb, line 261 def changed_for_autosave? new_record? || changed? || marked_for_destruction? || nested_records_changed_for_autosave? end
Возвращает значение true, если эта запись каким-либо образом изменена (включая случай, когда какие-либо из ее вложенных ассоциаций autosave также изменены).
# File activerecord/lib/active_record/autosave_association.rb, line 255 def destroyed_by_association @destroyed_by_association end
Возвращает ассоциацию для родителя, который будет удален.
Используется для предотвращения ненужного обновления счётчика.
# File activerecord/lib/active_record/autosave_association.rb, line 248 def destroyed_by_association=(reflection) @destroyed_by_association = reflection end
Записывает ассоциацию, которая будет удалена, и в процессе удаляет эту запись.
# File activerecord/lib/active_record/autosave_association.rb, line 235 def mark_for_destruction @marked_for_destruction = true end
Помечает эту запись для удаления в рамках транзакции сохранения родительской записи. Это не фактически удаляет запись немедленно, а скорее дочерняя запись будет удалена, когда будет вызвано parent.save.
Полезно только в том случае, если опция :autosave для родительского элемента включена для этой связанной модели.
# File activerecord/lib/active_record/autosave_association.rb, line 242 def marked_for_destruction? @marked_for_destruction end
Возвращает значение true, если эта запись будет удалена в рамках транзакции сохранения родительской записи.
Полезно только в том случае, если опция :autosave для родительского элемента включена для этой связанной модели.
# File activerecord/lib/active_record/autosave_association.rb, line 224 def reload(options = nil) @marked_for_destruction = false @destroyed_by_association = nil super end
Перезагружает атрибуты объекта обычным способом и очищает флаг marked_for_destruction.
© 2004–2018 David Heinemeier Hansson
Licensed under the MIT License.