. */ namespace Doctrine\ORM\Mapping; /** * A many-to-many mapping describes the mapping between two collections of * entities. * * @since 2.0 * @author Roman Borschel */ class ManyToManyMapping extends AssociationMapping { /** * The key columns of the source table. */ private $_sourceKeyColumns = array(); /** * The key columns of the target table. */ private $_targetKeyColumns = array(); /** * Maps the columns in the source table to the columns in the relation table. */ private $_sourceToRelationKeyColumns = array(); /** * Maps the columns in the target table to the columns in the relation table. */ private $_targetToRelationKeyColumns = array(); /** * The columns on the join table. */ private $_joinTableColumns = array(); /** * Initializes a new ManyToManyMapping. * * @param array $mapping The mapping information. */ public function __construct(array $mapping) { parent::__construct($mapping); } /** * Validates and completes the mapping. * * @param array $mapping * @override */ protected function _validateAndCompleteMapping(array $mapping) { parent::_validateAndCompleteMapping($mapping); if ($this->isOwningSide()) { // owning side MUST have a join table if ( ! isset($mapping['joinTable'])) { throw MappingException::joinTableRequired($mapping['fieldName']); } // owning side MUST specify joinColumns if ( ! isset($mapping['joinTable']['joinColumns'])) { throw MappingException::invalidMapping($this->_sourceFieldName); } foreach ($mapping['joinTable']['joinColumns'] as $joinColumn) { $this->_sourceToRelationKeyColumns[$joinColumn['referencedColumnName']] = $joinColumn['name']; $this->_joinTableColumns[] = $joinColumn['name']; } $this->_sourceKeyColumns = array_keys($this->_sourceToRelationKeyColumns); // owning side MUST specify inverseJoinColumns if ( ! isset($mapping['joinTable']['inverseJoinColumns'])) { throw MappingException::invalidMapping($this->_sourceFieldName); } foreach ($mapping['joinTable']['inverseJoinColumns'] as $inverseJoinColumn) { $this->_targetToRelationKeyColumns[$inverseJoinColumn['referencedColumnName']] = $inverseJoinColumn['name']; $this->_joinTableColumns[] = $inverseJoinColumn['name']; } $this->_targetKeyColumns = array_keys($this->_targetToRelationKeyColumns); } } public function getJoinTableColumns() { return $this->_joinTableColumns; } public function getSourceToRelationKeyColumns() { return $this->_sourceToRelationKeyColumns; } public function getTargetToRelationKeyColumns() { return $this->_targetToRelationKeyColumns; } public function getSourceKeyColumns() { return $this->_sourceKeyColumns; } public function getTargetKeyColumns() { return $this->_targetKeyColumns; } public function lazyLoadFor($entity, $entityManager) { } /** * {@inheritdoc} * * @override */ public function isManyToMany() { return true; } }