225 lines
7.9 KiB
PHP
225 lines
7.9 KiB
PHP
<?php
|
|
/*
|
|
* $Id$
|
|
*
|
|
* THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
|
|
* "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
|
|
* LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
|
|
* A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
|
|
* OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
|
|
* SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
|
|
* LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
|
|
* DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
|
|
* THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
|
|
* (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
|
|
* OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
|
|
*
|
|
* This software consists of voluntary contributions made by many individuals
|
|
* and is licensed under the LGPL. For more information, see
|
|
* <http://www.phpdoctrine.org>.
|
|
*/
|
|
|
|
/**
|
|
* Base class for all custom user-defined repositories.
|
|
* Provides basic finder methods, common to all repositories.
|
|
*
|
|
* @package Doctrine
|
|
* @subpackage EntityRepository
|
|
* @license http://www.opensource.org/licenses/lgpl-license.php LGPL
|
|
* @link www.phpdoctrine.org
|
|
* @since 2.0
|
|
* @version $Revision$
|
|
* @author Roman Borschel <roman@code-factory.org>
|
|
* @todo package:orm
|
|
*/
|
|
class Doctrine_EntityRepository
|
|
{
|
|
protected $_entityName;
|
|
protected $_conn;
|
|
protected $_classMetadata;
|
|
|
|
public function __construct($entityName, Doctrine_ClassMetadata $classMetadata)
|
|
{
|
|
$this->_entityName = $entityName;
|
|
$this->_conn = $classMetadata->getConnection();
|
|
$this->_classMetadata = $classMetadata;
|
|
}
|
|
|
|
/**
|
|
* createQuery
|
|
* creates a new Doctrine_Query object and adds the component name
|
|
* of this table as the query 'from' part
|
|
*
|
|
* @param string Optional alias name for component aliasing.
|
|
*
|
|
* @return Doctrine_Query
|
|
*/
|
|
protected function _createQuery($alias = '')
|
|
{
|
|
if ( ! empty($alias)) {
|
|
$alias = ' ' . trim($alias);
|
|
}
|
|
return Doctrine_Query::create($this->_conn)->from($this->_entityName . $alias);
|
|
}
|
|
|
|
/**
|
|
* clear
|
|
* clears the first level cache (identityMap)
|
|
*
|
|
* @return void
|
|
* @todo what about a more descriptive name? clearIdentityMap?
|
|
*/
|
|
public function clear()
|
|
{
|
|
$this->_conn->unitOfWork->clearIdentitiesForEntity($this->_classMetadata->getRootClassName());
|
|
}
|
|
|
|
/**
|
|
* Finds an entity by its primary key.
|
|
*
|
|
* @param $id database row id
|
|
* @param int $hydrationMode Doctrine::HYDRATE_ARRAY or Doctrine::HYDRATE_RECORD
|
|
* @return mixed Array or Doctrine_Record or false if no result
|
|
* @todo Remove. Move to EntityRepository.
|
|
*/
|
|
public function find($id, $hydrationMode = null)
|
|
{
|
|
if (is_null($id)) {
|
|
return false;
|
|
}
|
|
|
|
if (is_array($id) && count($id) > 1) {
|
|
// it's a composite key. keys = field names, values = values.
|
|
$values = array_values($id);
|
|
$keys = array_keys($id);
|
|
} else {
|
|
$values = is_array($id) ? array_values($id) : array($id);
|
|
$keys = $this->_classMetadata->getIdentifier();
|
|
}
|
|
|
|
return $this->_createQuery()
|
|
->where(implode(' = ? AND ', $keys) . ' = ?')
|
|
->fetchOne($values, $hydrationMode);
|
|
}
|
|
|
|
/**
|
|
* Finds all entities of the mapper's class.
|
|
* Use with care.
|
|
*
|
|
* @param int $hydrationMode Doctrine::HYDRATE_ARRAY or Doctrine::HYDRATE_RECORD
|
|
* @return Doctrine_Collection
|
|
*/
|
|
public function findAll($hydrationMode = null)
|
|
{
|
|
return $this->_createQuery()->execute(array(), $hydrationMode);
|
|
}
|
|
|
|
/**
|
|
* findBy
|
|
*
|
|
* @param string $column
|
|
* @param string $value
|
|
* @param string $hydrationMode
|
|
* @return void
|
|
*/
|
|
protected function findBy($fieldName, $value, $hydrationMode = null)
|
|
{
|
|
return $this->_createQuery()->where($fieldName . ' = ?')->execute(array($value), $hydrationMode);
|
|
}
|
|
|
|
/**
|
|
* findOneBy
|
|
*
|
|
* @param string $column
|
|
* @param string $value
|
|
* @param string $hydrationMode
|
|
* @return void
|
|
*/
|
|
protected function findOneBy($fieldName, $value, $hydrationMode = null)
|
|
{
|
|
$results = $this->_createQuery()->where($fieldName . ' = ?')->limit(1)->execute(
|
|
array($value), $hydrationMode);
|
|
return $hydrationMode === Doctrine::HYDRATE_ARRAY ? array_shift($results) : $results->getFirst();
|
|
}
|
|
|
|
/**
|
|
* findBySql
|
|
* finds records with given SQL where clause
|
|
* returns a collection of records
|
|
*
|
|
* @param string $dql DQL after WHERE clause
|
|
* @param array $params query parameters
|
|
* @param int $hydrationMode Doctrine::FETCH_ARRAY or Doctrine::FETCH_RECORD
|
|
* @return Doctrine_Collection
|
|
*
|
|
* @todo This actually takes DQL, not SQL, but it requires column names
|
|
* instead of field names. This should be fixed to use raw SQL instead.
|
|
*/
|
|
public function findBySql($dql, array $params = array(), $hydrationMode = null)
|
|
{
|
|
return $this->_createQuery()->where($dql)->execute($params, $hydrationMode);
|
|
}
|
|
|
|
/**
|
|
* findByDql
|
|
* finds records with given DQL where clause
|
|
* returns a collection of records
|
|
*
|
|
* @param string $dql DQL after WHERE clause
|
|
* @param array $params query parameters
|
|
* @param int $hydrationMode Doctrine::FETCH_ARRAY or Doctrine::FETCH_RECORD
|
|
* @return Doctrine_Collection
|
|
*/
|
|
public function findByDql($dql, array $params = array(), $hydrationMode = null)
|
|
{
|
|
$query = new Doctrine_Query($this->_conn);
|
|
$component = $this->getComponentName();
|
|
$dql = 'FROM ' . $component . ' WHERE ' . $dql;
|
|
|
|
return $query->query($dql, $params, $hydrationMode);
|
|
}
|
|
|
|
/**
|
|
* Adds support for magic finders.
|
|
* findByColumnName, findByRelationAlias
|
|
* findById, findByContactId, etc.
|
|
*
|
|
* @return void
|
|
* @throws Doctrine_Mapper_Exception If the method called is an invalid find* method
|
|
* or no find* method at all and therefore an invalid
|
|
* method call.
|
|
*/
|
|
public function __call($method, $arguments)
|
|
{
|
|
if (substr($method, 0, 6) == 'findBy') {
|
|
$by = substr($method, 6, strlen($method));
|
|
$method = 'findBy';
|
|
} else if (substr($method, 0, 9) == 'findOneBy') {
|
|
$by = substr($method, 9, strlen($method));
|
|
$method = 'findOneBy';
|
|
} else {
|
|
throw new Doctrine_Mapper_Exception("Undefined method '$method'.");
|
|
}
|
|
|
|
if (isset($by)) {
|
|
if ( ! isset($arguments[0])) {
|
|
throw new Doctrine_Mapper_Exception('You must specify the value to findBy.');
|
|
}
|
|
|
|
$fieldName = Doctrine::tableize($by);
|
|
$hydrationMode = isset($arguments[1]) ? $arguments[1]:null;
|
|
|
|
if ($this->_classMetadata->hasField($fieldName)) {
|
|
return $this->$method($fieldName, $arguments[0], $hydrationMode);
|
|
} else if ($this->_classMetadata->hasRelation($by)) {
|
|
$relation = $this->_classMetadata->getRelation($by);
|
|
if ($relation['type'] === Doctrine_Relation::MANY) {
|
|
throw new Doctrine_Mapper_Exception('Cannot findBy many relationship.');
|
|
}
|
|
return $this->$method($relation['local'], $arguments[0], $hydrationMode);
|
|
} else {
|
|
throw new Doctrine_Mapper_Exception('Cannot find by: ' . $by . '. Invalid field or relationship alias.');
|
|
}
|
|
}
|
|
}
|
|
} |