1
0
mirror of synced 2024-12-14 23:26:04 +03:00
doctrine2/lib/Doctrine/ORM/Mapping/Builder/ClassMetadataBuilder.php

494 lines
12 KiB
PHP
Raw Normal View History

2011-09-04 12:08:33 +04:00
<?php
/*
* THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
* "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
* LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
* A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
* OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
* SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
* LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
* DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
* THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
* (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
* OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
*
* This software consists of voluntary contributions made by many individuals
2012-05-26 16:37:00 +04:00
* and is licensed under the MIT license. For more information, see
2011-09-04 12:08:33 +04:00
* <http://www.doctrine-project.org>.
*/
namespace Doctrine\ORM\Mapping\Builder;
2012-10-12 15:53:20 +04:00
use Doctrine\ORM\Mapping\ClassMetadata;
use Doctrine\ORM\Mapping\ClassMetadataInfo;
2011-09-04 12:08:33 +04:00
/**
* Builder Object for ClassMetadata
*
* @license http://www.opensource.org/licenses/lgpl-license.php LGPL
* @link www.doctrine-project.com
* @since 2.2
2011-09-04 12:08:33 +04:00
* @author Benjamin Eberlei <kontakt@beberlei.de>
* @author Guilherme Blanco <guilhermeblanco@hotmail.com>
2011-09-04 12:08:33 +04:00
*/
class ClassMetadataBuilder
{
/**
* @var \Doctrine\ORM\Mapping\ClassMetadataInfo
2011-09-04 12:08:33 +04:00
*/
private $cm;
/**
* @param \Doctrine\ORM\Mapping\ClassMetadataInfo $cm
*/
public function __construct(ClassMetadataInfo $cm)
2011-09-04 12:08:33 +04:00
{
$this->cm = $cm;
}
/**
* @return ClassMetadata
*/
public function getClassMetadata()
{
return $this->cm;
}
/**
2012-12-03 13:36:08 +04:00
* Marks the class as mapped superclass.
*
* @return ClassMetadataBuilder
*/
2011-09-04 12:08:33 +04:00
public function setMappedSuperClass()
{
$this->cm->isMappedSuperclass = true;
2011-12-20 01:56:19 +04:00
return $this;
2011-09-04 12:08:33 +04:00
}
/**
2012-12-03 13:36:08 +04:00
* Sets custom Repository class name.
*
* @param string $repositoryClassName
2012-12-03 13:36:08 +04:00
*
* @return ClassMetadataBuilder
*/
2011-09-04 12:08:33 +04:00
public function setCustomRepositoryClass($repositoryClassName)
{
$this->cm->setCustomRepositoryClass($repositoryClassName);
return $this;
2011-09-04 12:08:33 +04:00
}
/**
2012-12-03 13:36:08 +04:00
* Marks class read only.
*
* @return ClassMetadataBuilder
*/
2011-09-04 12:08:33 +04:00
public function setReadOnly()
{
$this->cm->markReadOnly();
return $this;
2011-09-04 12:08:33 +04:00
}
/**
2012-12-03 13:36:08 +04:00
* Sets the table name.
*
* @param string $name
2012-12-03 13:36:08 +04:00
*
* @return ClassMetadataBuilder
*/
2011-09-04 12:08:33 +04:00
public function setTable($name)
{
$this->cm->setPrimaryTable(array('name' => $name));
return $this;
2011-09-04 12:08:33 +04:00
}
/**
2012-12-03 13:36:08 +04:00
* Adds Index.
*
2012-12-03 13:36:08 +04:00
* @param array $columns
* @param string $name
2012-12-03 13:36:08 +04:00
*
* @return ClassMetadataBuilder
*/
2011-09-04 12:08:33 +04:00
public function addIndex(array $columns, $name)
{
if (!isset($this->cm->table['indexes'])) {
$this->cm->table['indexes'] = array();
}
2011-09-04 12:08:33 +04:00
$this->cm->table['indexes'][$name] = array('columns' => $columns);
return $this;
2011-09-04 12:08:33 +04:00
}
/**
2012-12-03 13:36:08 +04:00
* Adds Unique Constraint.
*
2012-12-03 13:36:08 +04:00
* @param array $columns
* @param string $name
2012-12-03 13:36:08 +04:00
*
* @return ClassMetadataBuilder
*/
2011-09-04 12:08:33 +04:00
public function addUniqueConstraint(array $columns, $name)
{
if ( ! isset($this->cm->table['uniqueConstraints'])) {
2011-09-04 12:08:33 +04:00
$this->cm->table['uniqueConstraints'] = array();
}
2011-09-04 12:08:33 +04:00
$this->cm->table['uniqueConstraints'][$name] = array('columns' => $columns);
return $this;
}
/**
2012-12-03 13:36:08 +04:00
* Adds named query.
*
* @param string $name
* @param string $dqlQuery
2012-12-03 13:36:08 +04:00
*
* @return ClassMetadataBuilder
*/
public function addNamedQuery($name, $dqlQuery)
{
$this->cm->addNamedQuery(array(
'name' => $name,
'query' => $dqlQuery,
));
return $this;
}
/**
2012-12-03 13:36:08 +04:00
* Sets class as root of a joined table inheritance hierachy.
*
* @return ClassMetadataBuilder
*/
public function setJoinedTableInheritance()
{
$this->cm->setInheritanceType(ClassMetadata::INHERITANCE_TYPE_JOINED);
return $this;
}
/**
2012-12-03 13:36:08 +04:00
* Sets class as root of a single table inheritance hierachy.
*
* @return ClassMetadataBuilder
*/
public function setSingleTableInheritance()
{
$this->cm->setInheritanceType(ClassMetadata::INHERITANCE_TYPE_SINGLE_TABLE);
return $this;
}
/**
2012-12-03 13:36:08 +04:00
* Sets the discriminator column details.
*
* @param string $name
* @param string $type
2012-12-03 13:36:08 +04:00
* @param int $length
*
* @return ClassMetadataBuilder
*/
public function setDiscriminatorColumn($name, $type = 'string', $length = 255)
{
$this->cm->setDiscriminatorColumn(array(
'name' => $name,
'type' => $type,
'length' => $length,
));
return $this;
}
/**
2012-12-03 13:36:08 +04:00
* Adds a subclass to this inheritance hierachy.
*
* @param string $name
* @param string $class
2012-12-03 13:36:08 +04:00
*
* @return ClassMetadataBuilder
*/
public function addDiscriminatorMapClass($name, $class)
{
$this->cm->addDiscriminatorMapClass($name, $class);
return $this;
}
/**
2012-12-03 13:36:08 +04:00
* Sets deferred explicit change tracking policy.
*
* @return ClassMetadataBuilder
*/
public function setChangeTrackingPolicyDeferredExplicit()
{
$this->cm->setChangeTrackingPolicy(ClassMetadata::CHANGETRACKING_DEFERRED_EXPLICIT);
return $this;
}
/**
2012-12-03 13:36:08 +04:00
* Sets notify change tracking policy.
*
* @return ClassMetadataBuilder
*/
public function setChangeTrackingPolicyNotify()
{
$this->cm->setChangeTrackingPolicy(ClassMetadata::CHANGETRACKING_NOTIFY);
return $this;
}
/**
2012-12-03 13:36:08 +04:00
* Adds lifecycle event.
*
* @param string $methodName
* @param string $event
2012-12-03 13:36:08 +04:00
*
* @return ClassMetadataBuilder
*/
public function addLifecycleEvent($methodName, $event)
{
$this->cm->addLifecycleCallback($methodName, $event);
return $this;
}
/**
2012-12-03 13:36:08 +04:00
* Adds Field.
*
* @param string $name
* @param string $type
2012-12-03 13:36:08 +04:00
* @param array $mapping
*
* @return ClassMetadataBuilder
*/
public function addField($name, $type, array $mapping = array())
{
$mapping['fieldName'] = $name;
$mapping['type'] = $type;
$this->cm->mapField($mapping);
return $this;
}
/**
2012-12-03 13:36:08 +04:00
* Creates a field builder.
*
* @param string $name
* @param string $type
2012-12-03 13:36:08 +04:00
*
* @return FieldBuilder
*/
public function createField($name, $type)
{
return new FieldBuilder(
$this,
array(
'fieldName' => $name,
'type' => $type
)
);
}
/**
2012-12-03 13:36:08 +04:00
* Adds a simple many to one association, optionally with the inversed by field.
*
2012-12-03 13:36:08 +04:00
* @param string $name
* @param string $targetEntity
* @param string|null $inversedBy
2012-12-03 13:36:08 +04:00
*
* @return ClassMetadataBuilder
*/
public function addManyToOne($name, $targetEntity, $inversedBy = null)
{
$builder = $this->createManyToOne($name, $targetEntity);
if ($inversedBy) {
$builder->inversedBy($inversedBy);
}
return $builder->build();
}
/**
2012-12-03 13:36:08 +04:00
* Creates a ManyToOne Assocation Builder.
*
* Note: This method does not add the association, you have to call build() on the AssociationBuilder.
*
* @param string $name
* @param string $targetEntity
2012-12-03 13:36:08 +04:00
*
* @return AssociationBuilder
*/
public function createManyToOne($name, $targetEntity)
{
return new AssociationBuilder(
$this,
array(
'fieldName' => $name,
'targetEntity' => $targetEntity
),
ClassMetadata::MANY_TO_ONE
);
}
/**
2012-12-03 13:36:08 +04:00
* Creates a OneToOne Association Builder.
*
* @param string $name
* @param string $targetEntity
2012-12-03 13:36:08 +04:00
*
* @return AssociationBuilder
*/
public function createOneToOne($name, $targetEntity)
{
return new AssociationBuilder(
$this,
array(
'fieldName' => $name,
'targetEntity' => $targetEntity
),
ClassMetadata::ONE_TO_ONE
);
}
/**
2012-12-03 13:36:08 +04:00
* Adds simple inverse one-to-one assocation.
*
* @param string $name
* @param string $targetEntity
* @param string $mappedBy
2012-12-03 13:36:08 +04:00
*
* @return ClassMetadataBuilder
*/
public function addInverseOneToOne($name, $targetEntity, $mappedBy)
{
$builder = $this->createOneToOne($name, $targetEntity);
$builder->mappedBy($mappedBy);
return $builder->build();
}
/**
2012-12-03 13:36:08 +04:00
* Adds simple owning one-to-one assocation.
*
* @param string $name
* @param string $targetEntity
* @param string|null $inversedBy
*
* @return ClassMetadataBuilder
*/
public function addOwningOneToOne($name, $targetEntity, $inversedBy = null)
{
$builder = $this->createOneToOne($name, $targetEntity);
if ($inversedBy) {
$builder->inversedBy($inversedBy);
}
return $builder->build();
}
/**
2012-12-03 13:36:08 +04:00
* Creates a ManyToMany Assocation Builder.
*
* @param string $name
* @param string $targetEntity
2012-12-03 13:36:08 +04:00
*
* @return ManyToManyAssociationBuilder
*/
public function createManyToMany($name, $targetEntity)
{
return new ManyToManyAssociationBuilder(
$this,
array(
'fieldName' => $name,
'targetEntity' => $targetEntity
),
ClassMetadata::MANY_TO_MANY
);
}
/**
2012-12-03 13:36:08 +04:00
* Adds a simple owning many to many assocation.
*
2012-12-03 13:36:08 +04:00
* @param string $name
* @param string $targetEntity
* @param string|null $inversedBy
2012-12-03 13:36:08 +04:00
*
* @return ClassMetadataBuilder
*/
public function addOwningManyToMany($name, $targetEntity, $inversedBy = null)
{
$builder = $this->createManyToMany($name, $targetEntity);
if ($inversedBy) {
$builder->inversedBy($inversedBy);
}
return $builder->build();
}
/**
2012-12-03 13:36:08 +04:00
* Adds a simple inverse many to many assocation.
*
* @param string $name
* @param string $targetEntity
* @param string $mappedBy
2012-12-03 13:36:08 +04:00
*
* @return ClassMetadataBuilder
*/
public function addInverseManyToMany($name, $targetEntity, $mappedBy)
{
$builder = $this->createManyToMany($name, $targetEntity);
$builder->mappedBy($mappedBy);
return $builder->build();
}
/**
2012-12-03 13:36:08 +04:00
* Creates a one to many assocation builder.
*
* @param string $name
* @param string $targetEntity
2012-12-03 13:36:08 +04:00
*
* @return OneToManyAssociationBuilder
*/
public function createOneToMany($name, $targetEntity)
{
return new OneToManyAssociationBuilder(
$this,
array(
'fieldName' => $name,
'targetEntity' => $targetEntity
),
ClassMetadata::ONE_TO_MANY
);
}
/**
2012-12-03 13:36:08 +04:00
* Adds simple OneToMany assocation.
*
* @param string $name
* @param string $targetEntity
* @param string $mappedBy
2012-12-03 13:36:08 +04:00
*
* @return ClassMetadataBuilder
*/
public function addOneToMany($name, $targetEntity, $mappedBy)
{
$builder = $this->createOneToMany($name, $targetEntity);
$builder->mappedBy($mappedBy);
return $builder->build();
2011-09-04 12:08:33 +04:00
}
}