packages/sql-semantics-mysql/resources/models/Value/JoinTableWithTableRefLeftOptOuterJoinSymTableRefOnExpr_07dea170.php

1<?php
2
3declare(strict_types=1);
4
5namespace SqlSemantics\Statement\Model\MySql\Value;
6
7/**
8 * The join_table SQL value; generated by bin/build-models.php.
9 *
10 * @visibility public
11 * @example Accept a structured SQL value
12 *     $write = static fn (\SqlSemantics\Statement\Model\MySql\Value\JoinTableWithTableRefLeftOptOuterJoinSymTableRefOnExpr_07dea170 $value): string => \SqlSemantics\Statement\Writer::render($value);
13 *     $write instanceof \Closure // => true
14 */
15final class JoinTableWithTableRefLeftOptOuterJoinSymTableRefOnExpr_07dea170 implements \SqlSemantics\Statement\Model\MySql\Role\DerivedTableListForm, \SqlSemantics\Statement\Model\MySql\Role\EscTableRefForm, \SqlSemantics\Statement\Model\MySql\Role\FromTablesForm, \SqlSemantics\Statement\Model\MySql\Role\JoinTableForm, \SqlSemantics\Statement\Model\MySql\Role\JoinTableListForm, \SqlSemantics\Statement\Model\MySql\Role\SelectDerivedForm, \SqlSemantics\Statement\Model\MySql\Role\TableRefForm, \SqlSemantics\Statement\Model\MySql\Role\TableReferenceListForm
16{
17    use \SqlSemantics\Statement\Assertion;
18
19    /**
20     * Supplies the SQL values of this form; comments are kept by the position of the symbol each precedes.
21     */
22    public function __construct(
23        public readonly \SqlSemantics\Statement\Model\MySql\Role\TableRefForm $tableRef,
24        public readonly \SqlSemantics\Statement\Model\MySql\Role\OptOuterForm $optOuter,
25        public readonly \SqlSemantics\Statement\Model\MySql\Role\TableRefForm $tableRef2,
26        public readonly \SqlSemantics\Statement\Model\MySql\Role\ExprForm $expr,
27        public readonly \SqlSemantics\Statement\Comments $comments = new \SqlSemantics\Statement\Comments(),
28    ) {
29        $this->assert(\SqlSemantics\Statement\Model\MySql\Contract\Contracts::contains($tableRef), 'The tableRef must be a generated immutable SQL value.');
30        $this->assert(\SqlSemantics\Statement\Model\MySql\Contract\Contracts::contains($optOuter), 'The optOuter must be a generated immutable SQL value.');
31        $this->assert(\SqlSemantics\Statement\Model\MySql\Contract\Contracts::contains($tableRef2), 'The tableRef2 must be a generated immutable SQL value.');
32        $this->assert(\SqlSemantics\Statement\Model\MySql\Contract\Contracts::contains($expr), 'The expr must be a generated immutable SQL value.');
33    }
34
35    /**
36     * Writes SQL entirely from this value's fields.
37     */
38    public function write(\SqlSemantics\Statement\Writer $writer): void
39    {
40        $writer->comments($this->comments, 0);
41        $this->tableRef->write($writer);
42        $writer->comments($this->comments, 1);
43        $writer->append('LEFT');
44        $writer->comments($this->comments, 2);
45        $this->optOuter->write($writer);
46        $writer->comments($this->comments, 3);
47        $writer->append('JOIN');
48        $writer->comments($this->comments, 4);
49        $this->tableRef2->write($writer);
50        $writer->comments($this->comments, 5);
51        $writer->append('ON');
52        $writer->comments($this->comments, 6);
53        $this->expr->write($writer);
54    }
55
56    /**
57     * Returns a copy with a new tableRef, preserving every other field.
58     */
59    public function withTableRef(\SqlSemantics\Statement\Model\MySql\Role\TableRefForm $tableRef): self
60    {
61        return new self($tableRef, $this->optOuter, $this->tableRef2, $this->expr, $this->comments);
62    }
63
64    /**
65     * Returns a copy with a new optOuter, preserving every other field.
66     */
67    public function withOptOuter(\SqlSemantics\Statement\Model\MySql\Role\OptOuterForm $optOuter): self
68    {
69        return new self($this->tableRef, $optOuter, $this->tableRef2, $this->expr, $this->comments);
70    }
71
72    /**
73     * Returns a copy with a new tableRef2, preserving every other field.
74     */
75    public function withTableRef2(\SqlSemantics\Statement\Model\MySql\Role\TableRefForm $tableRef2): self
76    {
77        return new self($this->tableRef, $this->optOuter, $tableRef2, $this->expr, $this->comments);
78    }
79
80    /**
81     * Returns a copy with a new expr, preserving every other field.
82     */
83    public function withExpr(\SqlSemantics\Statement\Model\MySql\Role\ExprForm $expr): self
84    {
85        return new self($this->tableRef, $this->optOuter, $this->tableRef2, $expr, $this->comments);
86    }
87
88    /**
89     * Returns a copy with a new comments, preserving every other field.
90     */
91    public function withComments(\SqlSemantics\Statement\Comments $comments): self
92    {
93        return new self($this->tableRef, $this->optOuter, $this->tableRef2, $this->expr, $comments);
94    }
95}
96