модуль 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
Общедоступные методы экземпляров
Возвращает значение 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
Возвращает ассоциацию для родительского элемента, который уничтожается.
Используется для того, чтобы избежать ненужного обновления кэша счётчика.
# File activerecord/lib/active_record/autosave_association.rb, line 258 def destroyed_by_association @destroyed_by_association end
Записывает ассоциацию, которая уничтожается, и уничтожает эту запись в процессе.
# File activerecord/lib/active_record/autosave_association.rb, line 251 def destroyed_by_association=(reflection) @destroyed_by_association = reflection end
Помечает эту запись на уничтожение в рамках транзакции сохранения родительского элемента. Это не фактически уничтожает запись мгновенно, а скорее дочерняя запись будет уничтожена, когда будет вызван parent.save.
Полезно только в том случае, если параметр :autosave у родителя включён для этой связанной модели.
# File activerecord/lib/active_record/autosave_association.rb, line 238 def mark_for_destruction @marked_for_destruction = true end
Возвращает значение true, если эта запись будет уничтожена в рамках транзакции сохранения родительского элемента.
Полезно только в том случае, если параметр :autosave у родителя включён для этой связанной модели.
# File activerecord/lib/active_record/autosave_association.rb, line 245 def marked_for_destruction? @marked_for_destruction end
Перезагружает атрибуты объекта, как обычно, и очищает флаг 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.