vendor/doctrine/orm/lib/Doctrine/ORM/Persisters/Entity/BasicEntityPersister.php line 741

Open in your IDE?
  1. <?php
  2. /*
  3.  * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
  4.  * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
  5.  * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
  6.  * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
  7.  * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
  8.  * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
  9.  * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
  10.  * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
  11.  * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
  12.  * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
  13.  * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
  14.  *
  15.  * This software consists of voluntary contributions made by many individuals
  16.  * and is licensed under the MIT license. For more information, see
  17.  * <http://www.doctrine-project.org>.
  18.  */
  20. namespace Doctrine\ORM\Persisters\Entity;
  22. use Doctrine\Common\Collections\Criteria;
  23. use Doctrine\Common\Collections\Expr\Comparison;
  24. use Doctrine\Common\Util\ClassUtils;
  25. use Doctrine\DBAL\Connection;
  26. use Doctrine\DBAL\LockMode;
  27. use Doctrine\DBAL\Types\Type;
  28. use Doctrine\ORM\EntityManagerInterface;
  29. use Doctrine\ORM\Mapping\ClassMetadata;
  30. use Doctrine\ORM\Mapping\MappingException;
  31. use Doctrine\ORM\OptimisticLockException;
  32. use Doctrine\ORM\ORMException;
  33. use Doctrine\ORM\PersistentCollection;
  34. use Doctrine\ORM\Persisters\SqlExpressionVisitor;
  35. use Doctrine\ORM\Persisters\SqlValueVisitor;
  36. use Doctrine\ORM\Query;
  37. use Doctrine\ORM\UnitOfWork;
  38. use Doctrine\ORM\Utility\IdentifierFlattener;
  39. use Doctrine\ORM\Utility\PersisterHelper;
  40. use function array_merge;
  41. use function reset;
  43. /**
  44.  * A BasicEntityPersister maps an entity to a single table in a relational database.
  45.  *
  46.  * A persister is always responsible for a single entity type.
  47.  *
  48.  * EntityPersisters are used during a UnitOfWork to apply any changes to the persistent
  49.  * state of entities onto a relational database when the UnitOfWork is committed,
  50.  * as well as for basic querying of entities and their associations (not DQL).
  51.  *
  52.  * The persisting operations that are invoked during a commit of a UnitOfWork to
  53.  * persist the persistent entity state are:
  54.  *
  55.  *   - {@link addInsert} : To schedule an entity for insertion.
  56.  *   - {@link executeInserts} : To execute all scheduled insertions.
  57.  *   - {@link update} : To update the persistent state of an entity.
  58.  *   - {@link delete} : To delete the persistent state of an entity.
  59.  *
  60.  * As can be seen from the above list, insertions are batched and executed all at once
  61.  * for increased efficiency.
  62.  *
  63.  * The querying operations invoked during a UnitOfWork, either through direct find
  64.  * requests or lazy-loading, are the following:
  65.  *
  66.  *   - {@link load} : Loads (the state of) a single, managed entity.
  67.  *   - {@link loadAll} : Loads multiple, managed entities.
  68.  *   - {@link loadOneToOneEntity} : Loads a one/many-to-one entity association (lazy-loading).
  69.  *   - {@link loadOneToManyCollection} : Loads a one-to-many entity association (lazy-loading).
  70.  *   - {@link loadManyToManyCollection} : Loads a many-to-many entity association (lazy-loading).
  71.  *
  72.  * The BasicEntityPersister implementation provides the default behavior for
  73.  * persisting and querying entities that are mapped to a single database table.
  74.  *
  75.  * Subclasses can be created to provide custom persisting and querying strategies,
  76.  * i.e. spanning multiple tables.
  77.  *
  78.  * @author Roman Borschel <roman@code-factory.org>
  79.  * @author Giorgio Sironi <piccoloprincipeazzurro@gmail.com>
  80.  * @author Benjamin Eberlei <kontakt@beberlei.de>
  81.  * @author Alexander <iam.asm89@gmail.com>
  82.  * @author Fabio B. Silva <fabio.bat.silva@gmail.com>
  83.  * @author Rob Caiger <rob@clocal.co.uk>
  84.  * @since 2.0
  85.  */
  86. class BasicEntityPersister implements EntityPersister
  87. {
  88.     /**
  89.      * @var array
  90.      */
  91.     static private $comparisonMap = [
  92.         Comparison::EQ          => '= %s',
  93.         Comparison::IS          => '= %s',
  94.         Comparison::NEQ         => '!= %s',
  95.         Comparison::GT          => '> %s',
  96.         Comparison::GTE         => '>= %s',
  97.         Comparison::LT          => '< %s',
  98.         Comparison::LTE         => '<= %s',
  99.         Comparison::IN          => 'IN (%s)',
  100.         Comparison::NIN         => 'NOT IN (%s)',
  101.         Comparison::CONTAINS    => 'LIKE %s',
  102.         Comparison::STARTS_WITH => 'LIKE %s',
  103.         Comparison::ENDS_WITH   => 'LIKE %s',
  104.     ];
  106.     /**
  107.      * Metadata object that describes the mapping of the mapped entity class.
  108.      *
  109.      * @var \Doctrine\ORM\Mapping\ClassMetadata
  110.      */
  111.     protected $class;
  113.     /**
  114.      * The underlying DBAL Connection of the used EntityManager.
  115.      *
  116.      * @var \Doctrine\DBAL\Connection $conn
  117.      */
  118.     protected $conn;
  120.     /**
  121.      * The database platform.
  122.      *
  123.      * @var \Doctrine\DBAL\Platforms\AbstractPlatform
  124.      */
  125.     protected $platform;
  127.     /**
  128.      * The EntityManager instance.
  129.      *
  130.      * @var EntityManagerInterface
  131.      */
  132.     protected $em;
  134.     /**
  135.      * Queued inserts.
  136.      *
  137.      * @var array
  138.      */
  139.     protected $queuedInserts = [];
  141.     /**
  142.      * The map of column names to DBAL mapping types of all prepared columns used
  143.      * when INSERTing or UPDATEing an entity.
  144.      *
  145.      * @var array
  146.      *
  147.      * @see prepareInsertData($entity)
  148.      * @see prepareUpdateData($entity)
  149.      */
  150.     protected $columnTypes = [];
  152.     /**
  153.      * The map of quoted column names.
  154.      *
  155.      * @var array
  156.      *
  157.      * @see prepareInsertData($entity)
  158.      * @see prepareUpdateData($entity)
  159.      */
  160.     protected $quotedColumns = [];
  162.     /**
  163.      * The INSERT SQL statement used for entities handled by this persister.
  164.      * This SQL is only generated once per request, if at all.
  165.      *
  166.      * @var string
  167.      */
  168.     private $insertSql;
  170.     /**
  171.      * The quote strategy.
  172.      *
  173.      * @var \Doctrine\ORM\Mapping\QuoteStrategy
  174.      */
  175.     protected $quoteStrategy;
  177.     /**
  178.      * The IdentifierFlattener used for manipulating identifiers
  179.      *
  180.      * @var \Doctrine\ORM\Utility\IdentifierFlattener
  181.      */
  182.     private $identifierFlattener;
  184.     /**
  185.      * @var CachedPersisterContext
  186.      */
  187.     protected $currentPersisterContext;
  189.     /**
  190.      * @var CachedPersisterContext
  191.      */
  192.     private $limitsHandlingContext;
  194.     /**
  195.      * @var CachedPersisterContext
  196.      */
  197.     private $noLimitsContext;
  199.     /**
  200.      * Initializes a new <tt>BasicEntityPersister</tt> that uses the given EntityManager
  201.      * and persists instances of the class described by the given ClassMetadata descriptor.
  202.      *
  203.      * @param EntityManagerInterface $em
  204.      * @param ClassMetadata          $class
  205.      */
  206.     public function __construct(EntityManagerInterface $em, ClassMetadata $class)
  207.     {
  208.         $this->em                    = $em;
  209.         $this->class                 = $class;
  210.         $this->conn                  = $em->getConnection();
  211.         $this->platform              = $this->conn->getDatabasePlatform();
  212.         $this->quoteStrategy         = $em->getConfiguration()->getQuoteStrategy();
  213.         $this->identifierFlattener   = new IdentifierFlattener($em->getUnitOfWork(), $em->getMetadataFactory());
  214.         $this->noLimitsContext       = $this->currentPersisterContext = new CachedPersisterContext(
  215.             $class,
  216.             new Query\ResultSetMapping(),
  217.             false
  218.         );
  219.         $this->limitsHandlingContext = new CachedPersisterContext(
  220.             $class,
  221.             new Query\ResultSetMapping(),
  222.             true
  223.         );
  224.     }
  226.     /**
  227.      * {@inheritdoc}
  228.      */
  229.     public function getClassMetadata()
  230.     {
  231.         return $this->class;
  232.     }
  234.     /**
  235.      * {@inheritdoc}
  236.      */
  237.     public function getResultSetMapping()
  238.     {
  239.         return $this->currentPersisterContext->rsm;
  240.     }
  242.     /**
  243.      * {@inheritdoc}
  244.      */
  245.     public function addInsert($entity)
  246.     {
  247.         $this->queuedInserts[spl_object_hash($entity)] = $entity;
  248.     }
  250.     /**
  251.      * {@inheritdoc}
  252.      */
  253.     public function getInserts()
  254.     {
  255.         return $this->queuedInserts;
  256.     }
  258.     /**
  259.      * {@inheritdoc}
  260.      */
  261.     public function executeInserts()
  262.     {
  263.         if ( ! $this->queuedInserts) {
  264.             return [];
  265.         }
  267.         $postInsertIds  = [];
  268.         $idGenerator    = $this->class->idGenerator;
  269.         $isPostInsertId = $idGenerator->isPostInsertGenerator();
  271.         $stmt       = $this->conn->prepare($this->getInsertSQL());
  272.         $tableName  = $this->class->getTableName();
  274.         foreach ($this->queuedInserts as $entity) {
  275.             $insertData = $this->prepareInsertData($entity);
  277.             if (isset($insertData[$tableName])) {
  278.                 $paramIndex = 1;
  280.                 foreach ($insertData[$tableName] as $column => $value) {
  281.                     $stmt->bindValue($paramIndex++, $value, $this->columnTypes[$column]);
  282.                 }
  283.             }
  285.             $stmt->execute();
  287.             if ($isPostInsertId) {
  288.                 $generatedId = $idGenerator->generate($this->em, $entity);
  289.                 $id = [
  290.                     $this->class->identifier[0] => $generatedId
  291.                 ];
  292.                 $postInsertIds[] = [
  293.                     'generatedId' => $generatedId,
  294.                     'entity' => $entity,
  295.                 ];
  296.             } else {
  297.                 $id = $this->class->getIdentifierValues($entity);
  298.             }
  300.             if ($this->class->isVersioned) {
  301.                 $this->assignDefaultVersionValue($entity, $id);
  302.             }
  303.         }
  305.         $stmt->closeCursor();
  306.         $this->queuedInserts = [];
  308.         return $postInsertIds;
  309.     }
  311.     /**
  312.      * Retrieves the default version value which was created
  313.      * by the preceding INSERT statement and assigns it back in to the
  314.      * entities version field.
  315.      *
  316.      * @param object $entity
  317.      * @param array  $id
  318.      *
  319.      * @return void
  320.      */
  321.     protected function assignDefaultVersionValue($entity, array $id)
  322.     {
  323.         $value = $this->fetchVersionValue($this->class, $id);
  325.         $this->class->setFieldValue($entity, $this->class->versionField, $value);
  326.     }
  328.     /**
  329.      * Fetches the current version value of a versioned entity.
  330.      *
  331.      * @param \Doctrine\ORM\Mapping\ClassMetadata $versionedClass
  332.      * @param array                               $id
  333.      *
  334.      * @return mixed
  335.      */
  336.     protected function fetchVersionValue($versionedClass, array $id)
  337.     {
  338.         $versionField = $versionedClass->versionField;
  339.         $fieldMapping = $versionedClass->fieldMappings[$versionField];
  340.         $tableName    = $this->quoteStrategy->getTableName($versionedClass, $this->platform);
  341.         $identifier   = $this->quoteStrategy->getIdentifierColumnNames($versionedClass, $this->platform);
  342.         $columnName   = $this->quoteStrategy->getColumnName($versionField, $versionedClass, $this->platform);
  344.         // FIXME: Order with composite keys might not be correct
  345.         $sql = 'SELECT ' . $columnName
  346.              . ' FROM '  . $tableName
  347.              . ' WHERE ' . implode(' = ? AND ', $identifier) . ' = ?';
  350.         $flatId = $this->identifierFlattener->flattenIdentifier($versionedClass, $id);
  352.         $value = $this->conn->fetchColumn(
  353.             $sql,
  354.             array_values($flatId),
  355.             0,
  356.             $this->extractIdentifierTypes($id, $versionedClass)
  357.         );
  359.         return Type::getType($fieldMapping['type'])->convertToPHPValue($value, $this->platform);
  360.     }
  362.     private function extractIdentifierTypes(array $id, ClassMetadata $versionedClass) : array
  363.     {
  364.         $types = [];
  366.         foreach ($id as $field => $value) {
  367.             $types = array_merge($types, $this->getTypes($field, $value, $versionedClass));
  368.         }
  370.         return $types;
  371.     }
  373.     /**
  374.      * {@inheritdoc}
  375.      */
  376.     public function update($entity)
  377.     {
  378.         $tableName  = $this->class->getTableName();
  379.         $updateData = $this->prepareUpdateData($entity);
  381.         if ( ! isset($updateData[$tableName]) || ! ($data = $updateData[$tableName])) {
  382.             return;
  383.         }
  385.         $isVersioned     = $this->class->isVersioned;
  386.         $quotedTableName = $this->quoteStrategy->getTableName($this->class, $this->platform);
  388.         $this->updateTable($entity, $quotedTableName, $data, $isVersioned);
  390.         if ($isVersioned) {
  391.             $id = $this->em->getUnitOfWork()->getEntityIdentifier($entity);
  393.             $this->assignDefaultVersionValue($entity, $id);
  394.         }
  395.     }
  397.     /**
  398.      * Performs an UPDATE statement for an entity on a specific table.
  399.      * The UPDATE can optionally be versioned, which requires the entity to have a version field.
  400.      *
  401.      * @param object  $entity          The entity object being updated.
  402.      * @param string  $quotedTableName The quoted name of the table to apply the UPDATE on.
  403.      * @param array   $updateData      The map of columns to update (column => value).
  404.      * @param boolean $versioned       Whether the UPDATE should be versioned.
  405.      *
  406.      * @return void
  407.      *
  408.      * @throws \Doctrine\ORM\ORMException
  409.      * @throws \Doctrine\ORM\OptimisticLockException
  410.      */
  411.     protected final function updateTable($entity, $quotedTableName, array $updateData, $versioned = false)
  412.     {
  413.         $set    = [];
  414.         $types  = [];
  415.         $params = [];
  417.         foreach ($updateData as $columnName => $value) {
  418.             $placeholder = '?';
  419.             $column      = $columnName;
  421.             switch (true) {
  422.                 case isset($this->class->fieldNames[$columnName]):
  423.                     $fieldName  = $this->class->fieldNames[$columnName];
  424.                     $column     = $this->quoteStrategy->getColumnName($fieldName, $this->class, $this->platform);
  426.                     if (isset($this->class->fieldMappings[$fieldName]['requireSQLConversion'])) {
  427.                         $type        = Type::getType($this->columnTypes[$columnName]);
  428.                         $placeholder = $type->convertToDatabaseValueSQL('?', $this->platform);
  429.                     }
  431.                     break;
  433.                 case isset($this->quotedColumns[$columnName]):
  434.                     $column = $this->quotedColumns[$columnName];
  436.                     break;
  437.             }
  439.             $params[]   = $value;
  440.             $set[]      = $column . ' = ' . $placeholder;
  441.             $types[]    = $this->columnTypes[$columnName];
  442.         }
  444.         $where      = [];
  445.         $identifier = $this->em->getUnitOfWork()->getEntityIdentifier($entity);
  447.         foreach ($this->class->identifier as $idField) {
  448.             if ( ! isset($this->class->associationMappings[$idField])) {
  449.                 $params[]   = $identifier[$idField];
  450.                 $types[]    = $this->class->fieldMappings[$idField]['type'];
  451.                 $where[]    = $this->quoteStrategy->getColumnName($idField, $this->class, $this->platform);
  453.                 continue;
  454.             }
  456.             $params[] = $identifier[$idField];
  457.             $where[]  = $this->quoteStrategy->getJoinColumnName(
  458.                 $this->class->associationMappings[$idField]['joinColumns'][0],
  459.                 $this->class,
  460.                 $this->platform
  461.             );
  463.             $targetMapping = $this->em->getClassMetadata($this->class->associationMappings[$idField]['targetEntity']);
  464.             $targetType    = PersisterHelper::getTypeOfField($targetMapping->identifier[0], $targetMapping, $this->em);
  466.             if ($targetType === []) {
  467.                 throw ORMException::unrecognizedField($targetMapping->identifier[0]);
  468.             }
  470.             $types[] = reset($targetType);
  471.         }
  473.         if ($versioned) {
  474.             $versionField       = $this->class->versionField;
  475.             $versionFieldType   = $this->class->fieldMappings[$versionField]['type'];
  476.             $versionColumn      = $this->quoteStrategy->getColumnName($versionField, $this->class, $this->platform);
  478.             $where[]    = $versionColumn;
  479.             $types[]    = $this->class->fieldMappings[$versionField]['type'];
  480.             $params[]   = $this->class->reflFields[$versionField]->getValue($entity);
  482.             switch ($versionFieldType) {
  483.                 case Type::SMALLINT:
  484.                 case Type::INTEGER:
  485.                 case Type::BIGINT:
  486.                     $set[] = $versionColumn . ' = ' . $versionColumn . ' + 1';
  487.                     break;
  489.                 case Type::DATETIME:
  490.                     $set[] = $versionColumn . ' = CURRENT_TIMESTAMP';
  491.                     break;
  492.             }
  493.         }
  495.         $sql = 'UPDATE ' . $quotedTableName
  496.              . ' SET ' . implode(', ', $set)
  497.              . ' WHERE ' . implode(' = ? AND ', $where) . ' = ?';
  499.         $result = $this->conn->executeUpdate($sql, $params, $types);
  501.         if ($versioned && ! $result) {
  502.             throw OptimisticLockException::lockFailed($entity);
  503.         }
  504.     }
  506.     /**
  507.      * @todo Add check for platform if it supports foreign keys/cascading.
  508.      *
  509.      * @param array $identifier
  510.      *
  511.      * @return void
  512.      */
  513.     protected function deleteJoinTableRecords($identifier)
  514.     {
  515.         foreach ($this->class->associationMappings as $mapping) {
  516.             if ($mapping['type'] !== ClassMetadata::MANY_TO_MANY) {
  517.                 continue;
  518.             }
  520.             // @Todo this only covers scenarios with no inheritance or of the same level. Is there something
  521.             // like self-referential relationship between different levels of an inheritance hierarchy? I hope not!
  522.             $selfReferential = ($mapping['targetEntity'] == $mapping['sourceEntity']);
  523.             $class           = $this->class;
  524.             $association     = $mapping;
  525.             $otherColumns    = [];
  526.             $otherKeys       = [];
  527.             $keys            = [];
  529.             if ( ! $mapping['isOwningSide']) {
  530.                 $class       = $this->em->getClassMetadata($mapping['targetEntity']);
  531.                 $association = $class->associationMappings[$mapping['mappedBy']];
  532.             }
  534.             $joinColumns = $mapping['isOwningSide']
  535.                 ? $association['joinTable']['joinColumns']
  536.                 : $association['joinTable']['inverseJoinColumns'];
  539.             if ($selfReferential) {
  540.                 $otherColumns = (! $mapping['isOwningSide'])
  541.                     ? $association['joinTable']['joinColumns']
  542.                     : $association['joinTable']['inverseJoinColumns'];
  543.             }
  545.             foreach ($joinColumns as $joinColumn) {
  546.                 $keys[] = $this->quoteStrategy->getJoinColumnName($joinColumn, $class, $this->platform);
  547.             }
  549.             foreach ($otherColumns as $joinColumn) {
  550.                 $otherKeys[] = $this->quoteStrategy->getJoinColumnName($joinColumn, $class, $this->platform);
  551.             }
  553.             if (isset($mapping['isOnDeleteCascade'])) {
  554.                 continue;
  555.             }
  557.             $joinTableName = $this->quoteStrategy->getJoinTableName($association, $this->class, $this->platform);
  559.             $this->conn->delete($joinTableName, array_combine($keys, $identifier));
  561.             if ($selfReferential) {
  562.                 $this->conn->delete($joinTableName, array_combine($otherKeys, $identifier));
  563.             }
  564.         }
  565.     }
  567.     /**
  568.      * {@inheritdoc}
  569.      */
  570.     public function delete($entity)
  571.     {
  572.         $self       = $this;
  573.         $class      = $this->class;
  574.         $identifier = $this->em->getUnitOfWork()->getEntityIdentifier($entity);
  575.         $tableName  = $this->quoteStrategy->getTableName($class, $this->platform);
  576.         $idColumns  = $this->quoteStrategy->getIdentifierColumnNames($class, $this->platform);
  577.         $id         = array_combine($idColumns, $identifier);
  578.         $types      = array_map(function ($identifier) use ($class, $self) {
  579.             if (isset($class->fieldMappings[$identifier])) {
  580.                 return $class->fieldMappings[$identifier]['type'];
  581.             }
  583.             $targetMapping = $self->em->getClassMetadata($class->associationMappings[$identifier]['targetEntity']);
  585.             if (isset($targetMapping->fieldMappings[$targetMapping->identifier[0]])) {
  586.                 return $targetMapping->fieldMappings[$targetMapping->identifier[0]]['type'];
  587.             }
  589.             if (isset($targetMapping->associationMappings[$targetMapping->identifier[0]])) {
  590.                 return $targetMapping->associationMappings[$targetMapping->identifier[0]]['type'];
  591.             }
  593.             throw ORMException::unrecognizedField($targetMapping->identifier[0]);
  594.         }, $class->identifier);
  596.         $this->deleteJoinTableRecords($identifier);
  598.         return (bool) $this->conn->delete($tableName, $id, $types);
  599.     }
  601.     /**
  602.      * Prepares the changeset of an entity for database insertion (UPDATE).
  603.      *
  604.      * The changeset is obtained from the currently running UnitOfWork.
  605.      *
  606.      * During this preparation the array that is passed as the second parameter is filled with
  607.      * <columnName> => <value> pairs, grouped by table name.
  608.      *
  609.      * Example:
  610.      * <code>
  611.      * array(
  612.      *    'foo_table' => array('column1' => 'value1', 'column2' => 'value2', ...),
  613.      *    'bar_table' => array('columnX' => 'valueX', 'columnY' => 'valueY', ...),
  614.      *    ...
  615.      * )
  616.      * </code>
  617.      *
  618.      * @param object $entity The entity for which to prepare the data.
  619.      *
  620.      * @return array The prepared data.
  621.      */
  622.     protected function prepareUpdateData($entity)
  623.     {
  624.         $versionField = null;
  625.         $result       = [];
  626.         $uow          = $this->em->getUnitOfWork();
  628.         if (($versioned = $this->class->isVersioned) != false) {
  629.             $versionField = $this->class->versionField;
  630.         }
  632.         foreach ($uow->getEntityChangeSet($entity) as $field => $change) {
  633.             if (isset($versionField) && $versionField == $field) {
  634.                 continue;
  635.             }
  637.             if (isset($this->class->embeddedClasses[$field])) {
  638.                 continue;
  639.             }
  641.             $newVal = $change[1];
  643.             if ( ! isset($this->class->associationMappings[$field])) {
  644.                 $fieldMapping = $this->class->fieldMappings[$field];
  645.                 $columnName   = $fieldMapping['columnName'];
  647.                 $this->columnTypes[$columnName] = $fieldMapping['type'];
  649.                 $result[$this->getOwningTable($field)][$columnName] = $newVal;
  651.                 continue;
  652.             }
  654.             $assoc = $this->class->associationMappings[$field];
  656.             // Only owning side of x-1 associations can have a FK column.
  657.             if ( ! $assoc['isOwningSide'] || ! ($assoc['type'] & ClassMetadata::TO_ONE)) {
  658.                 continue;
  659.             }
  661.             if ($newVal !== null) {
  662.                 $oid = spl_object_hash($newVal);
  664.                 if (isset($this->queuedInserts[$oid]) || $uow->isScheduledForInsert($newVal)) {
  665.                     // The associated entity $newVal is not yet persisted, so we must
  666.                     // set $newVal = null, in order to insert a null value and schedule an
  667.                     // extra update on the UnitOfWork.
  668.                     $uow->scheduleExtraUpdate($entity, [$field => [null, $newVal]]);
  670.                     $newVal = null;
  671.                 }
  672.             }
  674.             $newValId = null;
  676.             if ($newVal !== null) {
  677.                 $newValId = $uow->getEntityIdentifier($newVal);
  678.             }
  680.             $targetClass = $this->em->getClassMetadata($assoc['targetEntity']);
  681.             $owningTable = $this->getOwningTable($field);
  683.             foreach ($assoc['joinColumns'] as $joinColumn) {
  684.                 $sourceColumn = $joinColumn['name'];
  685.                 $targetColumn = $joinColumn['referencedColumnName'];
  686.                 $quotedColumn = $this->quoteStrategy->getJoinColumnName($joinColumn, $this->class, $this->platform);
  688.                 $this->quotedColumns[$sourceColumn]  = $quotedColumn;
  689.                 $this->columnTypes[$sourceColumn]    = PersisterHelper::getTypeOfColumn($targetColumn, $targetClass, $this->em);
  690.                 $result[$owningTable][$sourceColumn] = $newValId
  691.                     ? $newValId[$targetClass->getFieldForColumn($targetColumn)]
  692.                     : null;
  693.             }
  694.         }
  696.         return $result;
  697.     }
  699.     /**
  700.      * Prepares the data changeset of a managed entity for database insertion (initial INSERT).
  701.      * The changeset of the entity is obtained from the currently running UnitOfWork.
  702.      *
  703.      * The default insert data preparation is the same as for updates.
  704.      *
  705.      * @param object $entity The entity for which to prepare the data.
  706.      *
  707.      * @return array The prepared data for the tables to update.
  708.      *
  709.      * @see prepareUpdateData
  710.      */
  711.     protected function prepareInsertData($entity)
  712.     {
  713.         return $this->prepareUpdateData($entity);
  714.     }
  716.     /**
  717.      * {@inheritdoc}
  718.      */
  719.     public function getOwningTable($fieldName)
  720.     {
  721.         return $this->class->getTableName();
  722.     }
  724.     /**
  725.      * {@inheritdoc}
  726.      */
  727.     public function load(array $criteria, $entity = null, $assoc = null, array $hints = [], $lockMode = null, $limit = null, array $orderBy = null)
  728.     {
  729.         $this->switchPersisterContext(null, $limit);
  731.         $sql = $this->getSelectSQL($criteria, $assoc, $lockMode, $limit, null, $orderBy);
  732.         list($params, $types) = $this->expandParameters($criteria);
  733.         $stmt = $this->conn->executeQuery($sql, $params, $types);
  735.         if ($entity !== null) {
  736.             $hints[Query::HINT_REFRESH]         = true;
  737.             $hints[Query::HINT_REFRESH_ENTITY]  = $entity;
  738.         }
  740.         $hydrator = $this->em->newHydrator($this->currentPersisterContext->selectJoinSql ? Query::HYDRATE_OBJECT : Query::HYDRATE_SIMPLEOBJECT);
  741.         $entities = $hydrator->hydrateAll($stmt, $this->currentPersisterContext->rsm, $hints);
  743.         return $entities ? $entities[0] : null;
  744.     }
  746.     /**
  747.      * {@inheritdoc}
  748.      */
  749.     public function loadById(array $identifier, $entity = null)
  750.     {
  751.         return $this->load($identifier, $entity);
  752.     }
  754.     /**
  755.      * {@inheritdoc}
  756.      */
  757.     public function loadOneToOneEntity(array $assoc, $sourceEntity, array $identifier = [])
  758.     {
  759.         if (($foundEntity = $this->em->getUnitOfWork()->tryGetById($identifier, $assoc['targetEntity'])) != false) {
  760.             return $foundEntity;
  761.         }
  763.         $targetClass = $this->em->getClassMetadata($assoc['targetEntity']);
  765.         if ($assoc['isOwningSide']) {
  766.             $isInverseSingleValued = $assoc['inversedBy'] && ! $targetClass->isCollectionValuedAssociation($assoc['inversedBy']);
  768.             // Mark inverse side as fetched in the hints, otherwise the UoW would
  769.             // try to load it in a separate query (remember: to-one inverse sides can not be lazy).
  770.             $hints = [];
  772.             if ($isInverseSingleValued) {
  773.                 $hints['fetched']["r"][$assoc['inversedBy']] = true;
  774.             }
  776.             /* cascade read-only status
  777.             if ($this->em->getUnitOfWork()->isReadOnly($sourceEntity)) {
  778.                 $hints[Query::HINT_READ_ONLY] = true;
  779.             }
  780.             */
  782.             $targetEntity = $this->load($identifier, null, $assoc, $hints);
  784.             // Complete bidirectional association, if necessary
  785.             if ($targetEntity !== null && $isInverseSingleValued) {
  786.                 $targetClass->reflFields[$assoc['inversedBy']]->setValue($targetEntity, $sourceEntity);
  787.             }
  789.             return $targetEntity;
  790.         }
  792.         $sourceClass = $this->em->getClassMetadata($assoc['sourceEntity']);
  793.         $owningAssoc = $targetClass->getAssociationMapping($assoc['mappedBy']);
  795.         $computedIdentifier = [];
  797.         // TRICKY: since the association is specular source and target are flipped
  798.         foreach ($owningAssoc['targetToSourceKeyColumns'] as $sourceKeyColumn => $targetKeyColumn) {
  799.             if ( ! isset($sourceClass->fieldNames[$sourceKeyColumn])) {
  800.                 throw MappingException::joinColumnMustPointToMappedField(
  801.                     $sourceClass->name, $sourceKeyColumn
  802.                 );
  803.             }
  805.             $computedIdentifier[$targetClass->getFieldForColumn($targetKeyColumn)] =
  806.                 $sourceClass->reflFields[$sourceClass->fieldNames[$sourceKeyColumn]]->getValue($sourceEntity);
  807.         }
  809.         $targetEntity = $this->load($computedIdentifier, null, $assoc);
  811.         if ($targetEntity !== null) {
  812.             $targetClass->setFieldValue($targetEntity, $assoc['mappedBy'], $sourceEntity);
  813.         }
  815.         return $targetEntity;
  816.     }
  818.     /**
  819.      * {@inheritdoc}
  820.      */
  821.     public function refresh(array $id, $entity, $lockMode = null)
  822.     {
  823.         $sql = $this->getSelectSQL($id, null, $lockMode);
  824.         list($params, $types) = $this->expandParameters($id);
  825.         $stmt = $this->conn->executeQuery($sql, $params, $types);
  827.         $hydrator = $this->em->newHydrator(Query::HYDRATE_OBJECT);
  828.         $hydrator->hydrateAll($stmt, $this->currentPersisterContext->rsm, [Query::HINT_REFRESH => true]);
  829.     }
  831.     /**
  832.      * {@inheritDoc}
  833.      */
  834.     public function count($criteria = [])
  835.     {
  836.         $sql = $this->getCountSQL($criteria);
  838.         list($params, $types) = ($criteria instanceof Criteria)
  839.             ? $this->expandCriteriaParameters($criteria)
  840.             : $this->expandParameters($criteria);
  842.         return (int) $this->conn->executeQuery($sql, $params, $types)->fetchColumn();
  843.     }
  845.     /**
  846.      * {@inheritdoc}
  847.      */
  848.     public function loadCriteria(Criteria $criteria)
  849.     {
  850.         $orderBy = $criteria->getOrderings();
  851.         $limit   = $criteria->getMaxResults();
  852.         $offset  = $criteria->getFirstResult();
  853.         $query   = $this->getSelectSQL($criteria, null, null, $limit, $offset, $orderBy);
  855.         list($params, $types) = $this->expandCriteriaParameters($criteria);
  857.         $stmt       = $this->conn->executeQuery($query, $params, $types);
  858.         $hydrator   = $this->em->newHydrator(($this->currentPersisterContext->selectJoinSql) ? Query::HYDRATE_OBJECT : Query::HYDRATE_SIMPLEOBJECT);
  860.         return $hydrator->hydrateAll($stmt, $this->currentPersisterContext->rsm, [UnitOfWork::HINT_DEFEREAGERLOAD => true]
  861.         );
  862.     }
  864.     /**
  865.      * {@inheritdoc}
  866.      */
  867.     public function expandCriteriaParameters(Criteria $criteria)
  868.     {
  869.         $expression = $criteria->getWhereExpression();
  870.         $sqlParams  = [];
  871.         $sqlTypes   = [];
  873.         if ($expression === null) {
  874.             return [$sqlParams, $sqlTypes];
  875.         }
  877.         $valueVisitor = new SqlValueVisitor();
  879.         $valueVisitor->dispatch($expression);
  881.         list($params, $types) = $valueVisitor->getParamsAndTypes();
  883.         foreach ($params as $param) {
  884.             $sqlParams = array_merge($sqlParams, $this->getValues($param));
  885.         }
  887.         foreach ($types as $type) {
  888.             list ($field, $value) = $type;
  889.             $sqlTypes = array_merge($sqlTypes, $this->getTypes($field, $value, $this->class));
  890.         }
  892.         return [$sqlParams, $sqlTypes];
  893.     }
  895.     /**
  896.      * {@inheritdoc}
  897.      */
  898.     public function loadAll(array $criteria = [], array $orderBy = null, $limit = null, $offset = null)
  899.     {
  900.         $this->switchPersisterContext($offset, $limit);
  902.         $sql = $this->getSelectSQL($criteria, null, null, $limit, $offset, $orderBy);
  903.         list($params, $types) = $this->expandParameters($criteria);
  904.         $stmt = $this->conn->executeQuery($sql, $params, $types);
  906.         $hydrator = $this->em->newHydrator(($this->currentPersisterContext->selectJoinSql) ? Query::HYDRATE_OBJECT : Query::HYDRATE_SIMPLEOBJECT);
  908.         return $hydrator->hydrateAll($stmt, $this->currentPersisterContext->rsm, [UnitOfWork::HINT_DEFEREAGERLOAD => true]
  909.         );
  910.     }
  912.     /**
  913.      * {@inheritdoc}
  914.      */
  915.     public function getManyToManyCollection(array $assoc, $sourceEntity, $offset = null, $limit = null)
  916.     {
  917.         $this->switchPersisterContext($offset, $limit);
  919.         $stmt = $this->getManyToManyStatement($assoc, $sourceEntity, $offset, $limit);
  921.         return $this->loadArrayFromStatement($assoc, $stmt);
  922.     }
  924.     /**
  925.      * Loads an array of entities from a given DBAL statement.
  926.      *
  927.      * @param array                    $assoc
  928.      * @param \Doctrine\DBAL\Statement $stmt
  929.      *
  930.      * @return array
  931.      */
  932.     private function loadArrayFromStatement($assoc, $stmt)
  933.     {
  934.         $rsm    = $this->currentPersisterContext->rsm;
  935.         $hints  = [UnitOfWork::HINT_DEFEREAGERLOAD => true];
  937.         if (isset($assoc['indexBy'])) {
  938.             $rsm = clone ($this->currentPersisterContext->rsm); // this is necessary because the "default rsm" should be changed.
  939.             $rsm->addIndexBy('r', $assoc['indexBy']);
  940.         }
  942.         return $this->em->newHydrator(Query::HYDRATE_OBJECT)->hydrateAll($stmt, $rsm, $hints);
  943.     }
  945.     /**
  946.      * Hydrates a collection from a given DBAL statement.
  947.      *
  948.      * @param array                    $assoc
  949.      * @param \Doctrine\DBAL\Statement $stmt
  950.      * @param PersistentCollection     $coll
  951.      *
  952.      * @return array
  953.      */
  954.     private function loadCollectionFromStatement($assoc, $stmt, $coll)
  955.     {
  956.         $rsm   = $this->currentPersisterContext->rsm;
  957.         $hints = [
  958.             UnitOfWork::HINT_DEFEREAGERLOAD => true,
  959.             'collection' => $coll
  960.         ];
  962.         if (isset($assoc['indexBy'])) {
  963.             $rsm = clone ($this->currentPersisterContext->rsm); // this is necessary because the "default rsm" should be changed.
  964.             $rsm->addIndexBy('r', $assoc['indexBy']);
  965.         }
  967.         return $this->em->newHydrator(Query::HYDRATE_OBJECT)->hydrateAll($stmt, $rsm, $hints);
  968.     }
  970.     /**
  971.      * {@inheritdoc}
  972.      */
  973.     public function loadManyToManyCollection(array $assoc, $sourceEntity, PersistentCollection $coll)
  974.     {
  975.         $stmt = $this->getManyToManyStatement($assoc, $sourceEntity);
  977.         return $this->loadCollectionFromStatement($assoc, $stmt, $coll);
  978.     }
  980.     /**
  981.      * @param array    $assoc
  982.      * @param object   $sourceEntity
  983.      * @param int|null $offset
  984.      * @param int|null $limit
  985.      *
  986.      * @return \Doctrine\DBAL\Driver\Statement
  987.      *
  988.      * @throws \Doctrine\ORM\Mapping\MappingException
  989.      */
  990.     private function getManyToManyStatement(array $assoc, $sourceEntity, $offset = null, $limit = null)
  991.     {
  992.         $this->switchPersisterContext($offset, $limit);
  994.         $sourceClass    = $this->em->getClassMetadata($assoc['sourceEntity']);
  995.         $class          = $sourceClass;
  996.         $association    = $assoc;
  997.         $criteria       = [];
  998.         $parameters     = [];
  1000.         if ( ! $assoc['isOwningSide']) {
  1001.             $class       = $this->em->getClassMetadata($assoc['targetEntity']);
  1002.             $association = $class->associationMappings[$assoc['mappedBy']];
  1003.         }
  1005.         $joinColumns = $assoc['isOwningSide']
  1006.             ? $association['joinTable']['joinColumns']
  1007.             : $association['joinTable']['inverseJoinColumns'];
  1009.         $quotedJoinTable = $this->quoteStrategy->getJoinTableName($association, $class, $this->platform);
  1011.         foreach ($joinColumns as $joinColumn) {
  1012.             $sourceKeyColumn    = $joinColumn['referencedColumnName'];
  1013.             $quotedKeyColumn    = $this->quoteStrategy->getJoinColumnName($joinColumn, $class, $this->platform);
  1015.             switch (true) {
  1016.                 case $sourceClass->containsForeignIdentifier:
  1017.                     $field = $sourceClass->getFieldForColumn($sourceKeyColumn);
  1018.                     $value = $sourceClass->reflFields[$field]->getValue($sourceEntity);
  1020.                     if (isset($sourceClass->associationMappings[$field])) {
  1021.                         $value = $this->em->getUnitOfWork()->getEntityIdentifier($value);
  1022.                         $value = $value[$this->em->getClassMetadata($sourceClass->associationMappings[$field]['targetEntity'])->identifier[0]];
  1023.                     }
  1025.                     break;
  1027.                 case isset($sourceClass->fieldNames[$sourceKeyColumn]):
  1028.                     $field = $sourceClass->fieldNames[$sourceKeyColumn];
  1029.                     $value = $sourceClass->reflFields[$field]->getValue($sourceEntity);
  1031.                     break;
  1033.                 default:
  1034.                     throw MappingException::joinColumnMustPointToMappedField(
  1035.                         $sourceClass->name, $sourceKeyColumn
  1036.                     );
  1037.             }
  1039.             $criteria[$quotedJoinTable . '.' . $quotedKeyColumn] = $value;
  1040.             $parameters[] = [
  1041.                 'value' => $value,
  1042.                 'field' => $field,
  1043.                 'class' => $sourceClass,
  1044.             ];
  1045.         }
  1047.         $sql = $this->getSelectSQL($criteria, $assoc, null, $limit, $offset);
  1048.         list($params, $types) = $this->expandToManyParameters($parameters);
  1050.         return $this->conn->executeQuery($sql, $params, $types);
  1051.     }
  1053.     /**
  1054.      * {@inheritdoc}
  1055.      */
  1056.     public function getSelectSQL($criteria, $assoc = null, $lockMode = null, $limit = null, $offset = null, array $orderBy = null)
  1057.     {
  1058.         $this->switchPersisterContext($offset, $limit);
  1060.         $lockSql    = '';
  1061.         $joinSql    = '';
  1062.         $orderBySql = '';
  1064.         if ($assoc != null && $assoc['type'] == ClassMetadata::MANY_TO_MANY) {
  1065.             $joinSql = $this->getSelectManyToManyJoinSQL($assoc);
  1066.         }
  1068.         if (isset($assoc['orderBy'])) {
  1069.             $orderBy = $assoc['orderBy'];
  1070.         }
  1072.         if ($orderBy) {
  1073.             $orderBySql = $this->getOrderBySQL($orderBy, $this->getSQLTableAlias($this->class->name));
  1074.         }
  1076.         $conditionSql = ($criteria instanceof Criteria)
  1077.             ? $this->getSelectConditionCriteriaSQL($criteria)
  1078.             : $this->getSelectConditionSQL($criteria, $assoc);
  1080.         switch ($lockMode) {
  1081.             case LockMode::PESSIMISTIC_READ:
  1082.                 $lockSql = ' ' . $this->platform->getReadLockSQL();
  1083.                 break;
  1085.             case LockMode::PESSIMISTIC_WRITE:
  1086.                 $lockSql = ' ' . $this->platform->getWriteLockSQL();
  1087.                 break;
  1088.         }
  1090.         $columnList = $this->getSelectColumnsSQL();
  1091.         $tableAlias = $this->getSQLTableAlias($this->class->name);
  1092.         $filterSql  = $this->generateFilterConditionSQL($this->class, $tableAlias);
  1093.         $tableName  = $this->quoteStrategy->getTableName($this->class, $this->platform);
  1095.         if ('' !== $filterSql) {
  1096.             $conditionSql = $conditionSql
  1097.                 ? $conditionSql . ' AND ' . $filterSql
  1098.                 : $filterSql;
  1099.         }
  1101.         $select = 'SELECT ' . $columnList;
  1102.         $from   = ' FROM ' . $tableName . ' '. $tableAlias;
  1103.         $join   = $this->currentPersisterContext->selectJoinSql . $joinSql;
  1104.         $where  = ($conditionSql ? ' WHERE ' . $conditionSql : '');
  1105.         $lock   = $this->platform->appendLockHint($from, $lockMode);
  1106.         $query  = $select
  1107.             . $lock
  1108.             . $join
  1109.             . $where
  1110.             . $orderBySql;
  1112.         return $this->platform->modifyLimitQuery($query, $limit, $offset) . $lockSql;
  1113.     }
  1115.     /**
  1116.      * {@inheritDoc}
  1117.      */
  1118.     public function getCountSQL($criteria = [])
  1119.     {
  1120.         $tableName  = $this->quoteStrategy->getTableName($this->class, $this->platform);
  1121.         $tableAlias = $this->getSQLTableAlias($this->class->name);
  1123.         $conditionSql = ($criteria instanceof Criteria)
  1124.             ? $this->getSelectConditionCriteriaSQL($criteria)
  1125.             : $this->getSelectConditionSQL($criteria);
  1127.         $filterSql = $this->generateFilterConditionSQL($this->class, $tableAlias);
  1129.         if ('' !== $filterSql) {
  1130.             $conditionSql = $conditionSql
  1131.                 ? $conditionSql . ' AND ' . $filterSql
  1132.                 : $filterSql;
  1133.         }
  1135.         $sql = 'SELECT COUNT(*) '
  1136.             . 'FROM ' . $tableName . ' ' . $tableAlias
  1137.             . (empty($conditionSql) ? '' : ' WHERE ' . $conditionSql);
  1139.         return $sql;
  1140.     }
  1142.     /**
  1143.      * Gets the ORDER BY SQL snippet for ordered collections.
  1144.      *
  1145.      * @param array  $orderBy
  1146.      * @param string $baseTableAlias
  1147.      *
  1148.      * @return string
  1149.      *
  1150.      * @throws \Doctrine\ORM\ORMException
  1151.      */
  1152.     protected final function getOrderBySQL(array $orderBy, $baseTableAlias)
  1153.     {
  1154.         $orderByList = [];
  1156.         foreach ($orderBy as $fieldName => $orientation) {
  1158.             $orientation = strtoupper(trim($orientation));
  1160.             if ($orientation != 'ASC' && $orientation != 'DESC') {
  1161.                 throw ORMException::invalidOrientation($this->class->name, $fieldName);
  1162.             }
  1164.             if (isset($this->class->fieldMappings[$fieldName])) {
  1165.                 $tableAlias = isset($this->class->fieldMappings[$fieldName]['inherited'])
  1166.                     ? $this->getSQLTableAlias($this->class->fieldMappings[$fieldName]['inherited'])
  1167.                     : $baseTableAlias;
  1169.                 $columnName    = $this->quoteStrategy->getColumnName($fieldName, $this->class, $this->platform);
  1170.                 $orderByList[] = $tableAlias . '.' . $columnName . ' ' . $orientation;
  1172.                 continue;
  1173.             }
  1175.             if (isset($this->class->associationMappings[$fieldName])) {
  1177.                 if ( ! $this->class->associationMappings[$fieldName]['isOwningSide']) {
  1178.                     throw ORMException::invalidFindByInverseAssociation($this->class->name, $fieldName);
  1179.                 }
  1181.                 $tableAlias = isset($this->class->associationMappings[$fieldName]['inherited'])
  1182.                     ? $this->getSQLTableAlias($this->class->associationMappings[$fieldName]['inherited'])
  1183.                     : $baseTableAlias;
  1185.                 foreach ($this->class->associationMappings[$fieldName]['joinColumns'] as $joinColumn) {
  1186.                     $columnName    = $this->quoteStrategy->getJoinColumnName($joinColumn, $this->class, $this->platform);
  1187.                     $orderByList[] = $tableAlias . '.' . $columnName . ' ' . $orientation;
  1188.                 }
  1190.                 continue;
  1191.             }
  1193.             throw ORMException::unrecognizedField($fieldName);
  1194.         }
  1196.         return ' ORDER BY ' . implode(', ', $orderByList);
  1197.     }
  1199.     /**
  1200.      * Gets the SQL fragment with the list of columns to select when querying for
  1201.      * an entity in this persister.
  1202.      *
  1203.      * Subclasses should override this method to alter or change the select column
  1204.      * list SQL fragment. Note that in the implementation of BasicEntityPersister
  1205.      * the resulting SQL fragment is generated only once and cached in {@link selectColumnListSql}.
  1206.      * Subclasses may or may not do the same.
  1207.      *
  1208.      * @return string The SQL fragment.
  1209.      */
  1210.     protected function getSelectColumnsSQL()
  1211.     {
  1212.         if ($this->currentPersisterContext->selectColumnListSql !== null) {
  1213.             return $this->currentPersisterContext->selectColumnListSql;
  1214.         }
  1216.         $columnList = [];
  1217.         $this->currentPersisterContext->rsm->addEntityResult($this->class->name, 'r'); // r for root
  1219.         // Add regular columns to select list
  1220.         foreach ($this->class->fieldNames as $field) {
  1221.             $columnList[] = $this->getSelectColumnSQL($field, $this->class);
  1222.         }
  1224.         $this->currentPersisterContext->selectJoinSql    = '';
  1225.         $eagerAliasCounter      = 0;
  1227.         foreach ($this->class->associationMappings as $assocField => $assoc) {
  1228.             $assocColumnSQL = $this->getSelectColumnAssociationSQL($assocField, $assoc, $this->class);
  1230.             if ($assocColumnSQL) {
  1231.                 $columnList[] = $assocColumnSQL;
  1232.             }
  1234.             $isAssocToOneInverseSide = $assoc['type'] & ClassMetadata::TO_ONE && ! $assoc['isOwningSide'];
  1235.             $isAssocFromOneEager     = $assoc['type'] !== ClassMetadata::MANY_TO_MANY && $assoc['fetch'] === ClassMetadata::FETCH_EAGER;
  1237.             if ( ! ($isAssocFromOneEager || $isAssocToOneInverseSide)) {
  1238.                 continue;
  1239.             }
  1241.             if ((($assoc['type'] & ClassMetadata::TO_MANY) > 0) && $this->currentPersisterContext->handlesLimits) {
  1242.                 continue;
  1243.             }
  1245.             $eagerEntity = $this->em->getClassMetadata($assoc['targetEntity']);
  1247.             if ($eagerEntity->inheritanceType != ClassMetadata::INHERITANCE_TYPE_NONE) {
  1248.                 continue; // now this is why you shouldn't use inheritance
  1249.             }
  1251.             $assocAlias = 'e' . ($eagerAliasCounter++);
  1252.             $this->currentPersisterContext->rsm->addJoinedEntityResult($assoc['targetEntity'], $assocAlias, 'r', $assocField);
  1254.             foreach ($eagerEntity->fieldNames as $field) {
  1255.                 $columnList[] = $this->getSelectColumnSQL($field, $eagerEntity, $assocAlias);
  1256.             }
  1258.             foreach ($eagerEntity->associationMappings as $eagerAssocField => $eagerAssoc) {
  1259.                 $eagerAssocColumnSQL = $this->getSelectColumnAssociationSQL(
  1260.                     $eagerAssocField, $eagerAssoc, $eagerEntity, $assocAlias
  1261.                 );
  1263.                 if ($eagerAssocColumnSQL) {
  1264.                     $columnList[] = $eagerAssocColumnSQL;
  1265.                 }
  1266.             }
  1268.             $association    = $assoc;
  1269.             $joinCondition  = [];
  1271.             if (isset($assoc['indexBy'])) {
  1272.                 $this->currentPersisterContext->rsm->addIndexBy($assocAlias, $assoc['indexBy']);
  1273.             }
  1275.             if ( ! $assoc['isOwningSide']) {
  1276.                 $eagerEntity = $this->em->getClassMetadata($assoc['targetEntity']);
  1277.                 $association = $eagerEntity->getAssociationMapping($assoc['mappedBy']);
  1278.             }
  1280.             $joinTableAlias = $this->getSQLTableAlias($eagerEntity->name, $assocAlias);
  1281.             $joinTableName  = $this->quoteStrategy->getTableName($eagerEntity, $this->platform);
  1283.             if ($assoc['isOwningSide']) {
  1284.                 $tableAlias           = $this->getSQLTableAlias($association['targetEntity'], $assocAlias);
  1285.                 $this->currentPersisterContext->selectJoinSql .= ' ' . $this->getJoinSQLForJoinColumns($association['joinColumns']);
  1287.                 foreach ($association['joinColumns'] as $joinColumn) {
  1288.                     $sourceCol       = $this->quoteStrategy->getJoinColumnName($joinColumn, $this->class, $this->platform);
  1289.                     $targetCol       = $this->quoteStrategy->getReferencedJoinColumnName($joinColumn, $this->class, $this->platform);
  1290.                     $joinCondition[] = $this->getSQLTableAlias($association['sourceEntity'])
  1291.                                         . '.' . $sourceCol . ' = ' . $tableAlias . '.' . $targetCol;
  1292.                 }
  1294.                 // Add filter SQL
  1295.                 if ($filterSql = $this->generateFilterConditionSQL($eagerEntity, $tableAlias)) {
  1296.                     $joinCondition[] = $filterSql;
  1297.                 }
  1299.             } else {
  1301.                 $this->currentPersisterContext->selectJoinSql .= ' LEFT JOIN';
  1303.                 foreach ($association['joinColumns'] as $joinColumn) {
  1304.                     $sourceCol       = $this->quoteStrategy->getJoinColumnName($joinColumn, $this->class, $this->platform);
  1305.                     $targetCol       = $this->quoteStrategy->getReferencedJoinColumnName($joinColumn, $this->class, $this->platform);
  1307.                     $joinCondition[] = $this->getSQLTableAlias($association['sourceEntity'], $assocAlias) . '.' . $sourceCol . ' = '
  1308.                         . $this->getSQLTableAlias($association['targetEntity']) . '.' . $targetCol;
  1309.                 }
  1310.             }
  1312.             $this->currentPersisterContext->selectJoinSql .= ' ' . $joinTableName . ' ' . $joinTableAlias . ' ON ';
  1313.             $this->currentPersisterContext->selectJoinSql .= implode(' AND ', $joinCondition);
  1314.         }
  1316.         $this->currentPersisterContext->selectColumnListSql = implode(', ', $columnList);
  1318.         return $this->currentPersisterContext->selectColumnListSql;
  1319.     }
  1321.     /**
  1322.      * Gets the SQL join fragment used when selecting entities from an association.
  1323.      *
  1324.      * @param string        $field
  1325.      * @param array         $assoc
  1326.      * @param ClassMetadata $class
  1327.      * @param string        $alias
  1328.      *
  1329.      * @return string
  1330.      */
  1331.     protected function getSelectColumnAssociationSQL($field, $assoc, ClassMetadata $class, $alias = 'r')
  1332.     {
  1333.         if ( ! ($assoc['isOwningSide'] && $assoc['type'] & ClassMetadata::TO_ONE) ) {
  1334.             return '';
  1335.         }
  1337.         $columnList    = [];
  1338.         $targetClass   = $this->em->getClassMetadata($assoc['targetEntity']);
  1339.         $isIdentifier  = isset($assoc['id']) && $assoc['id'] === true;
  1340.         $sqlTableAlias = $this->getSQLTableAlias($class->name, ($alias == 'r' ? '' : $alias));
  1342.         foreach ($assoc['joinColumns'] as $joinColumn) {
  1343.             $quotedColumn     = $this->quoteStrategy->getJoinColumnName($joinColumn, $this->class, $this->platform);
  1344.             $resultColumnName = $this->getSQLColumnAlias($joinColumn['name']);
  1345.             $type             = PersisterHelper::getTypeOfColumn($joinColumn['referencedColumnName'], $targetClass, $this->em);
  1347.             $this->currentPersisterContext->rsm->addMetaResult($alias, $resultColumnName, $joinColumn['name'], $isIdentifier, $type);
  1349.             $columnList[] = sprintf('%s.%s AS %s', $sqlTableAlias, $quotedColumn, $resultColumnName);
  1350.         }
  1352.         return implode(', ', $columnList);
  1353.     }
  1355.     /**
  1356.      * Gets the SQL join fragment used when selecting entities from a
  1357.      * many-to-many association.
  1358.      *
  1359.      * @param array $manyToMany
  1360.      *
  1361.      * @return string
  1362.      */
  1363.     protected function getSelectManyToManyJoinSQL(array $manyToMany)
  1364.     {
  1365.         $conditions         = [];
  1366.         $association        = $manyToMany;
  1367.         $sourceTableAlias   = $this->getSQLTableAlias($this->class->name);
  1369.         if ( ! $manyToMany['isOwningSide']) {
  1370.             $targetEntity   = $this->em->getClassMetadata($manyToMany['targetEntity']);
  1371.             $association    = $targetEntity->associationMappings[$manyToMany['mappedBy']];
  1372.         }
  1374.         $joinTableName  = $this->quoteStrategy->getJoinTableName($association, $this->class, $this->platform);
  1375.         $joinColumns    = ($manyToMany['isOwningSide'])
  1376.             ? $association['joinTable']['inverseJoinColumns']
  1377.             : $association['joinTable']['joinColumns'];
  1379.         foreach ($joinColumns as $joinColumn) {
  1380.             $quotedSourceColumn = $this->quoteStrategy->getJoinColumnName($joinColumn, $this->class, $this->platform);
  1381.             $quotedTargetColumn = $this->quoteStrategy->getReferencedJoinColumnName($joinColumn, $this->class, $this->platform);
  1382.             $conditions[]       = $sourceTableAlias . '.' . $quotedTargetColumn . ' = ' . $joinTableName . '.' . $quotedSourceColumn;
  1383.         }
  1385.         return ' INNER JOIN ' . $joinTableName . ' ON ' . implode(' AND ', $conditions);
  1386.     }
  1388.     /**
  1389.      * {@inheritdoc}
  1390.      */
  1391.     public function getInsertSQL()
  1392.     {
  1393.         if ($this->insertSql !== null) {
  1394.             return $this->insertSql;
  1395.         }
  1397.         $columns   = $this->getInsertColumnList();
  1398.         $tableName = $this->quoteStrategy->getTableName($this->class, $this->platform);
  1400.         if (empty($columns)) {
  1401.             $identityColumn  = $this->quoteStrategy->getColumnName($this->class->identifier[0], $this->class, $this->platform);
  1402.             $this->insertSql = $this->platform->getEmptyIdentityInsertSQL($tableName, $identityColumn);
  1404.             return $this->insertSql;
  1405.         }
  1407.         $values  = [];
  1408.         $columns = array_unique($columns);
  1410.         foreach ($columns as $column) {
  1411.             $placeholder = '?';
  1413.             if (isset($this->class->fieldNames[$column])
  1414.                 && isset($this->columnTypes[$this->class->fieldNames[$column]])
  1415.                 && isset($this->class->fieldMappings[$this->class->fieldNames[$column]]['requireSQLConversion'])) {
  1416.                 $type        = Type::getType($this->columnTypes[$this->class->fieldNames[$column]]);
  1417.                 $placeholder = $type->convertToDatabaseValueSQL('?', $this->platform);
  1418.             }
  1420.             $values[] = $placeholder;
  1421.         }
  1423.         $columns = implode(', ', $columns);
  1424.         $values  = implode(', ', $values);
  1426.         $this->insertSql = sprintf('INSERT INTO %s (%s) VALUES (%s)', $tableName, $columns, $values);
  1428.         return $this->insertSql;
  1429.     }
  1431.     /**
  1432.      * Gets the list of columns to put in the INSERT SQL statement.
  1433.      *
  1434.      * Subclasses should override this method to alter or change the list of
  1435.      * columns placed in the INSERT statements used by the persister.
  1436.      *
  1437.      * @return array The list of columns.
  1438.      */
  1439.     protected function getInsertColumnList()
  1440.     {
  1441.         $columns = [];
  1443.         foreach ($this->class->reflFields as $name => $field) {
  1444.             if ($this->class->isVersioned && $this->class->versionField == $name) {
  1445.                 continue;
  1446.             }
  1448.             if (isset($this->class->embeddedClasses[$name])) {
  1449.                 continue;
  1450.             }
  1452.             if (isset($this->class->associationMappings[$name])) {
  1453.                 $assoc = $this->class->associationMappings[$name];
  1455.                 if ($assoc['isOwningSide'] && $assoc['type'] & ClassMetadata::TO_ONE) {
  1456.                     foreach ($assoc['joinColumns'] as $joinColumn) {
  1457.                         $columns[] = $this->quoteStrategy->getJoinColumnName($joinColumn, $this->class, $this->platform);
  1458.                     }
  1459.                 }
  1461.                 continue;
  1462.             }
  1464.             if (! $this->class->isIdGeneratorIdentity() || $this->class->identifier[0] != $name) {
  1465.                 $columns[]                = $this->quoteStrategy->getColumnName($name, $this->class, $this->platform);
  1466.                 $this->columnTypes[$name] = $this->class->fieldMappings[$name]['type'];
  1467.             }
  1468.         }
  1470.         return $columns;
  1471.     }
  1473.     /**
  1474.      * Gets the SQL snippet of a qualified column name for the given field name.
  1475.      *
  1476.      * @param string        $field The field name.
  1477.      * @param ClassMetadata $class The class that declares this field. The table this class is
  1478.      *                             mapped to must own the column for the given field.
  1479.      * @param string        $alias
  1480.      *
  1481.      * @return string
  1482.      */
  1483.     protected function getSelectColumnSQL($field, ClassMetadata $class, $alias = 'r')
  1484.     {
  1485.         $root         = $alias == 'r' ? '' : $alias ;
  1486.         $tableAlias   = $this->getSQLTableAlias($class->name, $root);
  1487.         $fieldMapping = $class->fieldMappings[$field];
  1488.         $sql          = sprintf('%s.%s', $tableAlias, $this->quoteStrategy->getColumnName($field, $class, $this->platform));
  1489.         $columnAlias  = $this->getSQLColumnAlias($fieldMapping['columnName']);
  1491.         $this->currentPersisterContext->rsm->addFieldResult($alias, $columnAlias, $field);
  1493.         if (isset($fieldMapping['requireSQLConversion'])) {
  1494.             $type = Type::getType($fieldMapping['type']);
  1495.             $sql  = $type->convertToPHPValueSQL($sql, $this->platform);
  1496.         }
  1498.         return $sql . ' AS ' . $columnAlias;
  1499.     }
  1501.     /**
  1502.      * Gets the SQL table alias for the given class name.
  1503.      *
  1504.      * @param string $className
  1505.      * @param string $assocName
  1506.      *
  1507.      * @return string The SQL table alias.
  1508.      *
  1509.      * @todo Reconsider. Binding table aliases to class names is not such a good idea.
  1510.      */
  1511.     protected function getSQLTableAlias($className, $assocName = '')
  1512.     {
  1513.         if ($assocName) {
  1514.             $className .= '#' . $assocName;
  1515.         }
  1517.         if (isset($this->currentPersisterContext->sqlTableAliases[$className])) {
  1518.             return $this->currentPersisterContext->sqlTableAliases[$className];
  1519.         }
  1521.         $tableAlias = 't' . $this->currentPersisterContext->sqlAliasCounter++;
  1523.         $this->currentPersisterContext->sqlTableAliases[$className] = $tableAlias;
  1525.         return $tableAlias;
  1526.     }
  1528.     /**
  1529.      * {@inheritdoc}
  1530.      */
  1531.     public function lock(array $criteria, $lockMode)
  1532.     {
  1533.         $lockSql      = '';
  1534.         $conditionSql = $this->getSelectConditionSQL($criteria);
  1536.         switch ($lockMode) {
  1537.             case LockMode::PESSIMISTIC_READ:
  1538.                 $lockSql = $this->platform->getReadLockSQL();
  1540.                 break;
  1541.             case LockMode::PESSIMISTIC_WRITE:
  1543.                 $lockSql = $this->platform->getWriteLockSQL();
  1544.                 break;
  1545.         }
  1547.         $lock  = $this->getLockTablesSql($lockMode);
  1548.         $where = ($conditionSql ? ' WHERE ' . $conditionSql : '') . ' ';
  1549.         $sql = 'SELECT 1 '
  1550.              . $lock
  1551.              . $where
  1552.              . $lockSql;
  1554.         list($params, $types) = $this->expandParameters($criteria);
  1556.         $this->conn->executeQuery($sql, $params, $types);
  1557.     }
  1559.     /**
  1560.      * Gets the FROM and optionally JOIN conditions to lock the entity managed by this persister.
  1561.      *
  1562.      * @param integer $lockMode One of the Doctrine\DBAL\LockMode::* constants.
  1563.      *
  1564.      * @return string
  1565.      */
  1566.     protected function getLockTablesSql($lockMode)
  1567.     {
  1568.         return $this->platform->appendLockHint(
  1569.             'FROM '
  1570.             . $this->quoteStrategy->getTableName($this->class, $this->platform) . ' '
  1571.             . $this->getSQLTableAlias($this->class->name),
  1572.             $lockMode
  1573.         );
  1574.     }
  1576.     /**
  1577.      * Gets the Select Where Condition from a Criteria object.
  1578.      *
  1579.      * @param \Doctrine\Common\Collections\Criteria $criteria
  1580.      *
  1581.      * @return string
  1582.      */
  1583.     protected function getSelectConditionCriteriaSQL(Criteria $criteria)
  1584.     {
  1585.         $expression = $criteria->getWhereExpression();
  1587.         if ($expression === null) {
  1588.             return '';
  1589.         }
  1591.         $visitor = new SqlExpressionVisitor($this, $this->class);
  1593.         return $visitor->dispatch($expression);
  1594.     }
  1596.     /**
  1597.      * {@inheritdoc}
  1598.      */
  1599.     public function getSelectConditionStatementSQL($field, $value, $assoc = null, $comparison = null)
  1600.     {
  1601.         $selectedColumns = [];
  1602.         $columns         = $this->getSelectConditionStatementColumnSQL($field, $assoc);
  1604.         if (count($columns) > 1 && $comparison === Comparison::IN) {
  1605.             /*
  1606.              *  @todo try to support multi-column IN expressions.
  1607.              *  Example: (col1, col2) IN (('val1A', 'val2A'), ('val1B', 'val2B'))
  1608.              */
  1609.             throw ORMException::cantUseInOperatorOnCompositeKeys();
  1610.         }
  1612.         foreach ($columns as $column) {
  1613.             $placeholder = '?';
  1615.             if (isset($this->class->fieldMappings[$field]['requireSQLConversion'])) {
  1616.                 $type        = Type::getType($this->class->fieldMappings[$field]['type']);
  1617.                 $placeholder = $type->convertToDatabaseValueSQL($placeholder, $this->platform);
  1618.             }
  1620.             if (null !== $comparison) {
  1621.                 // special case null value handling
  1622.                 if (($comparison === Comparison::EQ || $comparison === Comparison::IS) && null ===$value) {
  1623.                     $selectedColumns[] = $column . ' IS NULL';
  1625.                     continue;
  1626.                 }
  1628.                 if ($comparison === Comparison::NEQ && null === $value) {
  1629.                     $selectedColumns[] = $column . ' IS NOT NULL';
  1631.                     continue;
  1632.                 }
  1634.                 $selectedColumns[] = $column . ' ' . sprintf(self::$comparisonMap[$comparison], $placeholder);
  1636.                 continue;
  1637.             }
  1639.             if (is_array($value)) {
  1640.                 $in = sprintf('%s IN (%s)', $column, $placeholder);
  1642.                 if (false !== array_search(null, $value, true)) {
  1643.                     $selectedColumns[] = sprintf('(%s OR %s IS NULL)', $in, $column);
  1645.                     continue;
  1646.                 }
  1648.                 $selectedColumns[] = $in;
  1650.                 continue;
  1651.             }
  1653.             if (null === $value) {
  1654.                 $selectedColumns[] = sprintf('%s IS NULL', $column);
  1656.                 continue;
  1657.             }
  1659.             $selectedColumns[] = sprintf('%s = %s', $column, $placeholder);
  1660.         }
  1662.         return implode(' AND ', $selectedColumns);
  1663.     }
  1665.     /**
  1666.      * Builds the left-hand-side of a where condition statement.
  1667.      *
  1668.      * @param string     $field
  1669.      * @param array|null $assoc
  1670.      *
  1671.      * @return string[]
  1672.      *
  1673.      * @throws \Doctrine\ORM\ORMException
  1674.      */
  1675.     private function getSelectConditionStatementColumnSQL($field, $assoc = null)
  1676.     {
  1677.         if (isset($this->class->fieldMappings[$field])) {
  1678.             $className = (isset($this->class->fieldMappings[$field]['inherited']))
  1679.                 ? $this->class->fieldMappings[$field]['inherited']
  1680.                 : $this->class->name;
  1682.             return [$this->getSQLTableAlias($className) . '.' . $this->quoteStrategy->getColumnName($field, $this->class, $this->platform)];
  1683.         }
  1685.         if (isset($this->class->associationMappings[$field])) {
  1686.             $association = $this->class->associationMappings[$field];
  1687.             // Many-To-Many requires join table check for joinColumn
  1688.             $columns = [];
  1689.             $class   = $this->class;
  1691.             if ($association['type'] === ClassMetadata::MANY_TO_MANY) {
  1692.                 if ( ! $association['isOwningSide']) {
  1693.                     $association = $assoc;
  1694.                 }
  1696.                 $joinTableName = $this->quoteStrategy->getJoinTableName($association, $class, $this->platform);
  1697.                 $joinColumns   = $assoc['isOwningSide']
  1698.                     ? $association['joinTable']['joinColumns']
  1699.                     : $association['joinTable']['inverseJoinColumns'];
  1702.                 foreach ($joinColumns as $joinColumn) {
  1703.                     $columns[] = $joinTableName . '.' . $this->quoteStrategy->getJoinColumnName($joinColumn, $class, $this->platform);
  1704.                 }
  1706.             } else {
  1707.                 if ( ! $association['isOwningSide']) {
  1708.                     throw ORMException::invalidFindByInverseAssociation($this->class->name, $field);
  1709.                 }
  1711.                 $className  = (isset($association['inherited']))
  1712.                     ? $association['inherited']
  1713.                     : $this->class->name;
  1715.                 foreach ($association['joinColumns'] as $joinColumn) {
  1716.                     $columns[] = $this->getSQLTableAlias($className) . '.' . $this->quoteStrategy->getJoinColumnName($joinColumn, $this->class, $this->platform);
  1717.                 }
  1718.             }
  1719.             return $columns;
  1720.         }
  1722.         if ($assoc !== null && strpos($field, " ") === false && strpos($field, "(") === false) {
  1723.             // very careless developers could potentially open up this normally hidden api for userland attacks,
  1724.             // therefore checking for spaces and function calls which are not allowed.
  1726.             // found a join column condition, not really a "field"
  1727.             return [$field];
  1728.         }
  1730.         throw ORMException::unrecognizedField($field);
  1731.     }
  1733.     /**
  1734.      * Gets the conditional SQL fragment used in the WHERE clause when selecting
  1735.      * entities in this persister.
  1736.      *
  1737.      * Subclasses are supposed to override this method if they intend to change
  1738.      * or alter the criteria by which entities are selected.
  1739.      *
  1740.      * @param array      $criteria
  1741.      * @param array|null $assoc
  1742.      *
  1743.      * @return string
  1744.      */
  1745.     protected function getSelectConditionSQL(array $criteria, $assoc = null)
  1746.     {
  1747.         $conditions = [];
  1749.         foreach ($criteria as $field => $value) {
  1750.             $conditions[] = $this->getSelectConditionStatementSQL($field, $value, $assoc);
  1751.         }
  1753.         return implode(' AND ', $conditions);
  1754.     }
  1756.     /**
  1757.      * {@inheritdoc}
  1758.      */
  1759.     public function getOneToManyCollection(array $assoc, $sourceEntity, $offset = null, $limit = null)
  1760.     {
  1761.         $this->switchPersisterContext($offset, $limit);
  1763.         $stmt = $this->getOneToManyStatement($assoc, $sourceEntity, $offset, $limit);
  1765.         return $this->loadArrayFromStatement($assoc, $stmt);
  1766.     }
  1768.     /**
  1769.      * {@inheritdoc}
  1770.      */
  1771.     public function loadOneToManyCollection(array $assoc, $sourceEntity, PersistentCollection $coll)
  1772.     {
  1773.         $stmt = $this->getOneToManyStatement($assoc, $sourceEntity);
  1775.         return $this->loadCollectionFromStatement($assoc, $stmt, $coll);
  1776.     }
  1778.     /**
  1779.      * Builds criteria and execute SQL statement to fetch the one to many entities from.
  1780.      *
  1781.      * @param array    $assoc
  1782.      * @param object   $sourceEntity
  1783.      * @param int|null $offset
  1784.      * @param int|null $limit
  1785.      *
  1786.      * @return \Doctrine\DBAL\Statement
  1787.      */
  1788.     private function getOneToManyStatement(array $assoc, $sourceEntity, $offset = null, $limit = null)
  1789.     {
  1790.         $this->switchPersisterContext($offset, $limit);
  1792.         $criteria    = [];
  1793.         $parameters  = [];
  1794.         $owningAssoc = $this->class->associationMappings[$assoc['mappedBy']];
  1795.         $sourceClass = $this->em->getClassMetadata($assoc['sourceEntity']);
  1796.         $tableAlias  = $this->getSQLTableAlias($owningAssoc['inherited'] ?? $this->class->name);
  1798.         foreach ($owningAssoc['targetToSourceKeyColumns'] as $sourceKeyColumn => $targetKeyColumn) {
  1799.             if ($sourceClass->containsForeignIdentifier) {
  1800.                 $field = $sourceClass->getFieldForColumn($sourceKeyColumn);
  1801.                 $value = $sourceClass->reflFields[$field]->getValue($sourceEntity);
  1803.                 if (isset($sourceClass->associationMappings[$field])) {
  1804.                     $value = $this->em->getUnitOfWork()->getEntityIdentifier($value);
  1805.                     $value = $value[$this->em->getClassMetadata($sourceClass->associationMappings[$field]['targetEntity'])->identifier[0]];
  1806.                 }
  1808.                 $criteria[$tableAlias . "." . $targetKeyColumn] = $value;
  1809.                 $parameters[]                                   = [
  1810.                     'value' => $value,
  1811.                     'field' => $field,
  1812.                     'class' => $sourceClass,
  1813.                 ];
  1815.                 continue;
  1816.             }
  1818.             $field = $sourceClass->fieldNames[$sourceKeyColumn];
  1819.             $value = $sourceClass->reflFields[$field]->getValue($sourceEntity);
  1821.             $criteria[$tableAlias . "." . $targetKeyColumn] = $value;
  1822.             $parameters[] = [
  1823.                 'value' => $value,
  1824.                 'field' => $field,
  1825.                 'class' => $sourceClass,
  1826.             ];
  1828.         }
  1830.         $sql                  = $this->getSelectSQL($criteria, $assoc, null, $limit, $offset);
  1831.         list($params, $types) = $this->expandToManyParameters($parameters);
  1833.         return $this->conn->executeQuery($sql, $params, $types);
  1834.     }
  1836.     /**
  1837.      * {@inheritdoc}
  1838.      */
  1839.     public function expandParameters($criteria)
  1840.     {
  1841.         $params = [];
  1842.         $types  = [];
  1844.         foreach ($criteria as $field => $value) {
  1845.             if ($value === null) {
  1846.                 continue; // skip null values.
  1847.             }
  1849.             $types  = array_merge($types, $this->getTypes($field, $value, $this->class));
  1850.             $params = array_merge($params, $this->getValues($value));
  1851.         }
  1853.         return [$params, $types];
  1854.     }
  1856.     /**
  1857.      * Expands the parameters from the given criteria and use the correct binding types if found,
  1858.      * specialized for OneToMany or ManyToMany associations.
  1859.      *
  1860.      * @param mixed[][] $criteria an array of arrays containing following:
  1861.      *                             - field to which each criterion will be bound
  1862.      *                             - value to be bound
  1863.      *                             - class to which the field belongs to
  1864.      *
  1865.      *
  1866.      * @return array
  1867.      */
  1868.     private function expandToManyParameters($criteria)
  1869.     {
  1870.         $params = [];
  1871.         $types  = [];
  1873.         foreach ($criteria as $criterion) {
  1874.             if ($criterion['value'] === null) {
  1875.                 continue; // skip null values.
  1876.             }
  1878.             $types  = array_merge($types, $this->getTypes($criterion['field'], $criterion['value'], $criterion['class']));
  1879.             $params = array_merge($params, $this->getValues($criterion['value']));
  1880.         }
  1882.         return [$params, $types];
  1883.     }
  1885.     /**
  1886.      * Infers field types to be used by parameter type casting.
  1887.      *
  1888.      * @param string        $field
  1889.      * @param mixed         $value
  1890.      * @param ClassMetadata $class
  1891.      *
  1892.      * @return array
  1893.      *
  1894.      * @throws \Doctrine\ORM\Query\QueryException
  1895.      */
  1896.     private function getTypes($field, $value, ClassMetadata $class)
  1897.     {
  1898.         $types = [];
  1900.         switch (true) {
  1901.             case (isset($class->fieldMappings[$field])):
  1902.                 $types = array_merge($types, [$class->fieldMappings[$field]['type']]);
  1903.                 break;
  1905.             case (isset($class->associationMappings[$field])):
  1906.                 $assoc = $class->associationMappings[$field];
  1907.                 $class = $this->em->getClassMetadata($assoc['targetEntity']);
  1909.                 if (! $assoc['isOwningSide']) {
  1910.                     $assoc = $class->associationMappings[$assoc['mappedBy']];
  1911.                     $class = $this->em->getClassMetadata($assoc['targetEntity']);
  1912.                 }
  1914.                 $columns = $assoc['type'] === ClassMetadata::MANY_TO_MANY
  1915.                     ? $assoc['relationToTargetKeyColumns']
  1916.                     : $assoc['sourceToTargetKeyColumns'];
  1918.                 foreach ($columns as $column){
  1919.                     $types[] = PersisterHelper::getTypeOfColumn($column, $class, $this->em);
  1920.                 }
  1921.                 break;
  1923.             default:
  1924.                 $types[] = null;
  1925.                 break;
  1926.         }
  1928.         if (is_array($value)) {
  1929.             return array_map(function ($type) {
  1930.                 $type = Type::getType($type);
  1932.                 return $type->getBindingType() + Connection::ARRAY_PARAM_OFFSET;
  1933.             }, $types);
  1934.         }
  1936.         return $types;
  1937.     }
  1939.     /**
  1940.      * Retrieves the parameters that identifies a value.
  1941.      *
  1942.      * @param mixed $value
  1943.      *
  1944.      * @return array
  1945.      */
  1946.     private function getValues($value)
  1947.     {
  1948.         if (is_array($value)) {
  1949.             $newValue = [];
  1951.             foreach ($value as $itemValue) {
  1952.                 $newValue = array_merge($newValue, $this->getValues($itemValue));
  1953.             }
  1955.             return [$newValue];
  1956.         }
  1958.         if (is_object($value) && $this->em->getMetadataFactory()->hasMetadataFor(ClassUtils::getClass($value))) {
  1959.             $class = $this->em->getClassMetadata(get_class($value));
  1960.             if ($class->isIdentifierComposite) {
  1961.                 $newValue = [];
  1963.                 foreach ($class->getIdentifierValues($value) as $innerValue) {
  1964.                     $newValue = array_merge($newValue, $this->getValues($innerValue));
  1965.                 }
  1967.                 return $newValue;
  1968.             }
  1969.         }
  1971.         return [$this->getIndividualValue($value)];
  1972.     }
  1974.     /**
  1975.      * Retrieves an individual parameter value.
  1976.      *
  1977.      * @param mixed $value
  1978.      *
  1979.      * @return mixed
  1980.      */
  1981.     private function getIndividualValue($value)
  1982.     {
  1983.         if ( ! is_object($value) || ! $this->em->getMetadataFactory()->hasMetadataFor(ClassUtils::getClass($value))) {
  1984.             return $value;
  1985.         }
  1987.         return $this->em->getUnitOfWork()->getSingleIdentifierValue($value);
  1988.     }
  1990.     /**
  1991.      * {@inheritdoc}
  1992.      */
  1993.     public function exists($entity, Criteria $extraConditions = null)
  1994.     {
  1995.         $criteria = $this->class->getIdentifierValues($entity);
  1997.         if ( ! $criteria) {
  1998.             return false;
  1999.         }
  2001.         $alias = $this->getSQLTableAlias($this->class->name);
  2003.         $sql = 'SELECT 1 '
  2004.              . $this->getLockTablesSql(null)
  2005.              . ' WHERE ' . $this->getSelectConditionSQL($criteria);
  2007.         list($params, $types) = $this->expandParameters($criteria);
  2009.         if (null !== $extraConditions) {
  2010.             $sql                                 .= ' AND ' . $this->getSelectConditionCriteriaSQL($extraConditions);
  2011.             list($criteriaParams, $criteriaTypes) = $this->expandCriteriaParameters($extraConditions);
  2013.             $params = array_merge($params, $criteriaParams);
  2014.             $types  = array_merge($types, $criteriaTypes);
  2015.         }
  2017.         if ($filterSql = $this->generateFilterConditionSQL($this->class, $alias)) {
  2018.             $sql .= ' AND ' . $filterSql;
  2019.         }
  2021.         return (bool) $this->conn->fetchColumn($sql, $params, 0, $types);
  2022.     }
  2024.     /**
  2025.      * Generates the appropriate join SQL for the given join column.
  2026.      *
  2027.      * @param array $joinColumns The join columns definition of an association.
  2028.      *
  2029.      * @return string LEFT JOIN if one of the columns is nullable, INNER JOIN otherwise.
  2030.      */
  2031.     protected function getJoinSQLForJoinColumns($joinColumns)
  2032.     {
  2033.         // if one of the join columns is nullable, return left join
  2034.         foreach ($joinColumns as $joinColumn) {
  2035.              if ( ! isset($joinColumn['nullable']) || $joinColumn['nullable']) {
  2036.                  return 'LEFT JOIN';
  2037.              }
  2038.         }
  2040.         return 'INNER JOIN';
  2041.     }
  2043.     /**
  2044.      * {@inheritdoc}
  2045.      */
  2046.     public function getSQLColumnAlias($columnName)
  2047.     {
  2048.         return $this->quoteStrategy->getColumnAlias($columnName, $this->currentPersisterContext->sqlAliasCounter++, $this->platform);
  2049.     }
  2051.     /**
  2052.      * Generates the filter SQL for a given entity and table alias.
  2053.      *
  2054.      * @param ClassMetadata $targetEntity     Metadata of the target entity.
  2055.      * @param string        $targetTableAlias The table alias of the joined/selected table.
  2056.      *
  2057.      * @return string The SQL query part to add to a query.
  2058.      */
  2059.     protected function generateFilterConditionSQL(ClassMetadata $targetEntity, $targetTableAlias)
  2060.     {
  2061.         $filterClauses = [];
  2063.         foreach ($this->em->getFilters()->getEnabledFilters() as $filter) {
  2064.             if ('' !== $filterExpr = $filter->addFilterConstraint($targetEntity, $targetTableAlias)) {
  2065.                 $filterClauses[] = '(' . $filterExpr . ')';
  2066.             }
  2067.         }
  2069.         $sql = implode(' AND ', $filterClauses);
  2071.         return $sql ? "(" . $sql . ")" : ""; // Wrap again to avoid "X or Y and FilterConditionSQL"
  2072.     }
  2074.     /**
  2075.      * Switches persister context according to current query offset/limits
  2076.      *
  2077.      * This is due to the fact that to-many associations cannot be fetch-joined when a limit is involved
  2078.      *
  2079.      * @param null|int $offset
  2080.      * @param null|int $limit
  2081.      */
  2082.     protected function switchPersisterContext($offset, $limit)
  2083.     {
  2084.         if (null === $offset && null === $limit) {
  2085.             $this->currentPersisterContext = $this->noLimitsContext;
  2087.             return;
  2088.         }
  2090.         $this->currentPersisterContext = $this->limitsHandlingContext;
  2091.     }
  2092. }