classDuplicateKeyException
final class DuplicateKeyException<TValue>
extends SimulationExceptionException thrown when a PRIMARY KEY or UNIQUE constraint is violated.
A refusal says what it is about without naming the schema it came from, so the key values it carries are spelled out here rather than imported.
Type Aliases§
KeyValues = array<string, TValue>Methods§
public function __construct(
string $sql,
string $tableName,
string $keyName,
KeyValues $keyValues = [],
)Parameters
$sql | string | The SQL statement. |
$tableName | string | The name of the table. |
$keyName | string | The name of the key constraint. |
$keyValues | KeyValues | The duplicate key values. |
Test cases 9
DuplicateKeyExceptionTest::testGetKeyNameReturnsKeyNamecoversDuplicateKeyExceptionTest::testGetKeyValuesReturnsKeyValuescoversDuplicateKeyExceptionTest::testGetMessageReturnsFormattedMessagecoversDuplicateKeyExceptionTest::testGetMessageWithEmptyKeyValuescoversDuplicateKeyExceptionTest::testGetMessageWithMultipleKeyValuescoversDuplicateKeyExceptionTest::testGetMessageWithNullKeyValuecoversDuplicateKeyExceptionTest::testGetMessageWithStringKeyValuecoversDuplicateKeyExceptionTest::testGetSqlReturnsOriginalSqlcoversDuplicateKeyExceptionTest::testGetTableNameReturnsTableNamecovers
Calls 4
- static-call DuplicateKeyException::formatKeyValue() line 52
- function-call
implodeline 54 - static-call SimulationException::__construct() line 55
- function-call
sprintfline 55
public function getSql(): stringGet the SQL statement.
Returns
stringTest cases 1
DuplicateKeyExceptionTest::testGetSqlReturnsOriginalSqlcovers and calls
public function getTableName(): stringGet the name of the table.
Returns
stringTest cases 1
DuplicateKeyExceptionTest::testGetTableNameReturnsTableNamecovers and calls
public function getKeyName(): stringGet the name of the key constraint.
Returns
stringTest cases 1
DuplicateKeyExceptionTest::testGetKeyNameReturnsKeyNamecovers and calls
public function getKeyValues(): KeyValuesGet the duplicate key values.
Returns
Test cases 1
DuplicateKeyExceptionTest::testGetKeyValuesReturnsKeyValuescovers and calls
public static function formatKeyValue(mixed $value): stringFormats a duplicate value without coercing the value stored in the exception.
Parameters
$value | mixed |
Returns
stringTest cases 9
DuplicateKeyExceptionTest::testFormatKeyValueKeepsErrorMessagesReadableForDriverValuescovers and callsDuplicateKeyExceptionTest::testGetKeyNameReturnsKeyNamecoversDuplicateKeyExceptionTest::testGetKeyValuesReturnsKeyValuescoversDuplicateKeyExceptionTest::testGetMessageReturnsFormattedMessagecoversDuplicateKeyExceptionTest::testGetMessageWithMultipleKeyValuescoversDuplicateKeyExceptionTest::testGetMessageWithNullKeyValuecoversDuplicateKeyExceptionTest::testGetMessageWithStringKeyValuecoversDuplicateKeyExceptionTest::testGetSqlReturnsOriginalSqlcoversDuplicateKeyExceptionTest::testGetTableNameReturnsTableNamecovers
Called from 1
Private surface 4§
Implementation details, listed for orientation only.
private string $sqlprivate string $tableNameprivate string $keyNameprivate KeyValues $keyValuesTest cases 16§
Test cases that cover or call this symbol, from the coverage report and from the analyzed test sources.
Dedicated tests 10
DuplicateKeyExceptionTest::testFormatKeyValueKeepsErrorMessagesReadableForDriverValuescovers and callsDuplicateKeyExceptionTest::testGetKeyNameReturnsKeyNamecovers and callsDuplicateKeyExceptionTest::testGetKeyValuesReturnsKeyValuescovers and callsDuplicateKeyExceptionTest::testGetMessageReturnsFormattedMessagecovers and callsDuplicateKeyExceptionTest::testGetMessageWithEmptyKeyValuescovers and callsDuplicateKeyExceptionTest::testGetMessageWithMultipleKeyValuescovers and callsDuplicateKeyExceptionTest::testGetMessageWithNullKeyValuecovers and callsDuplicateKeyExceptionTest::testGetMessageWithStringKeyValuecovers and callsDuplicateKeyExceptionTest::testGetSqlReturnsOriginalSqlcovers and callsDuplicateKeyExceptionTest::testGetTableNameReturnsTableNamecovers and calls
Other tests reaching this symbol 6
InsertMutationTest::testValidatePrimaryKeyDuplicateThrowsExceptioncallsInsertMutationTest::testValidateUniqueThrowsExceptioncallsUpdateMutationTest::testValidateUniqueThrowsExceptioncallsRowConstraintsTest::testAssertNoDuplicateUniqueKeyRefusesARowCollidingWithOneAlreadyTherecallsSynchronizeMutationTest::testApplyRejectsDuplicateCandidateKeyscallsShadowApplicationTestcalls
Relations§
Instantiated in 3
- new ZtdQuery\Shadow\Mutation\Row\InsertMutation::apply() packages/ztd-query-core/src/Shadow/Mutation/Row/InsertMutation.php:119
- new ZtdQuery\Shadow\Mutation\RowConstraints::assertNoDuplicateUniqueKey() packages/ztd-query-core/src/Shadow/Mutation/RowConstraints.php:90
- new ZtdQuery\Shadow\Mutation\Table\SynchronizeMutation::apply() packages/ztd-query-core/src/Shadow/Mutation/Table/SynchronizeMutation.php:59