function TransactionTest::transactionOuterLayer

Same name in other branches
  1. 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.

3 calls to TransactionTest::transactionOuterLayer()
TransactionTest::testCommittedTransaction in core/tests/Drupal/KernelTests/Core/Database/TransactionTest.php
Tests a committed transaction.
TransactionTest::testTransactionRollBackNotSupported in core/tests/Drupal/KernelTests/Core/Database/TransactionTest.php
Tests transaction rollback on a database that doesn't support transactions.
TransactionTest::testTransactionRollBackSupported in core/tests/Drupal/KernelTests/Core/Database/TransactionTest.php
Tests transaction rollback on a database that supports transactions.

File

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

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->assertTrue($this->connection
            ->transactionDepth() == $depth, 'Transaction has rolled back to the last savepoint after calling rollBack().');
    }
}

Buggy or inaccurate documentation? Please file an issue. Need support? Need help programming? Connect with the Drupal community.