. */ namespace Doctrine\ORM\Persisters; use Doctrine\Common\DoctrineException; /** * The joined subclass persister maps a single entity instance to several tables in the * database as it is defined by Class Table Inheritance. * * @author Roman Borschel * @license http://www.opensource.org/licenses/lgpl-license.php LGPL * @version $Revision$ * @link www.doctrine-project.org * @since 2.0 * @todo Reimplement. */ class JoinedSubclassPersister extends StandardEntityPersister { /** Map that maps column names to the table names that own them. * This is mainly a temporary cache, used during a single request. */ private $_owningTableMap = array(); /** * {@inheritdoc} * * @override */ protected function _prepareData($entity, array &$result, $isInsert = false) { parent::_prepareData($entity, $result, $isInsert); // Populate the discriminator column if ($isInsert) { $discColumn = $this->_class->discriminatorColumn; $rootClass = $this->_em->getClassMetadata($this->_class->rootEntityName); $result[$rootClass->primaryTable['name']][$discColumn['name']] = $this->_class->discriminatorValue; } } /** * {@inheritdoc} * * @override */ public function getOwningTable($fieldName) { if ( ! isset($this->_owningTableMap[$fieldName])) { if (isset($this->_class->associationMappings[$fieldName])) { if (isset($this->_class->inheritedAssociationFields[$fieldName])) { $this->_owningTableMap[$fieldName] = $this->_em->getClassMetadata( $this->_class->inheritedAssociationFields[$fieldName])->primaryTable['name']; } else { $this->_owningTableMap[$fieldName] = $this->_class->primaryTable['name']; } } else if (isset($this->_class->fieldMappings[$fieldName]['inherited'])) { $this->_owningTableMap[$fieldName] = $this->_em->getClassMetadata( $this->_class->fieldMappings[$fieldName]['inherited'])->primaryTable['name']; } else { $this->_owningTableMap[$fieldName] = $this->_class->primaryTable['name']; } } return $this->_owningTableMap[$fieldName]; } /** * {@inheritdoc} * * @override */ public function executeInserts() { if ( ! $this->_queuedInserts) { return; } $postInsertIds = array(); $idGen = $this->_class->idGenerator; $isPostInsertId = $idGen->isPostInsertGenerator(); // Prepare statements for all tables $stmts = $classes = array(); $stmts[$this->_class->primaryTable['name']] = $this->_conn->prepare($this->_class->insertSql); $classes[$this->_class->name] = $this->_class; foreach ($this->_class->parentClasses as $parentClass) { $classes[$parentClass] = $this->_em->getClassMetadata($parentClass); $stmts[$classes[$parentClass]->primaryTable['name']] = $this->_conn->prepare($classes[$parentClass]->insertSql); } $rootTableName = $classes[$this->_class->rootEntityName]->primaryTable['name']; foreach ($this->_queuedInserts as $entity) { $insertData = array(); $this->_prepareData($entity, $insertData, true); // Execute insert on root table $paramIndex = 1; $stmt = $stmts[$rootTableName]; foreach ($insertData[$rootTableName] as $columnName => $value) { $stmt->bindValue($paramIndex++, $value/*, TODO: TYPE*/); } $stmt->execute(); unset($insertData[$rootTableName]); if ($isPostInsertId) { $id = $idGen->generate($this->_em, $entity); $postInsertIds[$id] = $entity; } else { $id = $this->_em->getUnitOfWork()->getEntityIdentifier($entity); } // Execute inserts on subtables foreach ($insertData as $tableName => $data) { $stmt = $stmts[$tableName]; $paramIndex = 1; foreach ((array)$id as $idVal) { $stmt->bindValue($paramIndex++, $idVal/*, TODO: TYPE*/); } foreach ($data as $columnName => $value) { $stmt->bindValue($paramIndex++, $value/*, TODO: TYPE*/); } $stmt->execute(); } } foreach ($stmts as $stmt) $stmt->closeCursor(); $this->_queuedInserts = array(); return $postInsertIds; } /** * Updates an entity. * * @param object $entity The entity to update. * @override */ public function update($entity) { $updateData = array(); $this->_prepareData($entity, $updateData); $id = array_combine( $this->_class->getIdentifierFieldNames(), $this->_em->getUnitOfWork()->getEntityIdentifier($entity) ); foreach ($updateData as $tableName => $data) { $this->_conn->update($tableName, $updateData[$tableName], $id); } } /** * Deletes an entity. * * @param object $entity The entity to delete. * @override */ public function delete($entity) { $id = array_combine( $this->_class->getIdentifierFieldNames(), $this->_em->getUnitOfWork()->getEntityIdentifier($entity) ); // If the database platform supports FKs, just // delete the row from the root table. Cascades do the rest. if ($this->_conn->getDatabasePlatform()->supportsForeignKeyConstraints()) { $this->_conn->delete($this->_em->getClassMetadata($this->_class->rootEntityName) ->primaryTable['name'], $id); } else { // Delete the parent tables, starting from this class' table up to the root table $this->_conn->delete($this->_class->primaryTable['name'], $id); foreach ($this->_class->parentClasses as $parentClass) { $this->_conn->delete($this->_em->getClassMetadata($parentClass)->primaryTable['name'], $id); } } } /** * Adds all parent classes as INNER JOINs and subclasses as OUTER JOINs * to the query. * * Callback that is invoked during the SQL construction process. * * @return array The custom joins in the format => */ /*public function getCustomJoins() { $customJoins = array(); $classMetadata = $this->_classMetadata; foreach ($classMetadata->parentClasses as $parentClass) { $customJoins[$parentClass] = 'INNER'; } foreach ($classMetadata->subClasses as $subClass) { if ($subClass != $this->getComponentName()) { $customJoins[$subClass] = 'LEFT'; } } return $customJoins; }*/ /** * Adds the discriminator column to the selected fields in a query as well as * all fields of subclasses. In Class Table Inheritance the default behavior is that * all subclasses are joined in through OUTER JOINs when querying a base class. * * Callback that is invoked during the SQL construction process. * * @return array An array with the field names that will get added to the query. */ /*public function getCustomFields() { $classMetadata = $this->_classMetadata; $conn = $this->_conn; $discrColumn = $classMetadata->discriminatorColumn; $fields = array($discrColumn['name']); if ($classMetadata->subClasses) { foreach ($classMetadata->subClasses as $subClass) { $fields = array_merge($conn->getClassMetadata($subClass)->fieldNames, $fields); } } return array_unique($fields); }*/ /** * * @todo Looks like this better belongs into the ClassMetadata class. */ /*public function getOwningClass($fieldName) { $conn = $this->_conn; $classMetadata = $this->_classMetadata; if ($classMetadata->hasField($fieldName) && ! $classMetadata->isInheritedField($fieldName)) { return $classMetadata; } foreach ($classMetadata->parentClasses as $parentClass) { $parentTable = $conn->getClassMetadata($parentClass); if ($parentTable->hasField($fieldName) && ! $parentTable->isInheritedField($fieldName)) { return $parentTable; } } foreach ((array)$classMetadata->subClasses as $subClass) { $subTable = $conn->getClassMetadata($subClass); if ($subTable->hasField($fieldName) && ! $subTable->isInheritedField($fieldName)) { return $subTable; } } throw \Doctrine\Common\DoctrineException::updateMe("Unable to find defining class of field '$fieldName'."); }*/ }