Module: ActiveRecord::Locking::Optimistic::ClassMethods

Defined in:
lib/active_record/locking/optimistic.rb

Constant Summary collapse

DEFAULT_LOCKING_COLUMN = 
"lock_version"

Instance Method Summary collapse

Instance Method Details

#locking_column ⇒ Object

The version column used for optimistic locking. Defaults to lock_version.



154
155
156
157
 
# File 'lib/active_record/locking/optimistic.rb', line 154

def locking_column
  @locking_column = DEFAULT_LOCKING_COLUMN unless defined?(@locking_column)
  @locking_column
end

#locking_column=(value) ⇒ Object

Set the column to use for optimistic locking. Defaults to lock_version.



148
149
150
151
 
# File 'lib/active_record/locking/optimistic.rb', line 148

def locking_column=(value)
  reload_schema_from_cache
  @locking_column = value.to_s
end

#locking_enabled? ⇒ Boolean

Returns true if the lock_optimistically flag is set to true (which it is, by default) and the table includes the locking_column column (defaults to lock_version).

Returns:

  • (Boolean) 


143
144
145
 
# File 'lib/active_record/locking/optimistic.rb', line 143

def locking_enabled?
  lock_optimistically && columns_hash[locking_column]
end

#reset_locking_column ⇒ Object

Reset the column used for optimistic locking back to the lock_version default.



160
161
162
 
# File 'lib/active_record/locking/optimistic.rb', line 160

def reset_locking_column
  self.locking_column = DEFAULT_LOCKING_COLUMN
end

#update_counters(id, counters) ⇒ Object

Make sure the lock version column gets updated when counters are updated.



166
167
168
169
 
# File 'lib/active_record/locking/optimistic.rb', line 166

def update_counters(id, counters)
  counters = counters.merge(locking_column => 1) if locking_enabled?
  super
end