Class: ActiveRecord::ConnectionAdapters::SavepointTransaction

Inherits:
Transaction
  • Object
show all
Defined in:
lib/active_record/connection_adapters/abstract/transaction.rb

Overview

Active Record Savepoint Transaction

Instance Attribute Summary

Attributes inherited from Transaction

#connection, #isolation_level, #savepoint_name, #state, #user_transaction, #written

Instance Method Summary collapse

Methods inherited from Transaction

#add_record, #after_commit, #after_rollback, #before_commit, #before_commit_records, #closed?, #commit_records, #dirty!, #dirty?, #incomplete!, #joinable?, #materialized?, #open?, #records, #restartable?, #restore!, #rollback_records

Constructor Details

#initialize(connection, savepoint_name, parent_transaction, **options) ⇒ SavepointTransaction

Returns a new instance of SavepointTransaction.



416
417
418
419
420
421
422
423
424
425
426
427
 
# File 'lib/active_record/connection_adapters/abstract/transaction.rb', line 416

def initialize(connection, savepoint_name, parent_transaction, **options)
  super(connection, **options)

  @parent_transaction = parent_transaction
  parent_transaction.state.add_child(@state)

  if isolation_level
    raise ActiveRecord::TransactionIsolationError, "cannot set transaction isolation in a nested transaction"
  end

  @savepoint_name = savepoint_name
end

Instance Method Details

#commit ⇒ Object 



460
461
462
463
464
 
# File 'lib/active_record/connection_adapters/abstract/transaction.rb', line 460

def commit
  connection.release_savepoint(savepoint_name) if materialized?
  @state.commit!
  @instrumenter.finish(:commit) if materialized?
end

#full_rollback? ⇒ Boolean

Returns:

  • (Boolean) 


466
 
# File 'lib/active_record/connection_adapters/abstract/transaction.rb', line 466

def full_rollback?; false; end

#isolation ⇒ Object

Delegates to parent transaction’s isolation level



430
431
432
 
# File 'lib/active_record/connection_adapters/abstract/transaction.rb', line 430

def isolation
  @parent_transaction.isolation
end

#isolation=(isolation) ⇒ Object

:nodoc:



434
435
436
 
# File 'lib/active_record/connection_adapters/abstract/transaction.rb', line 434

def isolation=(isolation) # :nodoc:
  @parent_transaction.isolation = isolation
end

#materialize! ⇒ Object 



438
439
440
441
 
# File 'lib/active_record/connection_adapters/abstract/transaction.rb', line 438

def materialize!
  connection.create_savepoint(savepoint_name)
  super
end

#restart ⇒ Object 



443
444
445
446
447
448
449
450
 
# File 'lib/active_record/connection_adapters/abstract/transaction.rb', line 443

def restart
  return unless materialized?

  @instrumenter.finish(:restart)
  @instrumenter.start

  connection.rollback_to_savepoint(savepoint_name)
end

#rollback ⇒ Object 



452
453
454
455
456
457
458
 
# File 'lib/active_record/connection_adapters/abstract/transaction.rb', line 452

def rollback
  unless @state.invalidated?
    connection.rollback_to_savepoint(savepoint_name) if materialized? && connection.active?
  end
  @state.rollback!
  @instrumenter.finish(:rollback) if materialized?
end