. */ namespace Doctrine\ORM\Mapping; /** * A one-to-one mapping describes a uni-directional mapping from one entity * to another entity. * * IMPORTANT NOTE: * * The fields of this class are only public for 2 reasons: * 1) To allow fast, internal READ access. * 2) To drastically reduce the size of a serialized instance (private/protected members * get the whole class name, namespace inclusive, prepended to every property in * the serialized representation). * * @since 2.0 * @author Roman Borschel * @author Giorgio Sironi */ class OneToOneMapping extends AssociationMapping { /** * Maps the source foreign/primary key columns to the target primary/foreign key columns. * i.e. source.id (pk) => target.user_id (fk). * Reverse mapping of _targetToSourceKeyColumns. */ public $sourceToTargetKeyColumns = array(); /** * Maps the target primary/foreign key columns to the source foreign/primary key columns. * i.e. target.user_id (fk) => source.id (pk). * Reverse mapping of _sourceToTargetKeyColumns. */ public $targetToSourceKeyColumns = array(); /** * Whether to delete orphaned elements (when nulled out, i.e. $foo->other = null) * * @var boolean */ public $orphanRemoval = false; /** * Whether the association is optional (0..1) or not (1..1). * By default all associations are optional. * * @var boolean */ public $isOptional = true; /** * The join column definitions. * * @var array */ public $joinColumns = array(); /** * A map of join column names to field names that are used in cases * when the join columns are fetched as part of the query result. * * @var array */ public $joinColumnFieldNames = array(); /** * Creates a new OneToOneMapping. * * @param array $mapping The mapping info. */ public function __construct(array $mapping) { parent::__construct($mapping); } /** * {@inheritdoc} * * @param array $mapping The mapping to validate & complete. * @return array The validated & completed mapping. * @override */ protected function _validateAndCompleteMapping(array $mapping) { parent::_validateAndCompleteMapping($mapping); if (isset($mapping['joinColumns']) && $mapping['joinColumns']) { $this->isOwningSide = true; } if ($this->isOwningSide) { if ( ! isset($mapping['joinColumns'])) { throw MappingException::invalidMapping($this->sourceFieldName); } foreach ($mapping['joinColumns'] as &$joinColumn) { if ($joinColumn['name'][0] == '`') { $joinColumn['name'] = trim($joinColumn['name'], '`'); $joinColumn['quoted'] = true; } $this->sourceToTargetKeyColumns[$joinColumn['name']] = $joinColumn['referencedColumnName']; $this->joinColumnFieldNames[$joinColumn['name']] = isset($joinColumn['fieldName']) ? $joinColumn['fieldName'] : $joinColumn['name']; } $this->joinColumns = $mapping['joinColumns']; $this->targetToSourceKeyColumns = array_flip($this->sourceToTargetKeyColumns); } $this->isOptional = isset($mapping['optional']) ? (bool)$mapping['optional'] : true; $this->orphanRemoval = isset($mapping['orphanRemoval']) ? (bool) $mapping['orphanRemoval'] : false; /*if ($this->isOptional) { $this->fetchMode = self::FETCH_EAGER; }*/ return $mapping; } /** * Whether the association is optional (0..1), or not (1..1). * * @return boolean TRUE if the association is optional, FALSE otherwise. * @todo Only applicable to OneToOne. Move there. */ public function isOptional() { return $this->isOptional; } /** * Gets the join column definitions for this mapping. * * @return array */ public function getJoinColumns() { return $this->joinColumns; } /** * Gets the source-to-target key column mapping. * * @return array */ public function getSourceToTargetKeyColumns() { return $this->sourceToTargetKeyColumns; } /** * Gets the target-to-source key column mapping. * * @return array */ public function getTargetToSourceKeyColumns() { return $this->targetToSourceKeyColumns; } /** * {@inheritdoc} * * @return boolean * @override */ public function isOneToOne() { return true; } /** * Gets the (possibly quoted) column name of a join column that is safe to use * in an SQL statement. * * @param string $joinColumn * @param AbstractPlatform $platform * @return string */ public function getQuotedJoinColumnName($joinColumn, $platform) { return isset($this->joinColumns[$joinColumn]['quoted']) ? $platform->quoteIdentifier($joinColumn) : $joinColumn; } /** * {@inheritdoc} * * @param object $sourceEntity the entity source of this association * @param object $targetEntity the entity to load data in * @param EntityManager $em * @param array $joinColumnValues Values of the join columns of $sourceEntity. */ public function load($sourceEntity, $targetEntity, $em, array $joinColumnValues = array()) { $sourceClass = $em->getClassMetadata($this->sourceEntityName); $targetClass = $em->getClassMetadata($this->targetEntityName); $conditions = array(); if ($this->isOwningSide) { foreach ($this->sourceToTargetKeyColumns as $sourceKeyColumn => $targetKeyColumn) { // getting customer_id if (isset($sourceClass->fieldNames[$sourceKeyColumn])) { $conditions[$targetKeyColumn] = $sourceClass->reflFields[$sourceClass->fieldNames[$sourceKeyColumn]]->getValue($sourceEntity); } else { $conditions[$targetKeyColumn] = $joinColumnValues[$sourceKeyColumn]; } } $targetEntity = $em->getUnitOfWork()->getEntityPersister($this->targetEntityName)->load($conditions, $targetEntity, $this); if ($targetEntity !== null && $targetClass->hasInverseAssociationMapping($this->sourceEntityName, $this->sourceFieldName)) { $targetClass->setFieldValue($targetEntity, $targetClass->inverseMappings[$this->sourceEntityName][$this->sourceFieldName]->sourceFieldName, $sourceEntity); } } else { $owningAssoc = $em->getClassMetadata($this->targetEntityName)->getAssociationMapping($this->mappedByFieldName); // TRICKY: since the association is specular source and target are flipped foreach ($owningAssoc->targetToSourceKeyColumns as $sourceKeyColumn => $targetKeyColumn) { // getting id if (isset($sourceClass->fieldNames[$sourceKeyColumn])) { $conditions[$targetKeyColumn] = $sourceClass->reflFields[$sourceClass->fieldNames[$sourceKeyColumn]]->getValue($sourceEntity); } else { $conditions[$targetKeyColumn] = $joinColumnValues[$sourceKeyColumn]; } } $targetEntity = $em->getUnitOfWork()->getEntityPersister($this->targetEntityName)->load($conditions, $targetEntity, $this); $targetClass->setFieldValue($targetEntity, $this->mappedByFieldName, $sourceEntity); } } }