123456789_123456789_123456789_123456789_123456789_

Class: ActiveRecord::ConnectionAdapters::SavepointTransaction

Relationships & Source Files
Super Chains via Extension / Inclusion / Inheritance
Class Chain:
self, Transaction
Instance Chain:
self, Transaction
Inherits: ActiveRecord::ConnectionAdapters::Transaction
Defined in: activerecord/lib/active_record/connection_adapters/abstract/transaction.rb

Overview

Active Record Savepoint Transaction

Class Method Summary

Transaction - Inherited

.new

Instance Attribute Summary

Transaction - Inherited

#closed?, #connection, #dirty?, #full_rollback?,
#isolation

Returns the isolation level if it was explicitly set, nil otherwise.
#isolation=, #isolation_level, #joinable?, #materialized?, #open?,
#restartable?

Can this transaction’s current state be recreated by rollback+begin ?
#savepoint_name, #state, #user_transaction, #written

Instance Method Summary

Transaction - Inherited

#add_record, #after_commit, #after_rollback, #before_commit, #before_commit_records, #commit_records, #dirty!, #incomplete!, #invalidate!, #invalidated?, #materialize!, #records, #restore!, #rollback_records, #append_callbacks, #prepare_instances_to_run_callbacks_on, #run_action_on_records, #unique_records

Constructor Details

.new(connection, savepoint_name, parent_transaction, **options) ⇒ SavepointTransaction

[ GitHub ] 

  


# File 'activerecord/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 Attribute Details



  

    #full_rollback?  ⇒ Boolean  (readonly)
  

  [ GitHub ]


  

  


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



def full_rollback?; false; end


  








  

    #isolation   (rw)
  



  

    

Delegates to parent transaction’s isolation level


  



  [ GitHub ]


  

  


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



def isolation
  @parent_transaction.isolation
end


  








  

    #isolation=(isolation)   (rw)
  

  

    This method is for internal use only.
  

  [ GitHub ]


  

  


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



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


  







Instance Method Details



  

    #commit  
  

  [ GitHub ]


  

  


# File 'activerecord/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


  








  

    #materialize!  
  

  [ GitHub ]


  

  


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



def materialize!
  connection.create_savepoint(savepoint_name)
  super
end


  








  

    #restart  
  

  [ GitHub ]


  

  


# File 'activerecord/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  
  

  [ GitHub ]


  

  


# File 'activerecord/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