модуль ActiveModel::Dirty

Активный Модель Изменённые Данные

Предоставляет способ отслеживать изменения в вашем объекте так же, как это делает Active Record.

Требования к реализации ActiveModel::Dirty:

• include ActiveModel::Dirty в вашем объекте.

• Вызвать define_attribute_methods, передавая каждый метод, который вы хотите отслеживать.

• Вызвать [attr_name]_will_change! перед каждым изменением отслеживаемого атрибута.

• Вызвать changes_applied после сохранения изменений.

• Вызвать clear_changes_information при необходимости сброса информации о внесённых изменениях.

• Вызвать restore_attributes при необходимости восстановления предыдущих данных.

Минимальная реализация может быть:

class Person
  include ActiveModel::Dirty

  define_attribute_methods :name

  def initialize
    @name = nil
  end

  def name
    @name
  end

  def name=(val)
    name_will_change! unless val == @name
    @name = val
  end

  def save
    # do persistence work

    changes_applied
  end

  def reload!
    # get the values from the persistence layer

    clear_changes_information
  end

  def rollback!
    restore_attributes
  end
end

Новый экземпляр Person объекта не изменён:

person = Person.new
person.changed? # => false

Изменить имя:

person.name = 'Bob'
person.changed?       # => true
person.name_changed?  # => true
person.name_changed?(from: nil, to: "Bob") # => true
person.name_was       # => nil
person.name_change    # => [nil, "Bob"]
person.name = 'Bill'
person.name_change    # => [nil, "Bill"]

Сохранить изменения:

person.save
person.changed?      # => false
person.name_changed? # => false

Сбросить изменения:

person.previous_changes         # => {"name" => [nil, "Bill"]}
person.name_previously_changed? # => true
person.name_previously_changed?(from: nil, to: "Bill") # => true
person.name_previous_change     # => [nil, "Bill"]
person.name_previously_was      # => nil
person.reload!
person.previous_changes         # => {}

Отменить изменения:

person.name = "Uncle Bob"
person.rollback!
person.name          # => "Bill"
person.name_changed? # => false

Присвоение того же значения не меняет атрибут:

person.name = 'Bill'
person.name_changed? # => false
person.name_change   # => nil

Какие атрибуты изменились?

person.name = 'Bob'
person.changed # => ["name"]
person.changes # => {"name" => ["Bill", "Bob"]}

Если атрибут изменяется непосредственно, используйте [attribute_name]_will_change! для отметки изменения атрибута. В противном случае Active Model не сможет отслеживать изменения в атрибутах, изменённых непосредственно. Обратите внимание, что Active Record может автоматически обнаруживать такие изменения. Вам не нужно вызывать [attribute_name]_will_change! для моделей Active Record.

person.name_will_change!
person.name_change # => ["Bill", "Bill"]
person.name << 'y'
person.name_change # => ["Bill", "Billy"]