You are here

protected function TransactionTest::transactionOuterLayer in Drupal 10

Same name and namespace in other branches
  1. 8 core/tests/Drupal/KernelTests/Core/Database/TransactionTest.php \Drupal\KernelTests\Core\Database\TransactionTest::transactionOuterLayer()
  2. 9 core/tests/Drupal/KernelTests/Core/Database/TransactionTest.php \Drupal\KernelTests\Core\Database\TransactionTest::transactionOuterLayer()

Encapsulates a transaction's "inner layer" with an "outer layer".

This "outer layer" transaction starts and then encapsulates the "inner layer" transaction. This nesting is used to evaluate whether the database transaction API properly supports nesting. By "properly supports," we mean the outer transaction continues to exist regardless of what functions are called and whether those functions start their own transactions.

In contrast, a typical database would commit the outer transaction, start a new transaction for the inner layer, commit the inner layer transaction, and then be confused when the outer layer transaction tries to commit its transaction (which was already committed when the inner transaction started).

Parameters

$suffix: Suffix to add to field values to differentiate tests.

$rollback: Whether or not to try rolling back the transaction when we're done.

$ddl_statement: Whether to execute a DDL statement during the inner transaction.

File

core/tests/Drupal/KernelTests/Core/Database/TransactionTest.php, line 55

Class

TransactionTest
Tests the transaction abstraction system.

Namespace

Drupal\KernelTests\Core\Database

Code

protected function transactionOuterLayer($suffix, $rollback = FALSE, $ddl_statement = FALSE) {
  $depth = $this->connection
    ->transactionDepth();
  $txn = $this->connection
    ->startTransaction();

  // Insert a single row into the testing table.
  $this->connection
    ->insert('test')
    ->fields([
    'name' => 'David' . $suffix,
    'age' => '24',
  ])
    ->execute();
  $this
    ->assertTrue($this->connection
    ->inTransaction(), 'In transaction before calling nested transaction.');

  // We're already in a transaction, but we call ->transactionInnerLayer
  // to nest another transaction inside the current one.
  $this
    ->transactionInnerLayer($suffix, $rollback, $ddl_statement);
  $this
    ->assertTrue($this->connection
    ->inTransaction(), 'In transaction after calling nested transaction.');
  if ($rollback) {

    // Roll back the transaction, if requested.
    // This rollback should propagate to the last savepoint.
    $txn
      ->rollBack();
    $this
      ->assertSame($depth, $this->connection
      ->transactionDepth(), 'Transaction has rolled back to the last savepoint after calling rollBack().');
  }
}