module ActiveRecord::AttributeMethods::Dirty
Public Instance Methods
Returns the original value of an attribute before the last save. Behaves similarly to attribute_was
. This method is useful in after callbacks to get the original value of an attribute before the save that just occurred
# File lib/active_record/attribute_methods/dirty.rb, line 73 def attribute_before_last_save(attr_name) mutations_before_last_save.original_value(attr_name) end
Alias for attribute_change
# File lib/active_record/attribute_methods/dirty.rb, line 93 def attribute_change_to_be_saved(attr_name) mutations_from_database.change_to_attribute(attr_name) end
Alias for attribute_was
# File lib/active_record/attribute_methods/dirty.rb, line 98 def attribute_in_database(attr_name) mutations_from_database.original_value(attr_name) end
Alias for changed_attributes
# File lib/active_record/attribute_methods/dirty.rb, line 118 def attributes_in_database mutations_from_database.changed_values end
Alias for changed
# File lib/active_record/attribute_methods/dirty.rb, line 113 def changed_attribute_names_to_save mutations_from_database.changed_attribute_names end
Alias for changes
# File lib/active_record/attribute_methods/dirty.rb, line 108 def changes_to_save mutations_from_database.changes end
Alias for changed?
# File lib/active_record/attribute_methods/dirty.rb, line 103 def has_changes_to_save? mutations_from_database.any_changes? end
reload
the record and clears changed attributes.
# File lib/active_record/attribute_methods/dirty.rb, line 30 def reload(*) super.tap do @previously_changed = ActiveSupport::HashWithIndifferentAccess.new @mutations_before_last_save = nil @attributes_changed_by_setter = ActiveSupport::HashWithIndifferentAccess.new @mutations_from_database = nil end end
Returns the change to an attribute during the last save. If the attribute was changed, the result will be an array containing the original value and the saved value.
Behaves similarly to attribute_change
. This method is useful in after callbacks, to see the change in an attribute that just occurred
This method can be invoked as saved_change_to_name
in instead of saved_change_to_attribute("name")
# File lib/active_record/attribute_methods/dirty.rb, line 65 def saved_change_to_attribute(attr_name) mutations_before_last_save.change_to_attribute(attr_name) end
Did this attribute change when we last saved? This method can be invoked as saved_change_to_name?
instead of saved_change_to_attribute?("name")
. Behaves similarly to attribute_changed?
. This method is useful in after callbacks to determine if the call to save changed a certain attribute.
Options¶ ↑
from
When passed, this method will return false unless the original value is equal to the given option
to
When passed, this method will return false unless the value was changed to the given value
# File lib/active_record/attribute_methods/dirty.rb, line 52 def saved_change_to_attribute?(attr_name, **options) mutations_before_last_save.changed?(attr_name, **options) end
Returns a hash containing all the changes that were just saved.
# File lib/active_record/attribute_methods/dirty.rb, line 83 def saved_changes mutations_before_last_save.changes end
Did the last call to save
have any changes to change?
# File lib/active_record/attribute_methods/dirty.rb, line 78 def saved_changes? mutations_before_last_save.any_changes? end
Alias for attribute_changed?
# File lib/active_record/attribute_methods/dirty.rb, line 88 def will_save_change_to_attribute?(attr_name, **options) mutations_from_database.changed?(attr_name, **options) end
Private Instance Methods
# File lib/active_record/attribute_methods/dirty.rb, line 139 def _create_record(*) id = partial_writes? ? super(keys_for_partial_write) : super changes_applied id end
# File lib/active_record/attribute_methods/dirty.rb, line 133 def _update_record(*) affected_rows = partial_writes? ? super(keys_for_partial_write) : super changes_applied affected_rows end
# File lib/active_record/attribute_methods/dirty.rb, line 145 def keys_for_partial_write changed_attribute_names_to_save & self.class.column_names end
# File lib/active_record/attribute_methods/dirty.rb, line 123 def write_attribute_without_type_cast(attr_name, value) name = attr_name.to_s if self.class.attribute_alias?(name) name = self.class.attribute_alias(name) end result = super(name, value) clear_attribute_change(name) result end