RetailCRM-Mirror/doctrine2
1
0
Fork 0
mirror of synced 2025-02-28 09:53:20 +03:00
Code Issues Projects Releases Wiki Activity

Merge pull request #35 from mridgway/DDC-1270

Browse Source 
[DDC-1270] Fixed invalid expr()->*() function calls; Added isNull and isN
This commit is contained in:
Benjamin Eberlei 2011-07-26 14:23:38 -07:00
commit c0860a6018
1 changed files with 20 additions and 14 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

34
en/reference/query-builder.rst
View File

@ -240,10 +240,10 @@ To simplify some of these efforts, we introduce what we call as
The Expr class The Expr class
^^^^^^^^^^^^^^ ^^^^^^^^^^^^^^
To workaround most of the issues that ``add()`` method may cause, To workaround some of the issues that ``add()`` method may cause,
Doctrine created a class that can be considered as a helper for Doctrine created a class that can be considered as a helper for
building queries. This class is called ``Expr``, which provides a building expressions. This class is called ``Expr``, which provides a
set of useful static methods to help building queries: set of useful methods to help build expressions:
.. code-block:: php .. code-block:: php
@ -251,13 +251,13 @@ set of useful static methods to help building queries:
// $qb instanceof QueryBuilder // $qb instanceof QueryBuilder
// example8: QueryBuilder port of: "SELECT u FROM User u WHERE u.id = ? OR u.nickname LIKE ? ORDER BY u.surname DESC" using Expr class // example8: QueryBuilder port of: "SELECT u FROM User u WHERE u.id = ? OR u.nickname LIKE ? ORDER BY u.surname DESC" using Expr class
$qb->add('select', $qb->expr()->select('u')) $qb->add('select', new Expr\Select(array('u')))
->add('from', $qb->expr()->from('User', 'u')) ->add('from', new Expr\From('User', 'u'))
->add('where', $qb->expr()->orx( ->add('where', $qb->expr()->orX(
$qb->expr()->eq('u.id', '?1'), $qb->expr()->eq('u.id', '?1'),
$qb->expr()->like('u.nickname', '?2') $qb->expr()->like('u.nickname', '?2')
)) ))
->add('orderBy', $qb->expr()->orderBy('u.surname', 'ASC')); ->add('orderBy', new Expr\OrderBy('u.name', 'ASC'));
Although it still sounds complex, the ability to programmatically Although it still sounds complex, the ability to programmatically
create conditions are the main feature of ``Expr``. Here it is a create conditions are the main feature of ``Expr``. Here it is a
@ -270,11 +270,11 @@ complete list of supported helper methods available:
{ {
/** Conditional objects **/ /** Conditional objects **/
// Example - $qb->expr()->andx($cond1 [, $condN])->add(...)->... // Example - $qb->expr()->andX($cond1 [, $condN])->add(...)->...
public function andx($x = null); // Returns Expr\Andx instance public function andX($x = null); // Returns Expr\AndX instance
// Example - $qb->expr()->orx($cond1 [, $condN])->add(...)->... // Example - $qb->expr()->orX($cond1 [, $condN])->add(...)->...
public function orx($x = null); // Returns Expr\Orx instance public function orX($x = null); // Returns Expr\OrX instance
/** Comparison objects **/ /** Comparison objects **/
@ -297,6 +297,12 @@ complete list of supported helper methods available:
// Example - $qb->expr()->gte('u.id', '?1') => u.id >= ?1 // Example - $qb->expr()->gte('u.id', '?1') => u.id >= ?1
public function gte($x, $y); // Returns Expr\Comparison instance public function gte($x, $y); // Returns Expr\Comparison instance
// Example - $qb->expr()->isNull('u.id') => u.id IS NULL
public function isNull($x); // Returns string
// Example - $qb->expr()->isNotNull('u.id') => u.id IS NOT NULL
public function isNotNull($x); // Returns string
/** Arithmetic objects **/ /** Arithmetic objects **/
@ -425,7 +431,7 @@ suggested standard way to build queries:
// example8: QueryBuilder port of: "SELECT u FROM User u WHERE u.id = ?1 OR u.nickname LIKE ?2 ORDER BY u.surname DESC" using QueryBuilder helper methods // example8: QueryBuilder port of: "SELECT u FROM User u WHERE u.id = ?1 OR u.nickname LIKE ?2 ORDER BY u.surname DESC" using QueryBuilder helper methods
$qb->select(array('u')) // string 'u' is converted to array internally $qb->select(array('u')) // string 'u' is converted to array internally
->from('User', 'u') ->from('User', 'u')
->where($qb->expr()->orx( ->where($qb->expr()->orX(
$qb->expr()->eq('u.id', '?1'), $qb->expr()->eq('u.id', '?1'),
$qb->expr()->like('u.nickname', '?2') $qb->expr()->like('u.nickname', '?2')
)) ))
@ -469,11 +475,11 @@ Here is a complete list of helper methods available in
// NOTE: ->where() overrides all previously set conditions // NOTE: ->where() overrides all previously set conditions
// //
// Example - $qb->where('u.firstName = ?1', $qb->expr()->eq('u.surname', '?2')) // Example - $qb->where('u.firstName = ?1', $qb->expr()->eq('u.surname', '?2'))
// Example - $qb->where($qb->expr()->andx($qb->expr()->eq('u.firstName', '?1'), $qb->expr()->eq('u.surname', '?2'))) // Example - $qb->where($qb->expr()->andX($qb->expr()->eq('u.firstName', '?1'), $qb->expr()->eq('u.surname', '?2')))
// Example - $qb->where('u.firstName = ?1 AND u.surname = ?2') // Example - $qb->where('u.firstName = ?1 AND u.surname = ?2')
public function where($where); public function where($where);
// Example - $qb->andWhere($qb->expr()->orx($qb->expr()->lte('u.age', 40), 'u.numChild = 0')) // Example - $qb->andWhere($qb->expr()->orX($qb->expr()->lte('u.age', 40), 'u.numChild = 0'))
public function andWhere($where); public function andWhere($where);
// Example - $qb->orWhere($qb->expr()->between('u.id', 1, 10)); // Example - $qb->orWhere($qb->expr()->between('u.id', 1, 10));