@@ -1,9 +1,9 @@ Locking ======= -Very simple plugin which adds the aquire_lock method to active record base. This is mysql only. +Very simple plugin which adds the acquire_lock method to active record base. This is mysql only. -As long as a lock of a certain name is acquired no other connection on the server is able to aquire the same lock. +As long as a lock of a certain name is acquired no other connection on the server is able to acquire the same lock. This is very useful for background tasks such as billing or search server re-indexing which would cause errors when they would be ran from multiple machines at the same time but you still want to run them from multiple machines at the same time for redundancy reasons. @@ -11,7 +11,7 @@ for redundancy reasons. Example ======= -Invoice.aquire_lock("Shopify billing") do +Invoice.acquire_lock("Shopify billing") do Invoice.find_all_due.each { |invoice| invoice.collect_payment! } @@ -23,4 +23,4 @@ Usecase # save to run on several machines at the same time: - ./script/runner 'Invoice.aquire_lock("Shopify billing") { Invoice.find_all_due.each { |invoice| invoice.collect_payment! } }' \ No newline at end of file + ./script/runner 'Invoice.acquire_lock("Shopify billing") { Invoice.find_all_due.each { |invoice| invoice.collect_payment! } }' \ No newline at end of file README @@ -11,8 +11,8 @@ module Locking module ClassMethods - # Aquires an application level lock in the mysql server. - def aquire_lock(lock_name = table_name, wait_timeout = 0) + # acquires an application level lock in the mysql server. + def acquire_lock(lock_name = table_name, wait_timeout = 0) case c = connection.select_value("SELECT GET_LOCK(#{quote_value(lock_name)}, #{quote_value(wait_timeout)})") when '1' yield if block_given? @@ -28,10 +28,10 @@ module Locking connection.select_one("SELECT RELEASE_LOCK(#{quote_value(lock_name)})") end - # Aquires an application level lock in the mysql server. Throws Locking::LockTimeout if the - # lock cannot be aquired. - def aquire_lock!(lock_name = table_name, wait_timeout = 0, &block) - aquire_lock(lock_name, table_name, &block) or raise LockTimeout, 'Timeout waiting for lock' + # acquires an application level lock in the mysql server. Throws Locking::LockTimeout if the + # lock cannot be acquired. + def acquire_lock!(lock_name = table_name, wait_timeout = 0, &block) + acquire_lock(lock_name, table_name, &block) or raise LockTimeout, 'Timeout waiting for lock' end end lib/locking.rb ef1e9941feb2788d6a4580bd7e033aaefad2cd73 Tobias Lütke tobi@jadedpixel.com http://github.com/tobi/locking/commit/835469ed48f4c2de95856fe2f221eaa624b267a2 835469ed48f4c2de95856fe2f221eaa624b267a2 2008-03-08T10:32:56-08:00 2008-03-08T10:32:56-08:00 Spelling 101: it's acquire not aquire 1be46f9e8af60e12304e378ffae04e891b7557cf Tobias Lütke tobi@jadedpixel.com