blob: 8b5ee1f7ee58819a73fc22cd5cd7da4aaf815b4f (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
|
<?php
declare(strict_types=1);
namespace Doctrine\ORM\Query;
use Doctrine\ORM\Query\Exec\AbstractSqlExecutor;
use LogicException;
use function sprintf;
/**
* Encapsulates the resulting components from a DQL query parsing process that
* can be serialized.
*
* @link http://www.doctrine-project.org
*/
class ParserResult
{
/**
* The SQL executor used for executing the SQL.
*/
private AbstractSqlExecutor|null $sqlExecutor = null;
/**
* The ResultSetMapping that describes how to map the SQL result set.
*/
private ResultSetMapping $resultSetMapping;
/**
* The mappings of DQL parameter names/positions to SQL parameter positions.
*
* @psalm-var array<string|int, list<int>>
*/
private array $parameterMappings = [];
/**
* Initializes a new instance of the <tt>ParserResult</tt> class.
* The new instance is initialized with an empty <tt>ResultSetMapping</tt>.
*/
public function __construct()
{
$this->resultSetMapping = new ResultSetMapping();
}
/**
* Gets the ResultSetMapping for the parsed query.
*
* @return ResultSetMapping The result set mapping of the parsed query
*/
public function getResultSetMapping(): ResultSetMapping
{
return $this->resultSetMapping;
}
/**
* Sets the ResultSetMapping of the parsed query.
*/
public function setResultSetMapping(ResultSetMapping $rsm): void
{
$this->resultSetMapping = $rsm;
}
/**
* Sets the SQL executor that should be used for this ParserResult.
*/
public function setSqlExecutor(AbstractSqlExecutor $executor): void
{
$this->sqlExecutor = $executor;
}
/**
* Gets the SQL executor used by this ParserResult.
*/
public function getSqlExecutor(): AbstractSqlExecutor
{
if ($this->sqlExecutor === null) {
throw new LogicException(sprintf(
'Executor not set yet. Call %s::setSqlExecutor() first.',
self::class,
));
}
return $this->sqlExecutor;
}
/**
* Adds a DQL to SQL parameter mapping. One DQL parameter name/position can map to
* several SQL parameter positions.
*/
public function addParameterMapping(string|int $dqlPosition, int $sqlPosition): void
{
$this->parameterMappings[$dqlPosition][] = $sqlPosition;
}
/**
* Gets all DQL to SQL parameter mappings.
*
* @psalm-return array<int|string, list<int>> The parameter mappings.
*/
public function getParameterMappings(): array
{
return $this->parameterMappings;
}
/**
* Gets the SQL parameter positions for a DQL parameter name/position.
*
* @param string|int $dqlPosition The name or position of the DQL parameter.
*
* @return int[] The positions of the corresponding SQL parameters.
* @psalm-return list<int>
*/
public function getSqlParameterPositions(string|int $dqlPosition): array
{
return $this->parameterMappings[$dqlPosition];
}
}
|
