Class: ActiveRecord::ConnectionAdapters::SavepointTransaction

Inherits:
Transaction show all
Defined in:
activerecord/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

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.



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

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 



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

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

#full_rollback? ⇒ Boolean

Returns:

  • (Boolean) 


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

def full_rollback?; false; end

#isolation ⇒ Object

Delegates to parent transaction’s isolation level



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

def isolation
  @parent_transaction.isolation
end

#isolation=(isolation) ⇒ Object

:nodoc:



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

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

#materialize! ⇒ Object 



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

def materialize!
  connection.create_savepoint(savepoint_name)
  super
end

#restart ⇒ Object 



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

def restart
  return unless materialized?

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

  connection.rollback_to_savepoint(savepoint_name)
end

#rollback ⇒ Object 



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

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