classTransactionStatement

Sql packages/ztd-query-core/src/Sql/TransactionStatement.php:12

final class TransactionStatement

A structure-aware transaction-control statement.

Methods§

public function __construct(
    private TransactionOperation $operation,
    private string $savepointName = '',
)

100%source §

Binds a statement to what it does, and to the savepoint it names.

Every way of building one goes through a named constructor, because which operation it is decides whether a name means anything.

Parameters

`$operation`	`TransactionOperation`
`$savepointName`	`string`

Test cases 7

public static function begin(): self

100%source §

Begin.

Returns

self

Test cases 10

FakeTransactionStatementParser::parse calls
SessionTest::testApplyTransactionStatementDoesWhatTheStatementSays calls
SessionTest::testTransactionsAnswersWhatATransactionStatementIsAppliedTo calls
TransactionStatementTest::testApplyDoesWhatEachOperationSays covers and calls
TransactionStatementTest::testBeginStartsATransactionARollbackCanGoBackTo covers and calls
TransactionStatementTest::testCommitKeepsEverythingTheTransactionDid covers and calls
TransactionStatementTest::testReleaseCommitAppliesNamedTransactionLifecycleWithoutSql covers and calls
TransactionStatementTest::testRollbackAppliesRollback covers and calls
TransactionStatementTest::testRollbackToGoesBackToTheSavepointAndLeavesItDeclared covers and calls
TransactionTargetTest::testBeginIsWhatABeginStatementAsksTheTargetFor calls

Calls 2

new self line 33
class-const TransactionOperation::Begin() line 33

public static function commit(): self

100%source §

Commit.

Returns

self

Test cases 4

FakeTransactionStatementParser::parse calls
TransactionStatementTest::testCommitKeepsEverythingTheTransactionDid covers and calls
TransactionStatementTest::testReleaseCommitAppliesNamedTransactionLifecycleWithoutSql covers and calls
TransactionTargetTest::testCommitIsWhatACommitStatementAsksTheTargetFor calls

Calls 2

new self line 43
class-const TransactionOperation::Commit() line 43

public static function rollback(): self

100%source §

Rollback.

Returns

self

Test cases 7

FakeTransactionStatementParser::parse calls
SessionTest::testApplyTransactionStatementDoesWhatTheStatementSays calls
SessionTest::testTransactionsAnswersWhatATransactionStatementIsAppliedTo calls
TransactionStatementTest::testBeginStartsATransactionARollbackCanGoBackTo covers and calls
TransactionStatementTest::testCommitKeepsEverythingTheTransactionDid covers and calls
TransactionStatementTest::testRollbackAppliesRollback covers and calls
TransactionTargetTest::testRollBackIsWhatARollbackStatementAsksTheTargetFor calls

Calls 2

new self line 53
class-const TransactionOperation::Rollback() line 53

public static function savepoint(string $name): self

100%source §

Savepoint.

Parameters

$name string

Returns

self

Test cases 6

FakeTransactionStatementParser::parse calls
TransactionStatementTest::testApplyDoesWhatEachOperationSays covers and calls
TransactionStatementTest::testReleaseCommitAppliesNamedTransactionLifecycleWithoutSql covers and calls
TransactionStatementTest::testRollbackToGoesBackToTheSavepointAndLeavesItDeclared covers and calls
TransactionStatementTest::testSavepointPreservesTheNamedTransactionBoundary covers and calls
TransactionTargetTest::testSavepointCarriesTheNameTheStatementNamed calls

Calls 3

new self line 64
class-const TransactionOperation::Savepoint() line 64
static-call TransactionStatement::requiredName() line 64

public static function rollbackTo(string $name): self

100%source §

Rollback to.

Parameters

$name string

Returns

self

Test cases 4

Calls 3

new self line 75
class-const TransactionOperation::RollbackTo() line 75
static-call TransactionStatement::requiredName() line 75

public static function release(string $name): self

100%source §

Release.

Parameters

$name string

Returns

self

Test cases 4

FakeTransactionStatementParser::parse calls
TransactionStatementTest::testApplyDoesWhatEachOperationSays covers and calls
TransactionStatementTest::testReleaseCommitAppliesNamedTransactionLifecycleWithoutSql covers and calls
TransactionTargetTest::testReleaseCarriesTheNameTheStatementNamed calls

Calls 3

new self line 86
class-const TransactionOperation::Release() line 86
static-call TransactionStatement::requiredName() line 86

public function apply(TransactionTarget $transactions): void

100%source §

Applies.

Parameters

$transactions TransactionTarget

Test cases 7

Called from 1

method-call ZtdQuery\Session::applyTransactionStatement() packages/ztd-query-core/src/Session.php:218

Calls 12

class-const TransactionOperation::Begin() line 97
method-call TransactionTarget::begin() line 97
class-const TransactionOperation::Commit() line 98
method-call TransactionTarget::commit() line 98
class-const TransactionOperation::Rollback() line 99
method-call TransactionTarget::rollBack() line 99
class-const TransactionOperation::Savepoint() line 100
method-call TransactionTarget::savepoint() line 100
class-const TransactionOperation::RollbackTo() line 101
method-call TransactionTarget::rollBackTo() line 101
class-const TransactionOperation::Release() line 102
method-call TransactionTarget::release() line 102

public static function requiredName(string $name): string

67%source §

Answers a savepoint name, refusing one the statement never gave.

Parameters

$name string Name the statement carried

Returns

string The same name, once it is one

Throws

InvalidDefinitionException When the statement named no savepoint

Test cases 5

Called from 3

Calls 1

new InvalidDefinitionException line 118

Private surface 2§

Implementation details, listed for orientation only.

private TransactionOperation $operation

private string $savepointName = ''

Test cases 20§

Test cases that cover or call this symbol, from the coverage report and from the analyzed test sources.

Dedicated tests 8

TransactionStatementTest::testApplyDoesWhatEachOperationSays covers and calls
TransactionStatementTest::testBeginStartsATransactionARollbackCanGoBackTo covers and calls
TransactionStatementTest::testCommitKeepsEverythingTheTransactionDid covers and calls
TransactionStatementTest::testReleaseCommitAppliesNamedTransactionLifecycleWithoutSql covers and calls
TransactionStatementTest::testRequiredNameAnswersTheNameTheStatementCarried covers and calls
TransactionStatementTest::testRollbackAppliesRollback covers and calls
TransactionStatementTest::testRollbackToGoesBackToTheSavepointAndLeavesItDeclared covers and calls
TransactionStatementTest::testSavepointPreservesTheNamedTransactionBoundary covers and calls

Other tests reaching this symbol 12

Relations§

Method calls 1

method-call ZtdQuery\Session::applyTransactionStatement() packages/ztd-query-core/src/Session.php:218

Type declarations 4