classRewriteRefusal

Session packages/ztd-query-core/src/RewriteRefusal.php:26

final class RewriteRefusal

What a session makes of a statement the rewriter would not take.

A rewriter refuses for two reasons: the statement is written in a way ZTD cannot simulate, or it names a table nothing declared. What should happen then is the caller's to say, and they say it in the configuration — raise it, say something and carry on, or let the statement through untouched — so turning a refusal into a plan is a question of configuration and not of rewriting.

Methods§

public function __construct(private ZtdConfig $config)

source §

Parameters

$config ZtdConfig What the caller said should happen

public function forUnsupported(UnsupportedSqlException $refusal, string $sql): RewritePlan

source §

Answers the plan for a statement ZTD cannot simulate.

Parameters

`$refusal`	`UnsupportedSqlException`	Why the rewriter would not take it
`$sql`	`string`	Statement as it was written

Returns

RewritePlan A plan that does nothing, where the caller allows that

Throws

DatabaseException When the caller asked to be told by being refused

Test cases 3

Called from 1

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

Calls 9

method-call ZtdConfig::resolveUnsupportedBehavior() line 47
class-const UnsupportedSqlBehavior::Exception() line 48
new DatabaseException line 49
method-call UnsupportedSqlException::getMessage() line 49
class-const UnsupportedSqlBehavior::Notice() line 51
function-call trigger_error line 52
function-call sprintf line 52
new RewritePlan line 55
class-const QueryKind::SKIPPED() line 55

public function forUnknownSchema(
    UnknownSchemaException $refusal,
    string $sql,
    string $emptyResultSelect,
): RewritePlan

source §

Answers the plan for a statement naming a table nothing declared.

Parameters

`$refusal`	`UnknownSchemaException`	Why the rewriter would not take it
`$sql`	`string`	Statement as it was written
`$emptyResultSelect`	`string`	Statement that reads nothing back, in the dialect at hand