1 <?php

     2 /*

     3  *  $Id$

     4  *

     5  * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS

     6  * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT

     7  * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR

     8  * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT

     9  * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,

    10  * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT

    11  * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,

    12  * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY

    13  * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT

    14  * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE

    15  * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

    16  *

    17  * This software consists of voluntary contributions made by many individuals

    18  * and is licensed under the LGPL. For more information, see

    19  * <http://www.doctrine-project.org>.

    20  */

    21 

    22 namespace Doctrine\ORM\Query\Expr;

    23 

    24 /**

    25  * Abstract base Expr class for building DQL parts

    26  *

    27  * @license http://www.opensource.org/licenses/lgpl-license.php LGPL

    28  * @link    www.doctrine-project.org

    29  * @since   2.0

    30  * @version $Revision$

    31  * @author  Guilherme Blanco <guilhermeblanco@hotmail.com>

    32  * @author  Jonathan Wage <jonwage@gmail.com>

    33  * @author  Roman Borschel <roman@code-factory.org>

    34  */

    35 abstract class Base

    36 {

    37     protected $_preSeparator = '(';

    38     protected $_separator = ', ';

    39     protected $_postSeparator = ')';

    40     protected $_allowedClasses = array();

    41 

    42     protected $_parts = array();

    43 

    44     public function __construct($args = array())

    45     {

    46         $this->addMultiple($args);

    47     }

    48     

    49     public function addMultiple($args = array())

    50     {

    51         foreach ((array) $args as $arg) {

    52             $this->add($arg);

    53         }

    54     }

    55 

    56     public function add($arg)

    57     {

    58         if ( $arg !== null || ($arg instanceof self && $arg->count() > 0)) {

    59             // If we decide to keep Expr\Base instances, we can use this check

    60             if ( ! is_string($arg)) {

    61                 $class = get_class($arg);

    62 

    63                 if ( ! in_array($class, $this->_allowedClasses)) {

    64                     throw new \InvalidArgumentException("Expression of type '$class' not allowed in this context.");

    65                 }

    66             }

    67 

    68             $this->_parts[] = $arg;

    69         }

    70     }

    71 

    72     public function count()

    73     {

    74         return count($this->_parts);

    75     }

    76 

    77     public function __toString()

    78     {

    79         if ($this->count() == 1) {

    80             return (string) $this->_parts[0];

    81         }

    82         

    83         return $this->_preSeparator . implode($this->_separator, $this->_parts) . $this->_postSeparator;

    84     }

    85 }