Code Coverage for /var/www/collections/src/Easy/Collections/Linq/Criteria.php

	Code Coverage
	Classes and Traits			Functions and Methods				Lines
Total		0.00%	0 / 1		69.23%	9 / 13	CRAP		82.35%	28 / 34
Criteria		0.00%	0 / 1		69.23%	9 / 13	17.41		82.35%	28 / 34
create()					100.00%	1 / 1	1		100.00%	1 / 1
createExpression()					100.00%	1 / 1	2		100.00%	4 / 4
__construct(Expression $expression = null, array $orderings = null, $firstResult = null, $maxResults = null)					100.00%	1 / 1	1		100.00%	5 / 5
where(Expression $expression)					100.00%	1 / 1	1		100.00%	2 / 2
andWhere(Expression $expression)					0.00%	0 / 1	2.02		83.33%	5 / 6
orWhere(Expression $expression)					0.00%	0 / 1	2.02		83.33%	5 / 6
getWhereExpression()					100.00%	1 / 1	1		100.00%	1 / 1
getOrderings()					100.00%	1 / 1	1		100.00%	1 / 1
orderBy(array $orderings)					100.00%	1 / 1	1		100.00%	2 / 2
getFirstResult()					100.00%	1 / 1	1		100.00%	1 / 1
setFirstResult($firstResult)					0.00%	0 / 1	2		0.00%	0 / 2
getMaxResults()					100.00%	1 / 1	1		100.00%	1 / 1
setMaxResults($maxResults)					0.00%	0 / 1	2		0.00%	0 / 2

1	<?php
2
3	// Copyright (c) Lellys Informática. All rights reserved. See License.txt in the project root for license information.
4
5	namespace Easy\Collections\Linq;
6
7	use Easy\Collections\Linq\Expr\CompositeExpression;
8	use Easy\Collections\Linq\Expr\Expression;
9
10	/**
11	* Criteria for filtering Selectable collections.
12	*
13	* @author Benjamin Eberlei <kontakt@beberlei.de>
14	* @since 2.1
15	*/
16	class Criteria
17	{
18
19	/**
20	* @var string
21	*/
22	const ASC = 'ASC';
23
24	/**
25	* @var string
26	*/
27	const DESC = 'DESC';
28
29	/**
30	* @var ExpressionBuilder\|null
31	*/
32	private static $expressionBuilder;
33
34	/**
35	* @var Expression\|null
36	*/
37	private $expression;
38
39	/**
40	* @var array\|null
41	*/
42	private $orderings;
43
44	/**
45	* @var int\|null
46	*/
47	private $firstResult;
48
49	/**
50	* @var int\|null
51	*/
52	private $maxResults;
53
54	/**
55	* Creates an instance of the class.
56	*
57	* @return Criteria
58	*/
59	public static function create()
60	{
61	return new static();
62	}
63
64	/**
65	* Returns the expression builder.
66	*
67	* @return ExpressionBuilder
68	*/
69	public static function createExpression()
70	{
71	if (self::$expressionBuilder === null) {
72	self::$expressionBuilder = new ExpressionBuilder();
73	}
74	return self::$expressionBuilder;
75	}
76
77	/**
78	* Construct a new Criteria.
79	*
80	* @param Expression $expression
81	* @param array\|null $orderings
82	* @param int\|null $firstResult
83	* @param int\|null $maxResults
84	*/
85	public function __construct(Expression $expression = null, array $orderings = null, $firstResult = null, $maxResults = null)
86	{
87	$this->expression = $expression;
88	$this->orderings = $orderings;
89	$this->firstResult = $firstResult;
90	$this->maxResults = $maxResults;
91	}
92
93	/**
94	* Sets the where expression to evaluate when this Criteria is searched for.
95	*
96	* @param Expression $expression
97	*
98	* @return Criteria
99	*/
100	public function where(Expression $expression)
101	{
102	$this->expression = $expression;
103	return $this;
104	}
105
106	/**
107	* Appends the where expression to evaluate when this Criteria is searched for
108	* using an AND with previous expression.
109	*
110	* @param Expression $expression
111	*
112	* @return Criteria
113	*/
114	public function andWhere(Expression $expression)
115	{
116	if ($this->expression === null) {
117	return $this->where($expression);
118	}
119
120	$this->expression = new CompositeExpression(CompositeExpression::TYPE_AND, array(
121	$this->expression, $expression
122	));
123
124	return $this;
125	}
126
127	/**
128	* Appends the where expression to evaluate when this Criteria is searched for
129	* using an OR with previous expression.
130	*
131	* @param Expression $expression
132	*
133	* @return Criteria
134	*/
135	public function orWhere(Expression $expression)
136	{
137	if ($this->expression === null) {
138	return $this->where($expression);
139	}
140
141	$this->expression = new CompositeExpression(CompositeExpression::TYPE_OR, array(
142	$this->expression, $expression
143	));
144
145	return $this;
146	}
147
148	/**
149	* Gets the expression attached to this Criteria.
150	*
151	* @return Expression\|null
152	*/
153	public function getWhereExpression()
154	{
155	return $this->expression;
156	}
157
158	/**
159	* Gets the current orderings of this Criteria.
160	*
161	* @return array
162	*/
163	public function getOrderings()
164	{
165	return $this->orderings;
166	}
167
168	/**
169	* Sets the ordering of the result of this Criteria.
170	*
171	* Keys are field and values are the order, being either ASC or DESC.
172	*
173	* @see Criteria::ASC
174	* @see Criteria::DESC
175	*
176	* @param array $orderings
177	*
178	* @return Criteria
179	*/
180	public function orderBy(array $orderings)
181	{
182	$this->orderings = $orderings;
183	return $this;
184	}
185
186	/**
187	* Gets the current first result option of this Criteria.
188	*
189	* @return int\|null
190	*/
191	public function getFirstResult()
192	{
193	return $this->firstResult;
194	}
195
196	/**
197	* Set the number of first result that this Criteria should return.
198	*
199	* @param int\|null $firstResult The value to set.
200	*
201	* @return Criteria
202	*/
203	public function setFirstResult($firstResult)
204	{
205	$this->firstResult = $firstResult;
206	return $this;
207	}
208
209	/**
210	* Gets maxResults.
211	*
212	* @return int\|null
213	*/
214	public function getMaxResults()
215	{
216	return $this->maxResults;
217	}
218
219	/**
220	* Sets maxResults.
221	*
222	* @param int\|null $maxResults The value to set.
223	*
224	* @return Criteria
225	*/
226	public function setMaxResults($maxResults)
227	{
228	$this->maxResults = $maxResults;
229	return $this;
230	}
231
232	}