From 25bb98e42daa98c4207ea19bb80525d2b7cf8962 Mon Sep 17 00:00:00 2001 From: David Heinemeier Hansson Date: Wed, 21 Feb 2007 22:13:39 +0000 Subject: Added database connection as a yield parameter to ActiveRecord::Base.transaction so you can manually rollback [DHH] git-svn-id: http://svn-commit.rubyonrails.org/rails/trunk@6196 5ecf4fe2-1ee6-0310-87b1-e25e094e27de --- activerecord/lib/active_record/transactions.rb | 11 +++++++++++ 1 file changed, 11 insertions(+) (limited to 'activerecord/lib/active_record/transactions.rb') diff --git a/activerecord/lib/active_record/transactions.rb b/activerecord/lib/active_record/transactions.rb index 77a8a14a2a..d9bfd331c6 100644 --- a/activerecord/lib/active_record/transactions.rb +++ b/activerecord/lib/active_record/transactions.rb @@ -32,6 +32,17 @@ module ActiveRecord # Exceptions will force a ROLLBACK that returns the database to the state before the transaction was begun. Be aware, though, # that the objects by default will _not_ have their instance data returned to their pre-transactional state. # + # == Rolling back a transaction manually + # + # Instead of relying on exceptions to rollback your transactions, you can also do so manually from within the scope + # of the transaction by accepting a yield parameter and calling rollback! on it. Example: + # + # transaction do |transaction| + # david.withdrawal(100) + # mary.deposit(100) + # transaction.rollback! # rolls back the transaction that was otherwise going to be successful + # end + # # == Transactions are not distributed across database connections # # A transaction acts on a single database connection. If you have -- cgit v1.2.3