packages/sql-semantics-mysql/resources/models/Value/QuerySpecificationWithSelectSymSelectOptionsSelectItemListOptFromClauseOptWhereClauseOptGroupClau_1e0687be.php
1<?php
2
3declare(strict_types=1);
4
5namespace SqlSemantics\Statement\Model\MySql\Value;
6
7/**
8 * The query_specification 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\QuerySpecificationWithSelectSymSelectOptionsSelectItemListOptFromClauseOptWhereClauseOptGroupClau_1e0687be $value): string => \SqlSemantics\Statement\Writer::render($value);
13 * $write instanceof \Closure // => true
14 */
15final class QuerySpecificationWithSelectSymSelectOptionsSelectItemListOptFromClauseOptWhereClauseOptGroupClau_1e0687be implements \SqlSemantics\Statement\Model\MySql\Role\QueryExpressionBodyForm, \SqlSemantics\Statement\Model\MySql\Role\QueryPrimaryForm, \SqlSemantics\Statement\Model\MySql\Role\QuerySpecificationForm, \SqlSemantics\Statement\Model\MySql\Role\SubselectForm
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\SelectOptionsForm $options,
24 public readonly \SqlSemantics\Statement\Model\MySql\Role\SelectItemListForm $projections,
25 public readonly \SqlSemantics\Statement\Model\MySql\Role\OptFromClauseForm $from,
26 public readonly \SqlSemantics\Statement\Model\MySql\Role\OptWhereClauseForm $where,
27 public readonly \SqlSemantics\Statement\Model\MySql\Role\OptGroupClauseForm $optGroupClause,
28 public readonly \SqlSemantics\Statement\Model\MySql\Role\OptHavingClauseForm $optHavingClause,
29 public readonly \SqlSemantics\Statement\Model\MySql\Role\OptWindowClauseForm $optWindowClause,
30 public readonly \SqlSemantics\Statement\Model\MySql\Role\OptQualifyClauseForm $optQualifyClause,
31 public readonly \SqlSemantics\Statement\Comments $comments = new \SqlSemantics\Statement\Comments(),
32 ) {
33 $this->assert(\SqlSemantics\Statement\Model\MySql\Contract\Contracts::contains($options), 'The options must be a generated immutable SQL value.');
34 $this->assert(\SqlSemantics\Statement\Model\MySql\Contract\Contracts::contains($projections), 'The projections must be a generated immutable SQL value.');
35 $this->assert(\SqlSemantics\Statement\Model\MySql\Contract\Contracts::contains($from), 'The from must be a generated immutable SQL value.');
36 $this->assert(\SqlSemantics\Statement\Model\MySql\Contract\Contracts::contains($where), 'The where must be a generated immutable SQL value.');
37 $this->assert(\SqlSemantics\Statement\Model\MySql\Contract\Contracts::contains($optGroupClause), 'The optGroupClause must be a generated immutable SQL value.');
38 $this->assert(\SqlSemantics\Statement\Model\MySql\Contract\Contracts::contains($optHavingClause), 'The optHavingClause must be a generated immutable SQL value.');
39 $this->assert(\SqlSemantics\Statement\Model\MySql\Contract\Contracts::contains($optWindowClause), 'The optWindowClause must be a generated immutable SQL value.');
40 $this->assert(\SqlSemantics\Statement\Model\MySql\Contract\Contracts::contains($optQualifyClause), 'The optQualifyClause must be a generated immutable SQL value.');
41 }
42
43 /**
44 * Writes SQL entirely from this value's fields.
45 */
46 public function write(\SqlSemantics\Statement\Writer $writer): void
47 {
48 $writer->comments($this->comments, 0);
49 $writer->append('SELECT');
50 $writer->comments($this->comments, 1);
51 $this->options->write($writer);
52 $writer->comments($this->comments, 2);
53 $this->projections->write($writer);
54 $writer->comments($this->comments, 3);
55 $this->from->write($writer);
56 $writer->comments($this->comments, 4);
57 $this->where->write($writer);
58 $writer->comments($this->comments, 5);
59 $this->optGroupClause->write($writer);
60 $writer->comments($this->comments, 6);
61 $this->optHavingClause->write($writer);
62 $writer->comments($this->comments, 7);
63 $this->optWindowClause->write($writer);
64 $writer->comments($this->comments, 8);
65 $this->optQualifyClause->write($writer);
66 }
67
68 /**
69 * Returns a copy with a new options, preserving every other field.
70 */
71 public function withOptions(\SqlSemantics\Statement\Model\MySql\Role\SelectOptionsForm $options): self
72 {
73 return new self($options, $this->projections, $this->from, $this->where, $this->optGroupClause, $this->optHavingClause, $this->optWindowClause, $this->optQualifyClause, $this->comments);
74 }
75
76 /**
77 * Returns a copy with a new projections, preserving every other field.
78 */
79 public function withProjections(\SqlSemantics\Statement\Model\MySql\Role\SelectItemListForm $projections): self
80 {
81 return new self($this->options, $projections, $this->from, $this->where, $this->optGroupClause, $this->optHavingClause, $this->optWindowClause, $this->optQualifyClause, $this->comments);
82 }
83
84 /**
85 * Returns a copy with a new from, preserving every other field.
86 */
87 public function withFrom(\SqlSemantics\Statement\Model\MySql\Role\OptFromClauseForm $from): self
88 {
89 return new self($this->options, $this->projections, $from, $this->where, $this->optGroupClause, $this->optHavingClause, $this->optWindowClause, $this->optQualifyClause, $this->comments);
90 }
91
92 /**
93 * Returns a copy with a new where, preserving every other field.
94 */
95 public function withWhere(\SqlSemantics\Statement\Model\MySql\Role\OptWhereClauseForm $where): self
96 {
97 return new self($this->options, $this->projections, $this->from, $where, $this->optGroupClause, $this->optHavingClause, $this->optWindowClause, $this->optQualifyClause, $this->comments);
98 }
99
100 /**
101 * Returns a copy with a new optGroupClause, preserving every other field.
102 */
103 public function withOptGroupClause(\SqlSemantics\Statement\Model\MySql\Role\OptGroupClauseForm $optGroupClause): self
104 {
105 return new self($this->options, $this->projections, $this->from, $this->where, $optGroupClause, $this->optHavingClause, $this->optWindowClause, $this->optQualifyClause, $this->comments);
106 }
107
108 /**
109 * Returns a copy with a new optHavingClause, preserving every other field.
110 */
111 public function withOptHavingClause(\SqlSemantics\Statement\Model\MySql\Role\OptHavingClauseForm $optHavingClause): self
112 {
113 return new self($this->options, $this->projections, $this->from, $this->where, $this->optGroupClause, $optHavingClause, $this->optWindowClause, $this->optQualifyClause, $this->comments);
114 }
115
116 /**
117 * Returns a copy with a new optWindowClause, preserving every other field.
118 */
119 public function withOptWindowClause(\SqlSemantics\Statement\Model\MySql\Role\OptWindowClauseForm $optWindowClause): self
120 {
121 return new self($this->options, $this->projections, $this->from, $this->where, $this->optGroupClause, $this->optHavingClause, $optWindowClause, $this->optQualifyClause, $this->comments);
122 }
123
124 /**
125 * Returns a copy with a new optQualifyClause, preserving every other field.
126 */
127 public function withOptQualifyClause(\SqlSemantics\Statement\Model\MySql\Role\OptQualifyClauseForm $optQualifyClause): self
128 {
129 return new self($this->options, $this->projections, $this->from, $this->where, $this->optGroupClause, $this->optHavingClause, $this->optWindowClause, $optQualifyClause, $this->comments);
130 }
131
132 /**
133 * Returns a copy with a new comments, preserving every other field.
134 */
135 public function withComments(\SqlSemantics\Statement\Comments $comments): self
136 {
137 return new self($this->options, $this->projections, $this->from, $this->where, $this->optGroupClause, $this->optHavingClause, $this->optWindowClause, $this->optQualifyClause, $comments);
138 }
139}
140