Module: ActiveRecord::Transactions

Defined in:
lib/active_record/transactions.rb

Overview

See ActiveRecord::Transactions::ClassMethods for documentation.

Defined Under Namespace

Modules: ClassMethods Classes: TransactionError

Class Method Summary collapse

Instance Method Summary collapse

Class Method Details

.included(base) ⇒ Object 



9
10
11
12
13
14
15
16
17
 
# File 'lib/active_record/transactions.rb', line 9

def self.included(base)
  base.extend(ClassMethods)

  base.class_eval do
    [:destroy, :save, :save!].each do |method|
      alias_method_chain method, :transactions
    end
  end
end

Instance Method Details

#destroy_with_transactions ⇒ Object

:nodoc:



141
142
143
 
# File 'lib/active_record/transactions.rb', line 141

def destroy_with_transactions #:nodoc:
  with_transaction_returning_status(:destroy_without_transactions)
end

#rollback_active_record_state! ⇒ Object

Reset id and @new_record if the transaction rolls back.



154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
 
# File 'lib/active_record/transactions.rb', line 154

def rollback_active_record_state!
  id_present = has_attribute?(self.class.primary_key)
  previous_id = id
  previous_new_record = new_record?
  yield
rescue Exception
  @new_record = previous_new_record
  if id_present
    self.id = previous_id
  else
    @attributes.delete(self.class.primary_key)
    @attributes_cache.delete(self.class.primary_key)
  end
  raise
end

#save_with_transactions(perform_validation = true) ⇒ Object

:nodoc:



145
146
147
 
# File 'lib/active_record/transactions.rb', line 145

def save_with_transactions(perform_validation = true) #:nodoc:
  rollback_active_record_state! { with_transaction_returning_status(:save_without_transactions, perform_validation) }
end

#save_with_transactions! ⇒ Object

:nodoc:



149
150
151
 
# File 'lib/active_record/transactions.rb', line 149

def save_with_transactions! #:nodoc:
  rollback_active_record_state! { self.class.transaction { save_without_transactions! } }
end

#transaction(&block) ⇒ Object

See ActiveRecord::Transactions::ClassMethods for detailed documentation.



137
138
139
 
# File 'lib/active_record/transactions.rb', line 137

def transaction(&block)
  self.class.transaction(&block)
end

#with_transaction_returning_status(method, *args) ⇒ Object

Executes method within a transaction and captures its return value as a status flag. If the status is true the transaction is committed, otherwise a ROLLBACK is issued. In any case the status flag is returned.

This method is available within the context of an ActiveRecord::Base instance.



176
177
178
179
180
181
182
183
 
# File 'lib/active_record/transactions.rb', line 176

def with_transaction_returning_status(method, *args)
  status = nil
  self.class.transaction do
    status = send(method, *args)
    raise ActiveRecord::Rollback unless status
  end
  status
end