модуль ActiveRecord::Locking::Pessimistic

Locking::Pessimistic предоставляет поддержку блокировки строк с помощью SELECT … FOR UPDATE и других типов блокировок.

Цепочка ActiveRecord::Base#find до ActiveRecord::QueryMethods#lock для получения эксклюзивной блокировки выбранных строк:

# select * from accounts where id=1 for update
Account.lock.find(1)

Вызов lock('some locking clause') для использования специфичного для базы данных условия блокировки, например, 'LOCK IN SHARE MODE' или 'FOR UPDATE NOWAIT'. Пример:

Account.transaction do
  # select * from accounts where name = 'shugo' limit 1 for update
  shugo = Account.where("name = 'shugo'").lock(true).first
  yuko = Account.where("name = 'yuko'").lock(true).first
  shugo.balance -= 100
  shugo.save!
  yuko.balance += 100
  yuko.save!
end

Также можно использовать метод ActiveRecord::Base#lock! для блокировки одной записи по идентификатору. Это может быть лучше, если вам не нужно блокировать каждую строку. Пример:

Account.transaction do
  # select * from accounts where ...
  accounts = Account.where(...)
  account1 = accounts.detect { |account| ... }
  account2 = accounts.detect { |account| ... }
  # select * from accounts where id=? for update
  account1.lock!
  account2.lock!
  account1.balance -= 100
  account1.save!
  account2.balance += 100
  account2.save!
end

Можно начать транзакцию и получить блокировку за один раз, вызвав with_lock с блоком. Блок вызывается внутри транзакции, объект уже заблокирован. Пример:

account = Account.first
account.with_lock do
  # This block is called within a transaction,
  # account is already locked.
  account.balance -= 100
  account.save!
end

Информация о блокировке строк, специфичная для базы данных:

MySQL: http://dev.mysql.com/doc/refman/5.1/en/innodb-locking-reads.html
PostgreSQL: http://www.postgresql.org/docs/current/interactive/sql-select.html#SQL-FOR-UPDATE-SHARE

Общедоступные методы экземпляров

lock!(lock = true) Показать исходный код

# File activerecord/lib/active_record/locking/pessimistic.rb, line 61
def lock!(lock = true)
  reload(:lock => lock) if persisted?
  self
end

Получение блокировки строки для этой записи. Перезагружает запись, чтобы получить запрашиваемую блокировку. Передайте SQL-условие блокировки для добавления в конец оператора SELECT или передайте true для “FOR UPDATE” (по умолчанию, эксклюзивная блокировка строки). Возвращает заблокированную запись.

with_lock(lock = true) { || ... } Показать исходный код

# File activerecord/lib/active_record/locking/pessimistic.rb, line 69
def with_lock(lock = true)
  transaction do
    lock!(lock)
    yield
  end
end

Оборачивает переданный блок в транзакцию, блокируя объект перед передачей. Можно передать SQL-условие блокировки в качестве аргумента (см. lock!).