3318 lines
102 KiB
PHP
3318 lines
102 KiB
PHP
<?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
|
||
* and is licensed under the MIT license. For more information, see
|
||
* <http://www.doctrine-project.org>.
|
||
*/
|
||
|
||
namespace Doctrine\ORM\Mapping;
|
||
|
||
use BadMethodCallException;
|
||
use Doctrine\Instantiator\Instantiator;
|
||
use InvalidArgumentException;
|
||
use RuntimeException;
|
||
use Doctrine\DBAL\Types\Type;
|
||
use Doctrine\DBAL\Platforms\AbstractPlatform;
|
||
use ReflectionClass;
|
||
use Doctrine\Common\Persistence\Mapping\ClassMetadata;
|
||
use Doctrine\Common\ClassLoader;
|
||
|
||
/**
|
||
* A <tt>ClassMetadata</tt> instance holds all the object-relational mapping metadata
|
||
* of an entity and its associations.
|
||
*
|
||
* Once populated, ClassMetadata instances are usually cached in a serialized form.
|
||
*
|
||
* <b>IMPORTANT NOTE:</b>
|
||
*
|
||
* The fields of this class are only public for 2 reasons:
|
||
* 1) To allow fast 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).
|
||
*
|
||
* @author Roman Borschel <roman@code-factory.org>
|
||
* @author Jonathan H. Wage <jonwage@gmail.com>
|
||
* @since 2.0
|
||
*/
|
||
class ClassMetadataInfo implements ClassMetadata
|
||
{
|
||
/* The inheritance mapping types */
|
||
/**
|
||
* NONE means the class does not participate in an inheritance hierarchy
|
||
* and therefore does not need an inheritance mapping type.
|
||
*/
|
||
const INHERITANCE_TYPE_NONE = 1;
|
||
|
||
/**
|
||
* JOINED means the class will be persisted according to the rules of
|
||
* <tt>Class Table Inheritance</tt>.
|
||
*/
|
||
const INHERITANCE_TYPE_JOINED = 2;
|
||
|
||
/**
|
||
* SINGLE_TABLE means the class will be persisted according to the rules of
|
||
* <tt>Single Table Inheritance</tt>.
|
||
*/
|
||
const INHERITANCE_TYPE_SINGLE_TABLE = 3;
|
||
|
||
/**
|
||
* TABLE_PER_CLASS means the class will be persisted according to the rules
|
||
* of <tt>Concrete Table Inheritance</tt>.
|
||
*/
|
||
const INHERITANCE_TYPE_TABLE_PER_CLASS = 4;
|
||
|
||
/* The Id generator types. */
|
||
/**
|
||
* AUTO means the generator type will depend on what the used platform prefers.
|
||
* Offers full portability.
|
||
*/
|
||
const GENERATOR_TYPE_AUTO = 1;
|
||
|
||
/**
|
||
* SEQUENCE means a separate sequence object will be used. Platforms that do
|
||
* not have native sequence support may emulate it. Full portability is currently
|
||
* not guaranteed.
|
||
*/
|
||
const GENERATOR_TYPE_SEQUENCE = 2;
|
||
|
||
/**
|
||
* TABLE means a separate table is used for id generation.
|
||
* Offers full portability.
|
||
*/
|
||
const GENERATOR_TYPE_TABLE = 3;
|
||
|
||
/**
|
||
* IDENTITY means an identity column is used for id generation. The database
|
||
* will fill in the id column on insertion. Platforms that do not support
|
||
* native identity columns may emulate them. Full portability is currently
|
||
* not guaranteed.
|
||
*/
|
||
const GENERATOR_TYPE_IDENTITY = 4;
|
||
|
||
/**
|
||
* NONE means the class does not have a generated id. That means the class
|
||
* must have a natural, manually assigned id.
|
||
*/
|
||
const GENERATOR_TYPE_NONE = 5;
|
||
|
||
/**
|
||
* UUID means that a UUID/GUID expression is used for id generation. Full
|
||
* portability is currently not guaranteed.
|
||
*/
|
||
const GENERATOR_TYPE_UUID = 6;
|
||
|
||
/**
|
||
* CUSTOM means that customer will use own ID generator that supposedly work
|
||
*/
|
||
const GENERATOR_TYPE_CUSTOM = 7;
|
||
|
||
/**
|
||
* DEFERRED_IMPLICIT means that changes of entities are calculated at commit-time
|
||
* by doing a property-by-property comparison with the original data. This will
|
||
* be done for all entities that are in MANAGED state at commit-time.
|
||
*
|
||
* This is the default change tracking policy.
|
||
*/
|
||
const CHANGETRACKING_DEFERRED_IMPLICIT = 1;
|
||
|
||
/**
|
||
* DEFERRED_EXPLICIT means that changes of entities are calculated at commit-time
|
||
* by doing a property-by-property comparison with the original data. This will
|
||
* be done only for entities that were explicitly saved (through persist() or a cascade).
|
||
*/
|
||
const CHANGETRACKING_DEFERRED_EXPLICIT = 2;
|
||
|
||
/**
|
||
* NOTIFY means that Doctrine relies on the entities sending out notifications
|
||
* when their properties change. Such entity classes must implement
|
||
* the <tt>NotifyPropertyChanged</tt> interface.
|
||
*/
|
||
const CHANGETRACKING_NOTIFY = 3;
|
||
|
||
/**
|
||
* Specifies that an association is to be fetched when it is first accessed.
|
||
*/
|
||
const FETCH_LAZY = 2;
|
||
|
||
/**
|
||
* Specifies that an association is to be fetched when the owner of the
|
||
* association is fetched.
|
||
*/
|
||
const FETCH_EAGER = 3;
|
||
|
||
/**
|
||
* Specifies that an association is to be fetched lazy (on first access) and that
|
||
* commands such as Collection#count, Collection#slice are issued directly against
|
||
* the database if the collection is not yet initialized.
|
||
*/
|
||
const FETCH_EXTRA_LAZY = 4;
|
||
|
||
/**
|
||
* Identifies a one-to-one association.
|
||
*/
|
||
const ONE_TO_ONE = 1;
|
||
|
||
/**
|
||
* Identifies a many-to-one association.
|
||
*/
|
||
const MANY_TO_ONE = 2;
|
||
|
||
/**
|
||
* Identifies a one-to-many association.
|
||
*/
|
||
const ONE_TO_MANY = 4;
|
||
|
||
/**
|
||
* Identifies a many-to-many association.
|
||
*/
|
||
const MANY_TO_MANY = 8;
|
||
|
||
/**
|
||
* Combined bitmask for to-one (single-valued) associations.
|
||
*/
|
||
const TO_ONE = 3;
|
||
|
||
/**
|
||
* Combined bitmask for to-many (collection-valued) associations.
|
||
*/
|
||
const TO_MANY = 12;
|
||
|
||
/**
|
||
* ReadOnly cache can do reads, inserts and deletes, cannot perform updates or employ any locks,
|
||
*/
|
||
const CACHE_USAGE_READ_ONLY = 1;
|
||
|
||
/**
|
||
* Nonstrict Read Write Cache doesn’t employ any locks but can do inserts, update and deletes.
|
||
*/
|
||
const CACHE_USAGE_NONSTRICT_READ_WRITE = 2;
|
||
|
||
/**
|
||
* Read Write Attempts to lock the entity before update/delete.
|
||
*/
|
||
const CACHE_USAGE_READ_WRITE = 3;
|
||
|
||
/**
|
||
* READ-ONLY: The name of the entity class.
|
||
*
|
||
* @var string
|
||
*/
|
||
public $name;
|
||
|
||
/**
|
||
* READ-ONLY: The namespace the entity class is contained in.
|
||
*
|
||
* @var string
|
||
*
|
||
* @todo Not really needed. Usage could be localized.
|
||
*/
|
||
public $namespace;
|
||
|
||
/**
|
||
* READ-ONLY: The name of the entity class that is at the root of the mapped entity inheritance
|
||
* hierarchy. If the entity is not part of a mapped inheritance hierarchy this is the same
|
||
* as {@link $entityName}.
|
||
*
|
||
* @var string
|
||
*/
|
||
public $rootEntityName;
|
||
|
||
/**
|
||
* READ-ONLY: The definition of custom generator. Only used for CUSTOM
|
||
* generator type
|
||
*
|
||
* The definition has the following structure:
|
||
* <code>
|
||
* array(
|
||
* 'class' => 'ClassName',
|
||
* )
|
||
* </code>
|
||
*
|
||
* @var array
|
||
*
|
||
* @todo Merge with tableGeneratorDefinition into generic generatorDefinition
|
||
*/
|
||
public $customGeneratorDefinition;
|
||
|
||
/**
|
||
* The name of the custom repository class used for the entity class.
|
||
* (Optional).
|
||
*
|
||
* @var string
|
||
*/
|
||
public $customRepositoryClassName;
|
||
|
||
/**
|
||
* READ-ONLY: Whether this class describes the mapping of a mapped superclass.
|
||
*
|
||
* @var boolean
|
||
*/
|
||
public $isMappedSuperclass = false;
|
||
|
||
/**
|
||
* READ-ONLY: Whether this class describes the mapping of an embeddable class.
|
||
*
|
||
* @var boolean
|
||
*/
|
||
public $isEmbeddedClass = false;
|
||
|
||
/**
|
||
* READ-ONLY: The names of the parent classes (ancestors).
|
||
*
|
||
* @var array
|
||
*/
|
||
public $parentClasses = array();
|
||
|
||
/**
|
||
* READ-ONLY: The names of all subclasses (descendants).
|
||
*
|
||
* @var array
|
||
*/
|
||
public $subClasses = array();
|
||
|
||
/**
|
||
* READ-ONLY: The names of all embedded classes based on properties.
|
||
*
|
||
* @var array
|
||
*/
|
||
public $embeddedClasses = array();
|
||
|
||
/**
|
||
* READ-ONLY: The named queries allowed to be called directly from Repository.
|
||
*
|
||
* @var array
|
||
*/
|
||
public $namedQueries = array();
|
||
|
||
/**
|
||
* READ-ONLY: The named native queries allowed to be called directly from Repository.
|
||
*
|
||
* A native SQL named query definition has the following structure:
|
||
* <pre>
|
||
* array(
|
||
* 'name' => <query name>,
|
||
* 'query' => <sql query>,
|
||
* 'resultClass' => <class of the result>,
|
||
* 'resultSetMapping' => <name of a SqlResultSetMapping>
|
||
* )
|
||
* </pre>
|
||
*
|
||
* @var array
|
||
*/
|
||
public $namedNativeQueries = array();
|
||
|
||
/**
|
||
* READ-ONLY: The mappings of the results of native SQL queries.
|
||
*
|
||
* A native result mapping definition has the following structure:
|
||
* <pre>
|
||
* array(
|
||
* 'name' => <result name>,
|
||
* 'entities' => array(<entity result mapping>),
|
||
* 'columns' => array(<column result mapping>)
|
||
* )
|
||
* </pre>
|
||
*
|
||
* @var array
|
||
*/
|
||
public $sqlResultSetMappings = array();
|
||
|
||
/**
|
||
* READ-ONLY: The field names of all fields that are part of the identifier/primary key
|
||
* of the mapped entity class.
|
||
*
|
||
* @var array
|
||
*/
|
||
public $identifier = array();
|
||
|
||
/**
|
||
* READ-ONLY: The inheritance mapping type used by the class.
|
||
*
|
||
* @var integer
|
||
*/
|
||
public $inheritanceType = self::INHERITANCE_TYPE_NONE;
|
||
|
||
/**
|
||
* READ-ONLY: The Id generator type used by the class.
|
||
*
|
||
* @var int
|
||
*/
|
||
public $generatorType = self::GENERATOR_TYPE_NONE;
|
||
|
||
/**
|
||
* READ-ONLY: The field mappings of the class.
|
||
* Keys are field names and values are mapping definitions.
|
||
*
|
||
* The mapping definition array has the following values:
|
||
*
|
||
* - <b>fieldName</b> (string)
|
||
* The name of the field in the Entity.
|
||
*
|
||
* - <b>type</b> (string)
|
||
* The type name of the mapped field. Can be one of Doctrine's mapping types
|
||
* or a custom mapping type.
|
||
*
|
||
* - <b>columnName</b> (string, optional)
|
||
* The column name. Optional. Defaults to the field name.
|
||
*
|
||
* - <b>length</b> (integer, optional)
|
||
* The database length of the column. Optional. Default value taken from
|
||
* the type.
|
||
*
|
||
* - <b>id</b> (boolean, optional)
|
||
* Marks the field as the primary key of the entity. Multiple fields of an
|
||
* entity can have the id attribute, forming a composite key.
|
||
*
|
||
* - <b>nullable</b> (boolean, optional)
|
||
* Whether the column is nullable. Defaults to FALSE.
|
||
*
|
||
* - <b>columnDefinition</b> (string, optional, schema-only)
|
||
* The SQL fragment that is used when generating the DDL for the column.
|
||
*
|
||
* - <b>precision</b> (integer, optional, schema-only)
|
||
* The precision of a decimal column. Only valid if the column type is decimal.
|
||
*
|
||
* - <b>scale</b> (integer, optional, schema-only)
|
||
* The scale of a decimal column. Only valid if the column type is decimal.
|
||
*
|
||
* - <b>'unique'</b> (string, optional, schema-only)
|
||
* Whether a unique constraint should be generated for the column.
|
||
*
|
||
* @var array
|
||
*/
|
||
public $fieldMappings = array();
|
||
|
||
/**
|
||
* READ-ONLY: An array of field names. Used to look up field names from column names.
|
||
* Keys are column names and values are field names.
|
||
* This is the reverse lookup map of $_columnNames.
|
||
*
|
||
* @var array
|
||
*/
|
||
public $fieldNames = array();
|
||
|
||
/**
|
||
* READ-ONLY: A map of field names to column names. Keys are field names and values column names.
|
||
* Used to look up column names from field names.
|
||
* This is the reverse lookup map of $_fieldNames.
|
||
*
|
||
* @var array
|
||
*
|
||
* @todo We could get rid of this array by just using $fieldMappings[$fieldName]['columnName'].
|
||
*/
|
||
public $columnNames = array();
|
||
|
||
/**
|
||
* READ-ONLY: The discriminator value of this class.
|
||
*
|
||
* <b>This does only apply to the JOINED and SINGLE_TABLE inheritance mapping strategies
|
||
* where a discriminator column is used.</b>
|
||
*
|
||
* @var mixed
|
||
*
|
||
* @see discriminatorColumn
|
||
*/
|
||
public $discriminatorValue;
|
||
|
||
/**
|
||
* READ-ONLY: The discriminator map of all mapped classes in the hierarchy.
|
||
*
|
||
* <b>This does only apply to the JOINED and SINGLE_TABLE inheritance mapping strategies
|
||
* where a discriminator column is used.</b>
|
||
*
|
||
* @var mixed
|
||
*
|
||
* @see discriminatorColumn
|
||
*/
|
||
public $discriminatorMap = array();
|
||
|
||
/**
|
||
* READ-ONLY: The definition of the discriminator column used in JOINED and SINGLE_TABLE
|
||
* inheritance mappings.
|
||
*
|
||
* @var array
|
||
*/
|
||
public $discriminatorColumn;
|
||
|
||
/**
|
||
* READ-ONLY: The primary table definition. The definition is an array with the
|
||
* following entries:
|
||
*
|
||
* name => <tableName>
|
||
* schema => <schemaName>
|
||
* indexes => array
|
||
* uniqueConstraints => array
|
||
*
|
||
* @var array
|
||
*/
|
||
public $table;
|
||
|
||
/**
|
||
* READ-ONLY: The registered lifecycle callbacks for entities of this class.
|
||
*
|
||
* @var array
|
||
*/
|
||
public $lifecycleCallbacks = array();
|
||
|
||
/**
|
||
* READ-ONLY: The registered entity listeners.
|
||
*
|
||
* @var array
|
||
*/
|
||
public $entityListeners = array();
|
||
|
||
/**
|
||
* READ-ONLY: The association mappings of this class.
|
||
*
|
||
* The mapping definition array supports the following keys:
|
||
*
|
||
* - <b>fieldName</b> (string)
|
||
* The name of the field in the entity the association is mapped to.
|
||
*
|
||
* - <b>targetEntity</b> (string)
|
||
* The class name of the target entity. If it is fully-qualified it is used as is.
|
||
* If it is a simple, unqualified class name the namespace is assumed to be the same
|
||
* as the namespace of the source entity.
|
||
*
|
||
* - <b>mappedBy</b> (string, required for bidirectional associations)
|
||
* The name of the field that completes the bidirectional association on the owning side.
|
||
* This key must be specified on the inverse side of a bidirectional association.
|
||
*
|
||
* - <b>inversedBy</b> (string, required for bidirectional associations)
|
||
* The name of the field that completes the bidirectional association on the inverse side.
|
||
* This key must be specified on the owning side of a bidirectional association.
|
||
*
|
||
* - <b>cascade</b> (array, optional)
|
||
* The names of persistence operations to cascade on the association. The set of possible
|
||
* values are: "persist", "remove", "detach", "merge", "refresh", "all" (implies all others).
|
||
*
|
||
* - <b>orderBy</b> (array, one-to-many/many-to-many only)
|
||
* A map of field names (of the target entity) to sorting directions (ASC/DESC).
|
||
* Example: array('priority' => 'desc')
|
||
*
|
||
* - <b>fetch</b> (integer, optional)
|
||
* The fetching strategy to use for the association, usually defaults to FETCH_LAZY.
|
||
* Possible values are: ClassMetadata::FETCH_EAGER, ClassMetadata::FETCH_LAZY.
|
||
*
|
||
* - <b>joinTable</b> (array, optional, many-to-many only)
|
||
* Specification of the join table and its join columns (foreign keys).
|
||
* Only valid for many-to-many mappings. Note that one-to-many associations can be mapped
|
||
* through a join table by simply mapping the association as many-to-many with a unique
|
||
* constraint on the join table.
|
||
*
|
||
* - <b>indexBy</b> (string, optional, to-many only)
|
||
* Specification of a field on target-entity that is used to index the collection by.
|
||
* This field HAS to be either the primary key or a unique column. Otherwise the collection
|
||
* does not contain all the entities that are actually related.
|
||
*
|
||
* A join table definition has the following structure:
|
||
* <pre>
|
||
* array(
|
||
* 'name' => <join table name>,
|
||
* 'joinColumns' => array(<join column mapping from join table to source table>),
|
||
* 'inverseJoinColumns' => array(<join column mapping from join table to target table>)
|
||
* )
|
||
* </pre>
|
||
*
|
||
* @var array
|
||
*/
|
||
public $associationMappings = array();
|
||
|
||
/**
|
||
* READ-ONLY: Flag indicating whether the identifier/primary key of the class is composite.
|
||
*
|
||
* @var boolean
|
||
*/
|
||
public $isIdentifierComposite = false;
|
||
|
||
/**
|
||
* READ-ONLY: Flag indicating whether the identifier/primary key contains at least one foreign key association.
|
||
*
|
||
* This flag is necessary because some code blocks require special treatment of this cases.
|
||
*
|
||
* @var boolean
|
||
*/
|
||
public $containsForeignIdentifier = false;
|
||
|
||
/**
|
||
* READ-ONLY: The ID generator used for generating IDs for this class.
|
||
*
|
||
* @var \Doctrine\ORM\Id\AbstractIdGenerator
|
||
*
|
||
* @todo Remove!
|
||
*/
|
||
public $idGenerator;
|
||
|
||
/**
|
||
* READ-ONLY: The definition of the sequence generator of this class. Only used for the
|
||
* SEQUENCE generation strategy.
|
||
*
|
||
* The definition has the following structure:
|
||
* <code>
|
||
* array(
|
||
* 'sequenceName' => 'name',
|
||
* 'allocationSize' => 20,
|
||
* 'initialValue' => 1
|
||
* )
|
||
* </code>
|
||
*
|
||
* @var array
|
||
*
|
||
* @todo Merge with tableGeneratorDefinition into generic generatorDefinition
|
||
*/
|
||
public $sequenceGeneratorDefinition;
|
||
|
||
/**
|
||
* READ-ONLY: The definition of the table generator of this class. Only used for the
|
||
* TABLE generation strategy.
|
||
*
|
||
* @var array
|
||
*
|
||
* @todo Merge with tableGeneratorDefinition into generic generatorDefinition
|
||
*/
|
||
public $tableGeneratorDefinition;
|
||
|
||
/**
|
||
* READ-ONLY: The policy used for change-tracking on entities of this class.
|
||
*
|
||
* @var integer
|
||
*/
|
||
public $changeTrackingPolicy = self::CHANGETRACKING_DEFERRED_IMPLICIT;
|
||
|
||
/**
|
||
* READ-ONLY: A flag for whether or not instances of this class are to be versioned
|
||
* with optimistic locking.
|
||
*
|
||
* @var boolean
|
||
*/
|
||
public $isVersioned;
|
||
|
||
/**
|
||
* READ-ONLY: The name of the field which is used for versioning in optimistic locking (if any).
|
||
*
|
||
* @var mixed
|
||
*/
|
||
public $versionField;
|
||
|
||
/**
|
||
* @var array
|
||
*/
|
||
public $cache = null;
|
||
|
||
/**
|
||
* The ReflectionClass instance of the mapped class.
|
||
*
|
||
* @var ReflectionClass
|
||
*/
|
||
public $reflClass;
|
||
|
||
/**
|
||
* Is this entity marked as "read-only"?
|
||
*
|
||
* That means it is never considered for change-tracking in the UnitOfWork. It is a very helpful performance
|
||
* optimization for entities that are immutable, either in your domain or through the relation database
|
||
* (coming from a view, or a history table for example).
|
||
*
|
||
* @var bool
|
||
*/
|
||
public $isReadOnly = false;
|
||
|
||
/**
|
||
* NamingStrategy determining the default column and table names.
|
||
*
|
||
* @var \Doctrine\ORM\Mapping\NamingStrategy
|
||
*/
|
||
protected $namingStrategy;
|
||
|
||
/**
|
||
* The ReflectionProperty instances of the mapped class.
|
||
*
|
||
* @var \ReflectionProperty[]
|
||
*/
|
||
public $reflFields = array();
|
||
|
||
/**
|
||
* @var \Doctrine\Instantiator\InstantiatorInterface|null
|
||
*/
|
||
private $instantiator;
|
||
|
||
/**
|
||
* Initializes a new ClassMetadata instance that will hold the object-relational mapping
|
||
* metadata of the class with the given name.
|
||
*
|
||
* @param string $entityName The name of the entity class the new instance is used for.
|
||
* @param NamingStrategy|null $namingStrategy
|
||
*/
|
||
public function __construct($entityName, NamingStrategy $namingStrategy = null)
|
||
{
|
||
$this->name = $entityName;
|
||
$this->rootEntityName = $entityName;
|
||
$this->namingStrategy = $namingStrategy ?: new DefaultNamingStrategy();
|
||
$this->instantiator = new Instantiator();
|
||
}
|
||
|
||
/**
|
||
* Gets the ReflectionProperties of the mapped class.
|
||
*
|
||
* @return array An array of ReflectionProperty instances.
|
||
*/
|
||
public function getReflectionProperties()
|
||
{
|
||
return $this->reflFields;
|
||
}
|
||
|
||
/**
|
||
* Gets a ReflectionProperty for a specific field of the mapped class.
|
||
*
|
||
* @param string $name
|
||
*
|
||
* @return \ReflectionProperty
|
||
*/
|
||
public function getReflectionProperty($name)
|
||
{
|
||
return $this->reflFields[$name];
|
||
}
|
||
|
||
/**
|
||
* Gets the ReflectionProperty for the single identifier field.
|
||
*
|
||
* @return \ReflectionProperty
|
||
*
|
||
* @throws BadMethodCallException If the class has a composite identifier.
|
||
*/
|
||
public function getSingleIdReflectionProperty()
|
||
{
|
||
if ($this->isIdentifierComposite) {
|
||
throw new BadMethodCallException("Class " . $this->name . " has a composite identifier.");
|
||
}
|
||
return $this->reflFields[$this->identifier[0]];
|
||
}
|
||
|
||
/**
|
||
* Extracts the identifier values of an entity of this class.
|
||
*
|
||
* For composite identifiers, the identifier values are returned as an array
|
||
* with the same order as the field order in {@link identifier}.
|
||
*
|
||
* @param object $entity
|
||
*
|
||
* @return array
|
||
*/
|
||
public function getIdentifierValues($entity)
|
||
{
|
||
if ($this->isIdentifierComposite) {
|
||
$id = array();
|
||
|
||
foreach ($this->identifier as $idField) {
|
||
$value = $this->reflFields[$idField]->getValue($entity);
|
||
|
||
if ($value !== null) {
|
||
$id[$idField] = $value;
|
||
}
|
||
}
|
||
|
||
return $id;
|
||
}
|
||
|
||
$id = $this->identifier[0];
|
||
$value = $this->reflFields[$id]->getValue($entity);
|
||
|
||
if (null === $value) {
|
||
return array();
|
||
}
|
||
|
||
return array($id => $value);
|
||
}
|
||
|
||
/**
|
||
* Populates the entity identifier of an entity.
|
||
*
|
||
* @param object $entity
|
||
* @param mixed $id
|
||
*
|
||
* @return void
|
||
*
|
||
* @todo Rename to assignIdentifier()
|
||
*/
|
||
public function setIdentifierValues($entity, array $id)
|
||
{
|
||
foreach ($id as $idField => $idValue) {
|
||
$this->reflFields[$idField]->setValue($entity, $idValue);
|
||
}
|
||
}
|
||
|
||
/**
|
||
* Sets the specified field to the specified value on the given entity.
|
||
*
|
||
* @param object $entity
|
||
* @param string $field
|
||
* @param mixed $value
|
||
*
|
||
* @return void
|
||
*/
|
||
public function setFieldValue($entity, $field, $value)
|
||
{
|
||
$this->reflFields[$field]->setValue($entity, $value);
|
||
}
|
||
|
||
/**
|
||
* Gets the specified field's value off the given entity.
|
||
*
|
||
* @param object $entity
|
||
* @param string $field
|
||
*
|
||
* @return mixed
|
||
*/
|
||
public function getFieldValue($entity, $field)
|
||
{
|
||
return $this->reflFields[$field]->getValue($entity);
|
||
}
|
||
|
||
/**
|
||
* Creates a string representation of this instance.
|
||
*
|
||
* @return string The string representation of this instance.
|
||
*
|
||
* @todo Construct meaningful string representation.
|
||
*/
|
||
public function __toString()
|
||
{
|
||
return __CLASS__ . '@' . spl_object_hash($this);
|
||
}
|
||
|
||
/**
|
||
* Determines which fields get serialized.
|
||
*
|
||
* It is only serialized what is necessary for best unserialization performance.
|
||
* That means any metadata properties that are not set or empty or simply have
|
||
* their default value are NOT serialized.
|
||
*
|
||
* Parts that are also NOT serialized because they can not be properly unserialized:
|
||
* - reflClass (ReflectionClass)
|
||
* - reflFields (ReflectionProperty array)
|
||
*
|
||
* @return array The names of all the fields that should be serialized.
|
||
*/
|
||
public function __sleep()
|
||
{
|
||
// This metadata is always serialized/cached.
|
||
$serialized = array(
|
||
'associationMappings',
|
||
'columnNames', //TODO: Not really needed. Can use fieldMappings[$fieldName]['columnName']
|
||
'fieldMappings',
|
||
'fieldNames',
|
||
'embeddedClasses',
|
||
'identifier',
|
||
'isIdentifierComposite', // TODO: REMOVE
|
||
'name',
|
||
'namespace', // TODO: REMOVE
|
||
'table',
|
||
'rootEntityName',
|
||
'idGenerator', //TODO: Does not really need to be serialized. Could be moved to runtime.
|
||
);
|
||
|
||
// The rest of the metadata is only serialized if necessary.
|
||
if ($this->changeTrackingPolicy != self::CHANGETRACKING_DEFERRED_IMPLICIT) {
|
||
$serialized[] = 'changeTrackingPolicy';
|
||
}
|
||
|
||
if ($this->customRepositoryClassName) {
|
||
$serialized[] = 'customRepositoryClassName';
|
||
}
|
||
|
||
if ($this->inheritanceType != self::INHERITANCE_TYPE_NONE) {
|
||
$serialized[] = 'inheritanceType';
|
||
$serialized[] = 'discriminatorColumn';
|
||
$serialized[] = 'discriminatorValue';
|
||
$serialized[] = 'discriminatorMap';
|
||
$serialized[] = 'parentClasses';
|
||
$serialized[] = 'subClasses';
|
||
}
|
||
|
||
if ($this->generatorType != self::GENERATOR_TYPE_NONE) {
|
||
$serialized[] = 'generatorType';
|
||
if ($this->generatorType == self::GENERATOR_TYPE_SEQUENCE) {
|
||
$serialized[] = 'sequenceGeneratorDefinition';
|
||
}
|
||
}
|
||
|
||
if ($this->isMappedSuperclass) {
|
||
$serialized[] = 'isMappedSuperclass';
|
||
}
|
||
|
||
if ($this->isEmbeddedClass) {
|
||
$serialized[] = 'isEmbeddedClass';
|
||
}
|
||
|
||
if ($this->containsForeignIdentifier) {
|
||
$serialized[] = 'containsForeignIdentifier';
|
||
}
|
||
|
||
if ($this->isVersioned) {
|
||
$serialized[] = 'isVersioned';
|
||
$serialized[] = 'versionField';
|
||
}
|
||
|
||
if ($this->lifecycleCallbacks) {
|
||
$serialized[] = 'lifecycleCallbacks';
|
||
}
|
||
|
||
if ($this->entityListeners) {
|
||
$serialized[] = 'entityListeners';
|
||
}
|
||
|
||
if ($this->namedQueries) {
|
||
$serialized[] = 'namedQueries';
|
||
}
|
||
|
||
if ($this->namedNativeQueries) {
|
||
$serialized[] = 'namedNativeQueries';
|
||
}
|
||
|
||
if ($this->sqlResultSetMappings) {
|
||
$serialized[] = 'sqlResultSetMappings';
|
||
}
|
||
|
||
if ($this->isReadOnly) {
|
||
$serialized[] = 'isReadOnly';
|
||
}
|
||
|
||
if ($this->customGeneratorDefinition) {
|
||
$serialized[] = "customGeneratorDefinition";
|
||
}
|
||
|
||
if ($this->cache) {
|
||
$serialized[] = 'cache';
|
||
}
|
||
|
||
return $serialized;
|
||
}
|
||
|
||
/**
|
||
* Creates a new instance of the mapped class, without invoking the constructor.
|
||
*
|
||
* @return object
|
||
*/
|
||
public function newInstance()
|
||
{
|
||
return $this->instantiator->instantiate($this->name);
|
||
}
|
||
|
||
/**
|
||
* Restores some state that can not be serialized/unserialized.
|
||
*
|
||
* @param \Doctrine\Common\Persistence\Mapping\ReflectionService $reflService
|
||
*
|
||
* @return void
|
||
*/
|
||
public function wakeupReflection($reflService)
|
||
{
|
||
// Restore ReflectionClass and properties
|
||
$this->reflClass = $reflService->getClass($this->name);
|
||
$this->instantiator = $this->instantiator ?: new Instantiator();
|
||
|
||
$parentReflFields = array();
|
||
|
||
foreach ($this->embeddedClasses as $property => $embeddedClass) {
|
||
if (isset($embeddedClass['declaredField'])) {
|
||
$parentReflFields[$property] = new ReflectionEmbeddedProperty(
|
||
$parentReflFields[$embeddedClass['declaredField']],
|
||
$reflService->getAccessibleProperty(
|
||
$this->embeddedClasses[$embeddedClass['declaredField']]['class'],
|
||
$embeddedClass['originalField']
|
||
),
|
||
$this->embeddedClasses[$embeddedClass['declaredField']]['class']
|
||
);
|
||
|
||
continue;
|
||
}
|
||
|
||
$parentReflFields[$property] = $reflService->getAccessibleProperty($this->name, $property);
|
||
$this->reflFields[$property] = $reflService->getAccessibleProperty($this->name, $property);
|
||
}
|
||
|
||
foreach ($this->fieldMappings as $field => $mapping) {
|
||
if (isset($mapping['declaredField'])) {
|
||
$this->reflFields[$field] = new ReflectionEmbeddedProperty(
|
||
$parentReflFields[$mapping['declaredField']],
|
||
$reflService->getAccessibleProperty($mapping['originalClass'], $mapping['originalField']),
|
||
$mapping['originalClass']
|
||
);
|
||
continue;
|
||
}
|
||
|
||
$this->reflFields[$field] = isset($mapping['declared'])
|
||
? $reflService->getAccessibleProperty($mapping['declared'], $field)
|
||
: $reflService->getAccessibleProperty($this->name, $field);
|
||
}
|
||
|
||
foreach ($this->associationMappings as $field => $mapping) {
|
||
$this->reflFields[$field] = isset($mapping['declared'])
|
||
? $reflService->getAccessibleProperty($mapping['declared'], $field)
|
||
: $reflService->getAccessibleProperty($this->name, $field);
|
||
}
|
||
}
|
||
|
||
/**
|
||
* Initializes a new ClassMetadata instance that will hold the object-relational mapping
|
||
* metadata of the class with the given name.
|
||
*
|
||
* @param \Doctrine\Common\Persistence\Mapping\ReflectionService $reflService The reflection service.
|
||
*
|
||
* @return void
|
||
*/
|
||
public function initializeReflection($reflService)
|
||
{
|
||
$this->reflClass = $reflService->getClass($this->name);
|
||
$this->namespace = $reflService->getClassNamespace($this->name);
|
||
|
||
if ($this->reflClass) {
|
||
$this->name = $this->rootEntityName = $this->reflClass->getName();
|
||
}
|
||
|
||
$this->table['name'] = $this->namingStrategy->classToTableName($this->name);
|
||
}
|
||
|
||
/**
|
||
* Validates Identifier.
|
||
*
|
||
* @return void
|
||
*
|
||
* @throws MappingException
|
||
*/
|
||
public function validateIdentifier()
|
||
{
|
||
if ($this->isMappedSuperclass || $this->isEmbeddedClass) {
|
||
return;
|
||
}
|
||
|
||
// Verify & complete identifier mapping
|
||
if ( ! $this->identifier) {
|
||
throw MappingException::identifierRequired($this->name);
|
||
}
|
||
|
||
if ($this->usesIdGenerator() && $this->isIdentifierComposite) {
|
||
throw MappingException::compositeKeyAssignedIdGeneratorRequired($this->name);
|
||
}
|
||
}
|
||
|
||
/**
|
||
* Validates association targets actually exist.
|
||
*
|
||
* @return void
|
||
*
|
||
* @throws MappingException
|
||
*/
|
||
public function validateAssociations()
|
||
{
|
||
foreach ($this->associationMappings as $mapping) {
|
||
if ( ! ClassLoader::classExists($mapping['targetEntity']) ) {
|
||
throw MappingException::invalidTargetEntityClass($mapping['targetEntity'], $this->name, $mapping['fieldName']);
|
||
}
|
||
}
|
||
}
|
||
|
||
/**
|
||
* Validates lifecycle callbacks.
|
||
*
|
||
* @param \Doctrine\Common\Persistence\Mapping\ReflectionService $reflService
|
||
*
|
||
* @return void
|
||
*
|
||
* @throws MappingException
|
||
*/
|
||
public function validateLifecycleCallbacks($reflService)
|
||
{
|
||
foreach ($this->lifecycleCallbacks as $callbacks) {
|
||
foreach ($callbacks as $callbackFuncName) {
|
||
if ( ! $reflService->hasPublicMethod($this->name, $callbackFuncName)) {
|
||
throw MappingException::lifecycleCallbackMethodNotFound($this->name, $callbackFuncName);
|
||
}
|
||
}
|
||
}
|
||
}
|
||
|
||
/**
|
||
* {@inheritDoc}
|
||
*/
|
||
public function getReflectionClass()
|
||
{
|
||
return $this->reflClass;
|
||
}
|
||
|
||
/**
|
||
* @param array $cache
|
||
*
|
||
* @return void
|
||
*/
|
||
public function enableCache(array $cache)
|
||
{
|
||
if ( ! isset($cache['usage'])) {
|
||
$cache['usage'] = self::CACHE_USAGE_READ_ONLY;
|
||
}
|
||
|
||
if ( ! isset($cache['region'])) {
|
||
$cache['region'] = strtolower(str_replace('\\', '_', $this->rootEntityName));
|
||
}
|
||
|
||
$this->cache = $cache;
|
||
}
|
||
|
||
/**
|
||
* @param string $fieldName
|
||
* @param array $cache
|
||
*
|
||
* @return void
|
||
*/
|
||
public function enableAssociationCache($fieldName, array $cache)
|
||
{
|
||
if ( ! isset($cache['usage'])) {
|
||
$cache['usage'] = isset($this->cache['usage'])
|
||
? $this->cache['usage']
|
||
: self::CACHE_USAGE_READ_ONLY;
|
||
}
|
||
|
||
if ( ! isset($cache['region'])) {
|
||
$cache['region'] = strtolower(str_replace('\\', '_', $this->rootEntityName)) . '__' . $fieldName;
|
||
}
|
||
|
||
$this->associationMappings[$fieldName]['cache'] = $cache;
|
||
}
|
||
|
||
/**
|
||
* Sets the change tracking policy used by this class.
|
||
*
|
||
* @param integer $policy
|
||
*
|
||
* @return void
|
||
*/
|
||
public function setChangeTrackingPolicy($policy)
|
||
{
|
||
$this->changeTrackingPolicy = $policy;
|
||
}
|
||
|
||
/**
|
||
* Whether the change tracking policy of this class is "deferred explicit".
|
||
*
|
||
* @return boolean
|
||
*/
|
||
public function isChangeTrackingDeferredExplicit()
|
||
{
|
||
return $this->changeTrackingPolicy == self::CHANGETRACKING_DEFERRED_EXPLICIT;
|
||
}
|
||
|
||
/**
|
||
* Whether the change tracking policy of this class is "deferred implicit".
|
||
*
|
||
* @return boolean
|
||
*/
|
||
public function isChangeTrackingDeferredImplicit()
|
||
{
|
||
return $this->changeTrackingPolicy == self::CHANGETRACKING_DEFERRED_IMPLICIT;
|
||
}
|
||
|
||
/**
|
||
* Whether the change tracking policy of this class is "notify".
|
||
*
|
||
* @return boolean
|
||
*/
|
||
public function isChangeTrackingNotify()
|
||
{
|
||
return $this->changeTrackingPolicy == self::CHANGETRACKING_NOTIFY;
|
||
}
|
||
|
||
/**
|
||
* Checks whether a field is part of the identifier/primary key field(s).
|
||
*
|
||
* @param string $fieldName The field name.
|
||
*
|
||
* @return boolean TRUE if the field is part of the table identifier/primary key field(s),
|
||
* FALSE otherwise.
|
||
*/
|
||
public function isIdentifier($fieldName)
|
||
{
|
||
if ( ! $this->identifier) {
|
||
return false;
|
||
}
|
||
|
||
if ( ! $this->isIdentifierComposite) {
|
||
return $fieldName === $this->identifier[0];
|
||
}
|
||
|
||
return in_array($fieldName, $this->identifier);
|
||
}
|
||
|
||
/**
|
||
* Checks if the field is unique.
|
||
*
|
||
* @param string $fieldName The field name.
|
||
*
|
||
* @return boolean TRUE if the field is unique, FALSE otherwise.
|
||
*/
|
||
public function isUniqueField($fieldName)
|
||
{
|
||
$mapping = $this->getFieldMapping($fieldName);
|
||
if ($mapping !== false) {
|
||
return isset($mapping['unique']) && $mapping['unique'] == true;
|
||
}
|
||
return false;
|
||
}
|
||
|
||
/**
|
||
* Checks if the field is not null.
|
||
*
|
||
* @param string $fieldName The field name.
|
||
*
|
||
* @return boolean TRUE if the field is not null, FALSE otherwise.
|
||
*/
|
||
public function isNullable($fieldName)
|
||
{
|
||
$mapping = $this->getFieldMapping($fieldName);
|
||
if ($mapping !== false) {
|
||
return isset($mapping['nullable']) && $mapping['nullable'] == true;
|
||
}
|
||
return false;
|
||
}
|
||
|
||
/**
|
||
* Gets a column name for a field name.
|
||
* If the column name for the field cannot be found, the given field name
|
||
* is returned.
|
||
*
|
||
* @param string $fieldName The field name.
|
||
*
|
||
* @return string The column name.
|
||
*/
|
||
public function getColumnName($fieldName)
|
||
{
|
||
return isset($this->columnNames[$fieldName]) ?
|
||
$this->columnNames[$fieldName] : $fieldName;
|
||
}
|
||
|
||
/**
|
||
* Gets the mapping of a (regular) field that holds some data but not a
|
||
* reference to another object.
|
||
*
|
||
* @param string $fieldName The field name.
|
||
*
|
||
* @return array The field mapping.
|
||
*
|
||
* @throws MappingException
|
||
*/
|
||
public function getFieldMapping($fieldName)
|
||
{
|
||
if ( ! isset($this->fieldMappings[$fieldName])) {
|
||
throw MappingException::mappingNotFound($this->name, $fieldName);
|
||
}
|
||
return $this->fieldMappings[$fieldName];
|
||
}
|
||
|
||
/**
|
||
* Gets the mapping of an association.
|
||
*
|
||
* @see ClassMetadataInfo::$associationMappings
|
||
*
|
||
* @param string $fieldName The field name that represents the association in
|
||
* the object model.
|
||
*
|
||
* @return array The mapping.
|
||
*
|
||
* @throws MappingException
|
||
*/
|
||
public function getAssociationMapping($fieldName)
|
||
{
|
||
if ( ! isset($this->associationMappings[$fieldName])) {
|
||
throw MappingException::mappingNotFound($this->name, $fieldName);
|
||
}
|
||
return $this->associationMappings[$fieldName];
|
||
}
|
||
|
||
/**
|
||
* Gets all association mappings of the class.
|
||
*
|
||
* @return array
|
||
*/
|
||
public function getAssociationMappings()
|
||
{
|
||
return $this->associationMappings;
|
||
}
|
||
|
||
/**
|
||
* Gets the field name for a column name.
|
||
* If no field name can be found the column name is returned.
|
||
*
|
||
* @param string $columnName The column name.
|
||
*
|
||
* @return string The column alias.
|
||
*/
|
||
public function getFieldName($columnName)
|
||
{
|
||
return isset($this->fieldNames[$columnName]) ?
|
||
$this->fieldNames[$columnName] : $columnName;
|
||
}
|
||
|
||
/**
|
||
* Gets the named query.
|
||
*
|
||
* @see ClassMetadataInfo::$namedQueries
|
||
*
|
||
* @param string $queryName The query name.
|
||
*
|
||
* @return string
|
||
*
|
||
* @throws MappingException
|
||
*/
|
||
public function getNamedQuery($queryName)
|
||
{
|
||
if ( ! isset($this->namedQueries[$queryName])) {
|
||
throw MappingException::queryNotFound($this->name, $queryName);
|
||
}
|
||
return $this->namedQueries[$queryName]['dql'];
|
||
}
|
||
|
||
/**
|
||
* Gets all named queries of the class.
|
||
*
|
||
* @return array
|
||
*/
|
||
public function getNamedQueries()
|
||
{
|
||
return $this->namedQueries;
|
||
}
|
||
|
||
/**
|
||
* Gets the named native query.
|
||
*
|
||
* @see ClassMetadataInfo::$namedNativeQueries
|
||
*
|
||
* @param string $queryName The query name.
|
||
*
|
||
* @return array
|
||
*
|
||
* @throws MappingException
|
||
*/
|
||
public function getNamedNativeQuery($queryName)
|
||
{
|
||
if ( ! isset($this->namedNativeQueries[$queryName])) {
|
||
throw MappingException::queryNotFound($this->name, $queryName);
|
||
}
|
||
|
||
return $this->namedNativeQueries[$queryName];
|
||
}
|
||
|
||
/**
|
||
* Gets all named native queries of the class.
|
||
*
|
||
* @return array
|
||
*/
|
||
public function getNamedNativeQueries()
|
||
{
|
||
return $this->namedNativeQueries;
|
||
}
|
||
|
||
/**
|
||
* Gets the result set mapping.
|
||
*
|
||
* @see ClassMetadataInfo::$sqlResultSetMappings
|
||
*
|
||
* @param string $name The result set mapping name.
|
||
*
|
||
* @return array
|
||
*
|
||
* @throws MappingException
|
||
*/
|
||
public function getSqlResultSetMapping($name)
|
||
{
|
||
if ( ! isset($this->sqlResultSetMappings[$name])) {
|
||
throw MappingException::resultMappingNotFound($this->name, $name);
|
||
}
|
||
|
||
return $this->sqlResultSetMappings[$name];
|
||
}
|
||
|
||
/**
|
||
* Gets all sql result set mappings of the class.
|
||
*
|
||
* @return array
|
||
*/
|
||
public function getSqlResultSetMappings()
|
||
{
|
||
return $this->sqlResultSetMappings;
|
||
}
|
||
|
||
/**
|
||
* Validates & completes the given field mapping.
|
||
*
|
||
* @param array $mapping The field mapping to validate & complete.
|
||
*
|
||
* @return array The validated and completed field mapping.
|
||
*
|
||
* @throws MappingException
|
||
*/
|
||
protected function _validateAndCompleteFieldMapping(array &$mapping)
|
||
{
|
||
// Check mandatory fields
|
||
if ( ! isset($mapping['fieldName']) || strlen($mapping['fieldName']) == 0) {
|
||
throw MappingException::missingFieldName($this->name);
|
||
}
|
||
if ( ! isset($mapping['type'])) {
|
||
// Default to string
|
||
$mapping['type'] = 'string';
|
||
}
|
||
|
||
// Complete fieldName and columnName mapping
|
||
if ( ! isset($mapping['columnName'])) {
|
||
$mapping['columnName'] = $this->namingStrategy->propertyToColumnName($mapping['fieldName'], $this->name);
|
||
}
|
||
|
||
if ($mapping['columnName'][0] === '`') {
|
||
$mapping['columnName'] = trim($mapping['columnName'], '`');
|
||
$mapping['quoted'] = true;
|
||
}
|
||
|
||
$this->columnNames[$mapping['fieldName']] = $mapping['columnName'];
|
||
if (isset($this->fieldNames[$mapping['columnName']]) || ($this->discriminatorColumn != null && $this->discriminatorColumn['name'] == $mapping['columnName'])) {
|
||
throw MappingException::duplicateColumnName($this->name, $mapping['columnName']);
|
||
}
|
||
|
||
$this->fieldNames[$mapping['columnName']] = $mapping['fieldName'];
|
||
|
||
// Complete id mapping
|
||
if (isset($mapping['id']) && $mapping['id'] === true) {
|
||
if ($this->versionField == $mapping['fieldName']) {
|
||
throw MappingException::cannotVersionIdField($this->name, $mapping['fieldName']);
|
||
}
|
||
|
||
if ( ! in_array($mapping['fieldName'], $this->identifier)) {
|
||
$this->identifier[] = $mapping['fieldName'];
|
||
}
|
||
// Check for composite key
|
||
if ( ! $this->isIdentifierComposite && count($this->identifier) > 1) {
|
||
$this->isIdentifierComposite = true;
|
||
}
|
||
}
|
||
|
||
if (Type::hasType($mapping['type']) && Type::getType($mapping['type'])->canRequireSQLConversion()) {
|
||
if (isset($mapping['id']) && $mapping['id'] === true) {
|
||
throw MappingException::sqlConversionNotAllowedForIdentifiers($this->name, $mapping['fieldName'], $mapping['type']);
|
||
}
|
||
|
||
$mapping['requireSQLConversion'] = true;
|
||
}
|
||
}
|
||
|
||
/**
|
||
* Validates & completes the basic mapping information that is common to all
|
||
* association mappings (one-to-one, many-ot-one, one-to-many, many-to-many).
|
||
*
|
||
* @param array $mapping The mapping.
|
||
*
|
||
* @return array The updated mapping.
|
||
*
|
||
* @throws MappingException If something is wrong with the mapping.
|
||
*/
|
||
protected function _validateAndCompleteAssociationMapping(array $mapping)
|
||
{
|
||
if ( ! isset($mapping['mappedBy'])) {
|
||
$mapping['mappedBy'] = null;
|
||
}
|
||
if ( ! isset($mapping['inversedBy'])) {
|
||
$mapping['inversedBy'] = null;
|
||
}
|
||
$mapping['isOwningSide'] = true; // assume owning side until we hit mappedBy
|
||
|
||
// unset optional indexBy attribute if its empty
|
||
if ( ! isset($mapping['indexBy']) || !$mapping['indexBy']) {
|
||
unset($mapping['indexBy']);
|
||
}
|
||
|
||
// If targetEntity is unqualified, assume it is in the same namespace as
|
||
// the sourceEntity.
|
||
$mapping['sourceEntity'] = $this->name;
|
||
|
||
if (isset($mapping['targetEntity'])) {
|
||
$mapping['targetEntity'] = $this->fullyQualifiedClassName($mapping['targetEntity']);
|
||
$mapping['targetEntity'] = ltrim($mapping['targetEntity'], '\\');
|
||
}
|
||
|
||
if ( ($mapping['type'] & self::MANY_TO_ONE) > 0 &&
|
||
isset($mapping['orphanRemoval']) &&
|
||
$mapping['orphanRemoval'] == true) {
|
||
|
||
throw MappingException::illegalOrphanRemoval($this->name, $mapping['fieldName']);
|
||
}
|
||
|
||
// Complete id mapping
|
||
if (isset($mapping['id']) && $mapping['id'] === true) {
|
||
if (isset($mapping['orphanRemoval']) && $mapping['orphanRemoval'] == true) {
|
||
throw MappingException::illegalOrphanRemovalOnIdentifierAssociation($this->name, $mapping['fieldName']);
|
||
}
|
||
|
||
if ( ! in_array($mapping['fieldName'], $this->identifier)) {
|
||
if (isset($mapping['joinColumns']) && count($mapping['joinColumns']) >= 2) {
|
||
throw MappingException::cannotMapCompositePrimaryKeyEntitiesAsForeignId(
|
||
$mapping['targetEntity'], $this->name, $mapping['fieldName']
|
||
);
|
||
}
|
||
|
||
$this->identifier[] = $mapping['fieldName'];
|
||
$this->containsForeignIdentifier = true;
|
||
}
|
||
// Check for composite key
|
||
if ( ! $this->isIdentifierComposite && count($this->identifier) > 1) {
|
||
$this->isIdentifierComposite = true;
|
||
}
|
||
}
|
||
|
||
// Mandatory attributes for both sides
|
||
// Mandatory: fieldName, targetEntity
|
||
if ( ! isset($mapping['fieldName']) || strlen($mapping['fieldName']) == 0) {
|
||
throw MappingException::missingFieldName($this->name);
|
||
}
|
||
if ( ! isset($mapping['targetEntity'])) {
|
||
throw MappingException::missingTargetEntity($mapping['fieldName']);
|
||
}
|
||
|
||
// Mandatory and optional attributes for either side
|
||
if ( ! $mapping['mappedBy']) {
|
||
if (isset($mapping['joinTable']) && $mapping['joinTable']) {
|
||
if (isset($mapping['joinTable']['name']) && $mapping['joinTable']['name'][0] === '`') {
|
||
$mapping['joinTable']['name'] = trim($mapping['joinTable']['name'], '`');
|
||
$mapping['joinTable']['quoted'] = true;
|
||
}
|
||
}
|
||
} else {
|
||
$mapping['isOwningSide'] = false;
|
||
}
|
||
|
||
if (isset($mapping['id']) && $mapping['id'] === true && $mapping['type'] & self::TO_MANY) {
|
||
throw MappingException::illegalToManyIdentifierAssociation($this->name, $mapping['fieldName']);
|
||
}
|
||
|
||
// Fetch mode. Default fetch mode to LAZY, if not set.
|
||
if ( ! isset($mapping['fetch'])) {
|
||
$mapping['fetch'] = self::FETCH_LAZY;
|
||
}
|
||
|
||
// Cascades
|
||
$cascades = isset($mapping['cascade']) ? array_map('strtolower', $mapping['cascade']) : array();
|
||
|
||
if (in_array('all', $cascades)) {
|
||
$cascades = array('remove', 'persist', 'refresh', 'merge', 'detach');
|
||
}
|
||
|
||
if (count($cascades) !== count(array_intersect($cascades, array('remove', 'persist', 'refresh', 'merge', 'detach')))) {
|
||
throw MappingException::invalidCascadeOption(
|
||
array_diff($cascades, array_intersect($cascades, array('remove', 'persist', 'refresh', 'merge', 'detach'))),
|
||
$this->name,
|
||
$mapping['fieldName']
|
||
);
|
||
}
|
||
|
||
$mapping['cascade'] = $cascades;
|
||
$mapping['isCascadeRemove'] = in_array('remove', $cascades);
|
||
$mapping['isCascadePersist'] = in_array('persist', $cascades);
|
||
$mapping['isCascadeRefresh'] = in_array('refresh', $cascades);
|
||
$mapping['isCascadeMerge'] = in_array('merge', $cascades);
|
||
$mapping['isCascadeDetach'] = in_array('detach', $cascades);
|
||
|
||
return $mapping;
|
||
}
|
||
|
||
/**
|
||
* Validates & completes a one-to-one association mapping.
|
||
*
|
||
* @param array $mapping The mapping to validate & complete.
|
||
*
|
||
* @return array The validated & completed mapping.
|
||
*
|
||
* @throws RuntimeException
|
||
* @throws MappingException
|
||
*/
|
||
protected function _validateAndCompleteOneToOneMapping(array $mapping)
|
||
{
|
||
$mapping = $this->_validateAndCompleteAssociationMapping($mapping);
|
||
|
||
if (isset($mapping['joinColumns']) && $mapping['joinColumns']) {
|
||
$mapping['isOwningSide'] = true;
|
||
}
|
||
|
||
if ($mapping['isOwningSide']) {
|
||
if ( ! isset($mapping['joinColumns']) || ! $mapping['joinColumns']) {
|
||
// Apply default join column
|
||
$mapping['joinColumns'] = array(array(
|
||
'name' => $this->namingStrategy->joinColumnName($mapping['fieldName'], $this->name),
|
||
'referencedColumnName' => $this->namingStrategy->referenceColumnName()
|
||
));
|
||
}
|
||
|
||
$uniqueConstraintColumns = array();
|
||
foreach ($mapping['joinColumns'] as &$joinColumn) {
|
||
if ($mapping['type'] === self::ONE_TO_ONE && ! $this->isInheritanceTypeSingleTable()) {
|
||
if (count($mapping['joinColumns']) == 1) {
|
||
if ( ! isset($mapping['id']) || ! $mapping['id']) {
|
||
$joinColumn['unique'] = true;
|
||
}
|
||
} else {
|
||
$uniqueConstraintColumns[] = $joinColumn['name'];
|
||
}
|
||
}
|
||
|
||
if (empty($joinColumn['name'])) {
|
||
$joinColumn['name'] = $this->namingStrategy->joinColumnName($mapping['fieldName'], $this->name);
|
||
}
|
||
|
||
if (empty($joinColumn['referencedColumnName'])) {
|
||
$joinColumn['referencedColumnName'] = $this->namingStrategy->referenceColumnName();
|
||
}
|
||
|
||
if ($joinColumn['name'][0] === '`') {
|
||
$joinColumn['name'] = trim($joinColumn['name'], '`');
|
||
$joinColumn['quoted'] = true;
|
||
}
|
||
|
||
if ($joinColumn['referencedColumnName'][0] === '`') {
|
||
$joinColumn['referencedColumnName'] = trim($joinColumn['referencedColumnName'], '`');
|
||
$joinColumn['quoted'] = true;
|
||
}
|
||
|
||
$mapping['sourceToTargetKeyColumns'][$joinColumn['name']] = $joinColumn['referencedColumnName'];
|
||
$mapping['joinColumnFieldNames'][$joinColumn['name']] = isset($joinColumn['fieldName'])
|
||
? $joinColumn['fieldName'] : $joinColumn['name'];
|
||
}
|
||
|
||
if ($uniqueConstraintColumns) {
|
||
if ( ! $this->table) {
|
||
throw new RuntimeException("ClassMetadataInfo::setTable() has to be called before defining a one to one relationship.");
|
||
}
|
||
$this->table['uniqueConstraints'][$mapping['fieldName']."_uniq"] = array(
|
||
'columns' => $uniqueConstraintColumns
|
||
);
|
||
}
|
||
|
||
$mapping['targetToSourceKeyColumns'] = array_flip($mapping['sourceToTargetKeyColumns']);
|
||
}
|
||
|
||
$mapping['orphanRemoval'] = isset($mapping['orphanRemoval']) ? (bool) $mapping['orphanRemoval'] : false;
|
||
$mapping['isCascadeRemove'] = $mapping['orphanRemoval'] ? true : $mapping['isCascadeRemove'];
|
||
|
||
if ($mapping['orphanRemoval']) {
|
||
unset($mapping['unique']);
|
||
}
|
||
|
||
if (isset($mapping['id']) && $mapping['id'] === true && !$mapping['isOwningSide']) {
|
||
throw MappingException::illegalInverseIdentifierAssociation($this->name, $mapping['fieldName']);
|
||
}
|
||
|
||
return $mapping;
|
||
}
|
||
|
||
/**
|
||
* Validates & completes a one-to-many association mapping.
|
||
*
|
||
* @param array $mapping The mapping to validate and complete.
|
||
*
|
||
* @return array The validated and completed mapping.
|
||
*
|
||
* @throws MappingException
|
||
* @throws InvalidArgumentException
|
||
*/
|
||
protected function _validateAndCompleteOneToManyMapping(array $mapping)
|
||
{
|
||
$mapping = $this->_validateAndCompleteAssociationMapping($mapping);
|
||
|
||
// OneToMany-side MUST be inverse (must have mappedBy)
|
||
if ( ! isset($mapping['mappedBy'])) {
|
||
throw MappingException::oneToManyRequiresMappedBy($mapping['fieldName']);
|
||
}
|
||
|
||
$mapping['orphanRemoval'] = isset($mapping['orphanRemoval']) ? (bool) $mapping['orphanRemoval'] : false;
|
||
$mapping['isCascadeRemove'] = $mapping['orphanRemoval'] ? true : $mapping['isCascadeRemove'];
|
||
|
||
if (isset($mapping['orderBy'])) {
|
||
if ( ! is_array($mapping['orderBy'])) {
|
||
throw new InvalidArgumentException("'orderBy' is expected to be an array, not ".gettype($mapping['orderBy']));
|
||
}
|
||
}
|
||
|
||
return $mapping;
|
||
}
|
||
|
||
/**
|
||
* Validates & completes a many-to-many association mapping.
|
||
*
|
||
* @param array $mapping The mapping to validate & complete.
|
||
*
|
||
* @return array The validated & completed mapping.
|
||
*
|
||
* @throws \InvalidArgumentException
|
||
*/
|
||
protected function _validateAndCompleteManyToManyMapping(array $mapping)
|
||
{
|
||
$mapping = $this->_validateAndCompleteAssociationMapping($mapping);
|
||
if ($mapping['isOwningSide']) {
|
||
// owning side MUST have a join table
|
||
if ( ! isset($mapping['joinTable']['name'])) {
|
||
$mapping['joinTable']['name'] = $this->namingStrategy->joinTableName($mapping['sourceEntity'], $mapping['targetEntity'], $mapping['fieldName']);
|
||
}
|
||
|
||
$selfReferencingEntityWithoutJoinColumns = $mapping['sourceEntity'] == $mapping['targetEntity']
|
||
&& (! (isset($mapping['joinTable']['joinColumns']) || isset($mapping['joinTable']['inverseJoinColumns'])));
|
||
|
||
if ( ! isset($mapping['joinTable']['joinColumns'])) {
|
||
$mapping['joinTable']['joinColumns'] = array(array(
|
||
'name' => $this->namingStrategy->joinKeyColumnName($mapping['sourceEntity'], $selfReferencingEntityWithoutJoinColumns ? 'source' : null),
|
||
'referencedColumnName' => $this->namingStrategy->referenceColumnName(),
|
||
'onDelete' => 'CASCADE'));
|
||
}
|
||
if ( ! isset($mapping['joinTable']['inverseJoinColumns'])) {
|
||
$mapping['joinTable']['inverseJoinColumns'] = array(array(
|
||
'name' => $this->namingStrategy->joinKeyColumnName($mapping['targetEntity'], $selfReferencingEntityWithoutJoinColumns ? 'target' : null),
|
||
'referencedColumnName' => $this->namingStrategy->referenceColumnName(),
|
||
'onDelete' => 'CASCADE'));
|
||
}
|
||
|
||
$mapping['joinTableColumns'] = array();
|
||
|
||
foreach ($mapping['joinTable']['joinColumns'] as &$joinColumn) {
|
||
if (empty($joinColumn['name'])) {
|
||
$joinColumn['name'] = $this->namingStrategy->joinKeyColumnName($mapping['sourceEntity'], $joinColumn['referencedColumnName']);
|
||
}
|
||
|
||
if (empty($joinColumn['referencedColumnName'])) {
|
||
$joinColumn['referencedColumnName'] = $this->namingStrategy->referenceColumnName();
|
||
}
|
||
|
||
if ($joinColumn['name'][0] === '`') {
|
||
$joinColumn['name'] = trim($joinColumn['name'], '`');
|
||
$joinColumn['quoted'] = true;
|
||
}
|
||
|
||
if ($joinColumn['referencedColumnName'][0] === '`') {
|
||
$joinColumn['referencedColumnName'] = trim($joinColumn['referencedColumnName'], '`');
|
||
$joinColumn['quoted'] = true;
|
||
}
|
||
|
||
if (isset($joinColumn['onDelete']) && strtolower($joinColumn['onDelete']) == 'cascade') {
|
||
$mapping['isOnDeleteCascade'] = true;
|
||
}
|
||
|
||
$mapping['relationToSourceKeyColumns'][$joinColumn['name']] = $joinColumn['referencedColumnName'];
|
||
$mapping['joinTableColumns'][] = $joinColumn['name'];
|
||
}
|
||
|
||
foreach ($mapping['joinTable']['inverseJoinColumns'] as &$inverseJoinColumn) {
|
||
if (empty($inverseJoinColumn['name'])) {
|
||
$inverseJoinColumn['name'] = $this->namingStrategy->joinKeyColumnName($mapping['targetEntity'], $inverseJoinColumn['referencedColumnName']);
|
||
}
|
||
|
||
if (empty($inverseJoinColumn['referencedColumnName'])) {
|
||
$inverseJoinColumn['referencedColumnName'] = $this->namingStrategy->referenceColumnName();
|
||
}
|
||
|
||
if ($inverseJoinColumn['name'][0] === '`') {
|
||
$inverseJoinColumn['name'] = trim($inverseJoinColumn['name'], '`');
|
||
$inverseJoinColumn['quoted'] = true;
|
||
}
|
||
|
||
if ($inverseJoinColumn['referencedColumnName'][0] === '`') {
|
||
$inverseJoinColumn['referencedColumnName'] = trim($inverseJoinColumn['referencedColumnName'], '`');
|
||
$inverseJoinColumn['quoted'] = true;
|
||
}
|
||
|
||
if (isset($inverseJoinColumn['onDelete']) && strtolower($inverseJoinColumn['onDelete']) == 'cascade') {
|
||
$mapping['isOnDeleteCascade'] = true;
|
||
}
|
||
|
||
$mapping['relationToTargetKeyColumns'][$inverseJoinColumn['name']] = $inverseJoinColumn['referencedColumnName'];
|
||
$mapping['joinTableColumns'][] = $inverseJoinColumn['name'];
|
||
}
|
||
}
|
||
|
||
$mapping['orphanRemoval'] = isset($mapping['orphanRemoval']) ? (bool) $mapping['orphanRemoval'] : false;
|
||
|
||
if (isset($mapping['orderBy'])) {
|
||
if ( ! is_array($mapping['orderBy'])) {
|
||
throw new InvalidArgumentException("'orderBy' is expected to be an array, not ".gettype($mapping['orderBy']));
|
||
}
|
||
}
|
||
|
||
return $mapping;
|
||
}
|
||
|
||
/**
|
||
* {@inheritDoc}
|
||
*/
|
||
public function getIdentifierFieldNames()
|
||
{
|
||
return $this->identifier;
|
||
}
|
||
|
||
/**
|
||
* Gets the name of the single id field. Note that this only works on
|
||
* entity classes that have a single-field pk.
|
||
*
|
||
* @return string
|
||
*
|
||
* @throws MappingException If the class has a composite primary key.
|
||
*/
|
||
public function getSingleIdentifierFieldName()
|
||
{
|
||
if ($this->isIdentifierComposite) {
|
||
throw MappingException::singleIdNotAllowedOnCompositePrimaryKey($this->name);
|
||
}
|
||
return $this->identifier[0];
|
||
}
|
||
|
||
/**
|
||
* Gets the column name of the single id column. Note that this only works on
|
||
* entity classes that have a single-field pk.
|
||
*
|
||
* @return string
|
||
*
|
||
* @throws MappingException If the class has a composite primary key.
|
||
*/
|
||
public function getSingleIdentifierColumnName()
|
||
{
|
||
return $this->getColumnName($this->getSingleIdentifierFieldName());
|
||
}
|
||
|
||
/**
|
||
* INTERNAL:
|
||
* Sets the mapped identifier/primary key fields of this class.
|
||
* Mainly used by the ClassMetadataFactory to assign inherited identifiers.
|
||
*
|
||
* @param array $identifier
|
||
*
|
||
* @return void
|
||
*/
|
||
public function setIdentifier(array $identifier)
|
||
{
|
||
$this->identifier = $identifier;
|
||
$this->isIdentifierComposite = (count($this->identifier) > 1);
|
||
}
|
||
|
||
/**
|
||
* {@inheritDoc}
|
||
*/
|
||
public function getIdentifier()
|
||
{
|
||
return $this->identifier;
|
||
}
|
||
|
||
/**
|
||
* {@inheritDoc}
|
||
*/
|
||
public function hasField($fieldName)
|
||
{
|
||
return isset($this->fieldMappings[$fieldName]);
|
||
}
|
||
|
||
/**
|
||
* Gets an array containing all the column names.
|
||
*
|
||
* @param array|null $fieldNames
|
||
*
|
||
* @return array
|
||
*/
|
||
public function getColumnNames(array $fieldNames = null)
|
||
{
|
||
if ($fieldNames === null) {
|
||
return array_keys($this->fieldNames);
|
||
} else {
|
||
$columnNames = array();
|
||
foreach ($fieldNames as $fieldName) {
|
||
$columnNames[] = $this->getColumnName($fieldName);
|
||
}
|
||
return $columnNames;
|
||
}
|
||
}
|
||
|
||
/**
|
||
* Returns an array with all the identifier column names.
|
||
*
|
||
* @return array
|
||
*/
|
||
public function getIdentifierColumnNames()
|
||
{
|
||
$columnNames = array();
|
||
|
||
foreach ($this->identifier as $idProperty) {
|
||
if (isset($this->fieldMappings[$idProperty])) {
|
||
$columnNames[] = $this->fieldMappings[$idProperty]['columnName'];
|
||
|
||
continue;
|
||
}
|
||
|
||
// Association defined as Id field
|
||
$joinColumns = $this->associationMappings[$idProperty]['joinColumns'];
|
||
$assocColumnNames = array_map(function ($joinColumn) { return $joinColumn['name']; }, $joinColumns);
|
||
|
||
$columnNames = array_merge($columnNames, $assocColumnNames);
|
||
}
|
||
|
||
return $columnNames;
|
||
}
|
||
|
||
/**
|
||
* Sets the type of Id generator to use for the mapped class.
|
||
*
|
||
* @param int $generatorType
|
||
*
|
||
* @return void
|
||
*/
|
||
public function setIdGeneratorType($generatorType)
|
||
{
|
||
$this->generatorType = $generatorType;
|
||
}
|
||
|
||
/**
|
||
* Checks whether the mapped class uses an Id generator.
|
||
*
|
||
* @return boolean TRUE if the mapped class uses an Id generator, FALSE otherwise.
|
||
*/
|
||
public function usesIdGenerator()
|
||
{
|
||
return $this->generatorType != self::GENERATOR_TYPE_NONE;
|
||
}
|
||
|
||
/**
|
||
* @return boolean
|
||
*/
|
||
public function isInheritanceTypeNone()
|
||
{
|
||
return $this->inheritanceType == self::INHERITANCE_TYPE_NONE;
|
||
}
|
||
|
||
/**
|
||
* Checks whether the mapped class uses the JOINED inheritance mapping strategy.
|
||
*
|
||
* @return boolean TRUE if the class participates in a JOINED inheritance mapping,
|
||
* FALSE otherwise.
|
||
*/
|
||
public function isInheritanceTypeJoined()
|
||
{
|
||
return $this->inheritanceType == self::INHERITANCE_TYPE_JOINED;
|
||
}
|
||
|
||
/**
|
||
* Checks whether the mapped class uses the SINGLE_TABLE inheritance mapping strategy.
|
||
*
|
||
* @return boolean TRUE if the class participates in a SINGLE_TABLE inheritance mapping,
|
||
* FALSE otherwise.
|
||
*/
|
||
public function isInheritanceTypeSingleTable()
|
||
{
|
||
return $this->inheritanceType == self::INHERITANCE_TYPE_SINGLE_TABLE;
|
||
}
|
||
|
||
/**
|
||
* Checks whether the mapped class uses the TABLE_PER_CLASS inheritance mapping strategy.
|
||
*
|
||
* @return boolean TRUE if the class participates in a TABLE_PER_CLASS inheritance mapping,
|
||
* FALSE otherwise.
|
||
*/
|
||
public function isInheritanceTypeTablePerClass()
|
||
{
|
||
return $this->inheritanceType == self::INHERITANCE_TYPE_TABLE_PER_CLASS;
|
||
}
|
||
|
||
/**
|
||
* Checks whether the class uses an identity column for the Id generation.
|
||
*
|
||
* @return boolean TRUE if the class uses the IDENTITY generator, FALSE otherwise.
|
||
*/
|
||
public function isIdGeneratorIdentity()
|
||
{
|
||
return $this->generatorType == self::GENERATOR_TYPE_IDENTITY;
|
||
}
|
||
|
||
/**
|
||
* Checks whether the class uses a sequence for id generation.
|
||
*
|
||
* @return boolean TRUE if the class uses the SEQUENCE generator, FALSE otherwise.
|
||
*/
|
||
public function isIdGeneratorSequence()
|
||
{
|
||
return $this->generatorType == self::GENERATOR_TYPE_SEQUENCE;
|
||
}
|
||
|
||
/**
|
||
* Checks whether the class uses a table for id generation.
|
||
*
|
||
* @return boolean TRUE if the class uses the TABLE generator, FALSE otherwise.
|
||
*/
|
||
public function isIdGeneratorTable()
|
||
{
|
||
return $this->generatorType == self::GENERATOR_TYPE_TABLE;
|
||
}
|
||
|
||
/**
|
||
* Checks whether the class has a natural identifier/pk (which means it does
|
||
* not use any Id generator.
|
||
*
|
||
* @return boolean
|
||
*/
|
||
public function isIdentifierNatural()
|
||
{
|
||
return $this->generatorType == self::GENERATOR_TYPE_NONE;
|
||
}
|
||
|
||
/**
|
||
* Checks whether the class use a UUID for id generation.
|
||
*
|
||
* @return boolean
|
||
*/
|
||
public function isIdentifierUuid()
|
||
{
|
||
return $this->generatorType == self::GENERATOR_TYPE_UUID;
|
||
}
|
||
|
||
/**
|
||
* Gets the type of a field.
|
||
*
|
||
* @param string $fieldName
|
||
*
|
||
* @return \Doctrine\DBAL\Types\Type|string|null
|
||
*/
|
||
public function getTypeOfField($fieldName)
|
||
{
|
||
return isset($this->fieldMappings[$fieldName]) ?
|
||
$this->fieldMappings[$fieldName]['type'] : null;
|
||
}
|
||
|
||
/**
|
||
* Gets the type of a column.
|
||
*
|
||
* @param string $columnName
|
||
*
|
||
* @return \Doctrine\DBAL\Types\Type|string|null
|
||
*
|
||
* @deprecated this method is bogous and unreliable, since it cannot resolve the type of a column that is
|
||
* derived by a referenced field on a different entity.
|
||
*/
|
||
public function getTypeOfColumn($columnName)
|
||
{
|
||
return $this->getTypeOfField($this->getFieldName($columnName));
|
||
}
|
||
|
||
/**
|
||
* Gets the name of the primary table.
|
||
*
|
||
* @return string
|
||
*/
|
||
public function getTableName()
|
||
{
|
||
return $this->table['name'];
|
||
}
|
||
|
||
/**
|
||
* Gets primary table's schema name.
|
||
*
|
||
* @return string|null
|
||
*/
|
||
public function getSchemaName()
|
||
{
|
||
return isset($this->table['schema']) ? $this->table['schema'] : null;
|
||
}
|
||
|
||
/**
|
||
* Gets the table name to use for temporary identifier tables of this class.
|
||
*
|
||
* @return string
|
||
*/
|
||
public function getTemporaryIdTableName()
|
||
{
|
||
// replace dots with underscores because PostgreSQL creates temporary tables in a special schema
|
||
return str_replace('.', '_', $this->getTableName() . '_id_tmp');
|
||
}
|
||
|
||
/**
|
||
* Sets the mapped subclasses of this class.
|
||
*
|
||
* @param array $subclasses The names of all mapped subclasses.
|
||
*
|
||
* @return void
|
||
*/
|
||
public function setSubclasses(array $subclasses)
|
||
{
|
||
foreach ($subclasses as $subclass) {
|
||
$this->subClasses[] = $this->fullyQualifiedClassName($subclass);
|
||
}
|
||
}
|
||
|
||
/**
|
||
* Sets the parent class names.
|
||
* Assumes that the class names in the passed array are in the order:
|
||
* directParent -> directParentParent -> directParentParentParent ... -> root.
|
||
*
|
||
* @param array $classNames
|
||
*
|
||
* @return void
|
||
*/
|
||
public function setParentClasses(array $classNames)
|
||
{
|
||
$this->parentClasses = $classNames;
|
||
if (count($classNames) > 0) {
|
||
$this->rootEntityName = array_pop($classNames);
|
||
}
|
||
}
|
||
|
||
/**
|
||
* Sets the inheritance type used by the class and its subclasses.
|
||
*
|
||
* @param integer $type
|
||
*
|
||
* @return void
|
||
*
|
||
* @throws MappingException
|
||
*/
|
||
public function setInheritanceType($type)
|
||
{
|
||
if ( ! $this->_isInheritanceType($type)) {
|
||
throw MappingException::invalidInheritanceType($this->name, $type);
|
||
}
|
||
$this->inheritanceType = $type;
|
||
}
|
||
|
||
/**
|
||
* Sets the association to override association mapping of property for an entity relationship.
|
||
*
|
||
* @param string $fieldName
|
||
* @param array $overrideMapping
|
||
*
|
||
* @return void
|
||
*
|
||
* @throws MappingException
|
||
*/
|
||
public function setAssociationOverride($fieldName, array $overrideMapping)
|
||
{
|
||
if ( ! isset($this->associationMappings[$fieldName])) {
|
||
throw MappingException::invalidOverrideFieldName($this->name, $fieldName);
|
||
}
|
||
|
||
$mapping = $this->associationMappings[$fieldName];
|
||
|
||
if (isset($overrideMapping['joinColumns'])) {
|
||
$mapping['joinColumns'] = $overrideMapping['joinColumns'];
|
||
}
|
||
|
||
if (isset($overrideMapping['joinTable'])) {
|
||
$mapping['joinTable'] = $overrideMapping['joinTable'];
|
||
}
|
||
|
||
$mapping['joinColumnFieldNames'] = null;
|
||
$mapping['joinTableColumns'] = null;
|
||
$mapping['sourceToTargetKeyColumns'] = null;
|
||
$mapping['relationToSourceKeyColumns'] = null;
|
||
$mapping['relationToTargetKeyColumns'] = null;
|
||
|
||
switch ($mapping['type']) {
|
||
case self::ONE_TO_ONE:
|
||
$mapping = $this->_validateAndCompleteOneToOneMapping($mapping);
|
||
break;
|
||
case self::ONE_TO_MANY:
|
||
$mapping = $this->_validateAndCompleteOneToManyMapping($mapping);
|
||
break;
|
||
case self::MANY_TO_ONE:
|
||
$mapping = $this->_validateAndCompleteOneToOneMapping($mapping);
|
||
break;
|
||
case self::MANY_TO_MANY:
|
||
$mapping = $this->_validateAndCompleteManyToManyMapping($mapping);
|
||
break;
|
||
}
|
||
|
||
$this->associationMappings[$fieldName] = $mapping;
|
||
}
|
||
|
||
/**
|
||
* Sets the override for a mapped field.
|
||
*
|
||
* @param string $fieldName
|
||
* @param array $overrideMapping
|
||
*
|
||
* @return void
|
||
*
|
||
* @throws MappingException
|
||
*/
|
||
public function setAttributeOverride($fieldName, array $overrideMapping)
|
||
{
|
||
if ( ! isset($this->fieldMappings[$fieldName])) {
|
||
throw MappingException::invalidOverrideFieldName($this->name, $fieldName);
|
||
}
|
||
|
||
$mapping = $this->fieldMappings[$fieldName];
|
||
|
||
if (isset($mapping['id'])) {
|
||
$overrideMapping['id'] = $mapping['id'];
|
||
}
|
||
|
||
if ( ! isset($overrideMapping['type']) || $overrideMapping['type'] === null) {
|
||
$overrideMapping['type'] = $mapping['type'];
|
||
}
|
||
|
||
if ( ! isset($overrideMapping['fieldName']) || $overrideMapping['fieldName'] === null) {
|
||
$overrideMapping['fieldName'] = $mapping['fieldName'];
|
||
}
|
||
|
||
if ($overrideMapping['type'] !== $mapping['type']) {
|
||
throw MappingException::invalidOverrideFieldType($this->name, $fieldName);
|
||
}
|
||
|
||
unset($this->fieldMappings[$fieldName]);
|
||
unset($this->fieldNames[$mapping['columnName']]);
|
||
unset($this->columnNames[$mapping['fieldName']]);
|
||
$this->_validateAndCompleteFieldMapping($overrideMapping);
|
||
|
||
$this->fieldMappings[$fieldName] = $overrideMapping;
|
||
}
|
||
|
||
/**
|
||
* Checks whether a mapped field is inherited from an entity superclass.
|
||
*
|
||
* @param string $fieldName
|
||
*
|
||
* @return bool TRUE if the field is inherited, FALSE otherwise.
|
||
*/
|
||
public function isInheritedField($fieldName)
|
||
{
|
||
return isset($this->fieldMappings[$fieldName]['inherited']);
|
||
}
|
||
|
||
/**
|
||
* Checks if this entity is the root in any entity-inheritance-hierarchy.
|
||
*
|
||
* @return bool
|
||
*/
|
||
public function isRootEntity()
|
||
{
|
||
return $this->name == $this->rootEntityName;
|
||
}
|
||
|
||
/**
|
||
* Checks whether a mapped association field is inherited from a superclass.
|
||
*
|
||
* @param string $fieldName
|
||
*
|
||
* @return boolean TRUE if the field is inherited, FALSE otherwise.
|
||
*/
|
||
public function isInheritedAssociation($fieldName)
|
||
{
|
||
return isset($this->associationMappings[$fieldName]['inherited']);
|
||
}
|
||
|
||
public function isInheritedEmbeddedClass($fieldName)
|
||
{
|
||
return isset($this->embeddedClasses[$fieldName]['inherited']);
|
||
}
|
||
|
||
/**
|
||
* Sets the name of the primary table the class is mapped to.
|
||
*
|
||
* @param string $tableName The table name.
|
||
*
|
||
* @return void
|
||
*
|
||
* @deprecated Use {@link setPrimaryTable}.
|
||
*/
|
||
public function setTableName($tableName)
|
||
{
|
||
$this->table['name'] = $tableName;
|
||
}
|
||
|
||
/**
|
||
* Sets the primary table definition. The provided array supports the
|
||
* following structure:
|
||
*
|
||
* name => <tableName> (optional, defaults to class name)
|
||
* indexes => array of indexes (optional)
|
||
* uniqueConstraints => array of constraints (optional)
|
||
*
|
||
* If a key is omitted, the current value is kept.
|
||
*
|
||
* @param array $table The table description.
|
||
*
|
||
* @return void
|
||
*/
|
||
public function setPrimaryTable(array $table)
|
||
{
|
||
if (isset($table['name'])) {
|
||
// Split schema and table name from a table name like "myschema.mytable"
|
||
if (strpos($table['name'], '.') !== false) {
|
||
list($this->table['schema'], $table['name']) = explode('.', $table['name'], 2);
|
||
}
|
||
|
||
if ($table['name'][0] === '`') {
|
||
$table['name'] = trim($table['name'], '`');
|
||
$this->table['quoted'] = true;
|
||
}
|
||
|
||
$this->table['name'] = $table['name'];
|
||
}
|
||
|
||
if (isset($table['schema'])) {
|
||
$this->table['schema'] = $table['schema'];
|
||
}
|
||
|
||
if (isset($table['indexes'])) {
|
||
$this->table['indexes'] = $table['indexes'];
|
||
}
|
||
|
||
if (isset($table['uniqueConstraints'])) {
|
||
$this->table['uniqueConstraints'] = $table['uniqueConstraints'];
|
||
}
|
||
|
||
if (isset($table['options'])) {
|
||
$this->table['options'] = $table['options'];
|
||
}
|
||
}
|
||
|
||
/**
|
||
* Checks whether the given type identifies an inheritance type.
|
||
*
|
||
* @param integer $type
|
||
*
|
||
* @return boolean TRUE if the given type identifies an inheritance type, FALSe otherwise.
|
||
*/
|
||
private function _isInheritanceType($type)
|
||
{
|
||
return $type == self::INHERITANCE_TYPE_NONE ||
|
||
$type == self::INHERITANCE_TYPE_SINGLE_TABLE ||
|
||
$type == self::INHERITANCE_TYPE_JOINED ||
|
||
$type == self::INHERITANCE_TYPE_TABLE_PER_CLASS;
|
||
}
|
||
|
||
/**
|
||
* Adds a mapped field to the class.
|
||
*
|
||
* @param array $mapping The field mapping.
|
||
*
|
||
* @return void
|
||
*
|
||
* @throws MappingException
|
||
*/
|
||
public function mapField(array $mapping)
|
||
{
|
||
$this->_validateAndCompleteFieldMapping($mapping);
|
||
$this->assertFieldNotMapped($mapping['fieldName']);
|
||
|
||
$this->fieldMappings[$mapping['fieldName']] = $mapping;
|
||
}
|
||
|
||
/**
|
||
* INTERNAL:
|
||
* Adds an association mapping without completing/validating it.
|
||
* This is mainly used to add inherited association mappings to derived classes.
|
||
*
|
||
* @param array $mapping
|
||
*
|
||
* @return void
|
||
*
|
||
* @throws MappingException
|
||
*/
|
||
public function addInheritedAssociationMapping(array $mapping/*, $owningClassName = null*/)
|
||
{
|
||
if (isset($this->associationMappings[$mapping['fieldName']])) {
|
||
throw MappingException::duplicateAssociationMapping($this->name, $mapping['fieldName']);
|
||
}
|
||
$this->associationMappings[$mapping['fieldName']] = $mapping;
|
||
}
|
||
|
||
/**
|
||
* INTERNAL:
|
||
* Adds a field mapping without completing/validating it.
|
||
* This is mainly used to add inherited field mappings to derived classes.
|
||
*
|
||
* @param array $fieldMapping
|
||
*
|
||
* @return void
|
||
*/
|
||
public function addInheritedFieldMapping(array $fieldMapping)
|
||
{
|
||
$this->fieldMappings[$fieldMapping['fieldName']] = $fieldMapping;
|
||
$this->columnNames[$fieldMapping['fieldName']] = $fieldMapping['columnName'];
|
||
$this->fieldNames[$fieldMapping['columnName']] = $fieldMapping['fieldName'];
|
||
}
|
||
|
||
/**
|
||
* INTERNAL:
|
||
* Adds a named query to this class.
|
||
*
|
||
* @param array $queryMapping
|
||
*
|
||
* @return void
|
||
*
|
||
* @throws MappingException
|
||
*/
|
||
public function addNamedQuery(array $queryMapping)
|
||
{
|
||
if (!isset($queryMapping['name'])) {
|
||
throw MappingException::nameIsMandatoryForQueryMapping($this->name);
|
||
}
|
||
|
||
if (isset($this->namedQueries[$queryMapping['name']])) {
|
||
throw MappingException::duplicateQueryMapping($this->name, $queryMapping['name']);
|
||
}
|
||
|
||
if (!isset($queryMapping['query'])) {
|
||
throw MappingException::emptyQueryMapping($this->name, $queryMapping['name']);
|
||
}
|
||
|
||
$name = $queryMapping['name'];
|
||
$query = $queryMapping['query'];
|
||
$dql = str_replace('__CLASS__', $this->name, $query);
|
||
$this->namedQueries[$name] = array(
|
||
'name' => $name,
|
||
'query' => $query,
|
||
'dql' => $dql
|
||
);
|
||
}
|
||
|
||
/**
|
||
* INTERNAL:
|
||
* Adds a named native query to this class.
|
||
*
|
||
* @param array $queryMapping
|
||
*
|
||
* @return void
|
||
*
|
||
* @throws MappingException
|
||
*/
|
||
public function addNamedNativeQuery(array $queryMapping)
|
||
{
|
||
if (!isset($queryMapping['name'])) {
|
||
throw MappingException::nameIsMandatoryForQueryMapping($this->name);
|
||
}
|
||
|
||
if (isset($this->namedNativeQueries[$queryMapping['name']])) {
|
||
throw MappingException::duplicateQueryMapping($this->name, $queryMapping['name']);
|
||
}
|
||
|
||
if (!isset($queryMapping['query'])) {
|
||
throw MappingException::emptyQueryMapping($this->name, $queryMapping['name']);
|
||
}
|
||
|
||
if (!isset($queryMapping['resultClass']) && !isset($queryMapping['resultSetMapping'])) {
|
||
throw MappingException::missingQueryMapping($this->name, $queryMapping['name']);
|
||
}
|
||
|
||
$queryMapping['isSelfClass'] = false;
|
||
if (isset($queryMapping['resultClass'])) {
|
||
|
||
if ($queryMapping['resultClass'] === '__CLASS__') {
|
||
|
||
$queryMapping['isSelfClass'] = true;
|
||
$queryMapping['resultClass'] = $this->name;
|
||
}
|
||
|
||
$queryMapping['resultClass'] = $this->fullyQualifiedClassName($queryMapping['resultClass']);
|
||
$queryMapping['resultClass'] = ltrim($queryMapping['resultClass'], '\\');
|
||
}
|
||
|
||
$this->namedNativeQueries[$queryMapping['name']] = $queryMapping;
|
||
}
|
||
|
||
/**
|
||
* INTERNAL:
|
||
* Adds a sql result set mapping to this class.
|
||
*
|
||
* @param array $resultMapping
|
||
*
|
||
* @return void
|
||
*
|
||
* @throws MappingException
|
||
*/
|
||
public function addSqlResultSetMapping(array $resultMapping)
|
||
{
|
||
if (!isset($resultMapping['name'])) {
|
||
throw MappingException::nameIsMandatoryForSqlResultSetMapping($this->name);
|
||
}
|
||
|
||
if (isset($this->sqlResultSetMappings[$resultMapping['name']])) {
|
||
throw MappingException::duplicateResultSetMapping($this->name, $resultMapping['name']);
|
||
}
|
||
|
||
if (isset($resultMapping['entities'])) {
|
||
foreach ($resultMapping['entities'] as $key => $entityResult) {
|
||
if (!isset($entityResult['entityClass'])) {
|
||
throw MappingException::missingResultSetMappingEntity($this->name, $resultMapping['name']);
|
||
}
|
||
|
||
$entityResult['isSelfClass'] = false;
|
||
if ($entityResult['entityClass'] === '__CLASS__') {
|
||
|
||
$entityResult['isSelfClass'] = true;
|
||
$entityResult['entityClass'] = $this->name;
|
||
|
||
}
|
||
|
||
$entityResult['entityClass'] = $this->fullyQualifiedClassName($entityResult['entityClass']);
|
||
|
||
$resultMapping['entities'][$key]['entityClass'] = ltrim($entityResult['entityClass'], '\\');
|
||
$resultMapping['entities'][$key]['isSelfClass'] = $entityResult['isSelfClass'];
|
||
|
||
if (isset($entityResult['fields'])) {
|
||
foreach ($entityResult['fields'] as $k => $field) {
|
||
if (!isset($field['name'])) {
|
||
throw MappingException::missingResultSetMappingFieldName($this->name, $resultMapping['name']);
|
||
}
|
||
|
||
if (!isset($field['column'])) {
|
||
$fieldName = $field['name'];
|
||
if (strpos($fieldName, '.')) {
|
||
list(, $fieldName) = explode('.', $fieldName);
|
||
}
|
||
|
||
$resultMapping['entities'][$key]['fields'][$k]['column'] = $fieldName;
|
||
}
|
||
}
|
||
}
|
||
}
|
||
}
|
||
|
||
$this->sqlResultSetMappings[$resultMapping['name']] = $resultMapping;
|
||
}
|
||
|
||
/**
|
||
* Adds a one-to-one mapping.
|
||
*
|
||
* @param array $mapping The mapping.
|
||
*
|
||
* @return void
|
||
*/
|
||
public function mapOneToOne(array $mapping)
|
||
{
|
||
$mapping['type'] = self::ONE_TO_ONE;
|
||
$mapping = $this->_validateAndCompleteOneToOneMapping($mapping);
|
||
$this->_storeAssociationMapping($mapping);
|
||
}
|
||
|
||
/**
|
||
* Adds a one-to-many mapping.
|
||
*
|
||
* @param array $mapping The mapping.
|
||
*
|
||
* @return void
|
||
*/
|
||
public function mapOneToMany(array $mapping)
|
||
{
|
||
$mapping['type'] = self::ONE_TO_MANY;
|
||
$mapping = $this->_validateAndCompleteOneToManyMapping($mapping);
|
||
$this->_storeAssociationMapping($mapping);
|
||
}
|
||
|
||
/**
|
||
* Adds a many-to-one mapping.
|
||
*
|
||
* @param array $mapping The mapping.
|
||
*
|
||
* @return void
|
||
*/
|
||
public function mapManyToOne(array $mapping)
|
||
{
|
||
$mapping['type'] = self::MANY_TO_ONE;
|
||
// A many-to-one mapping is essentially a one-one backreference
|
||
$mapping = $this->_validateAndCompleteOneToOneMapping($mapping);
|
||
$this->_storeAssociationMapping($mapping);
|
||
}
|
||
|
||
/**
|
||
* Adds a many-to-many mapping.
|
||
*
|
||
* @param array $mapping The mapping.
|
||
*
|
||
* @return void
|
||
*/
|
||
public function mapManyToMany(array $mapping)
|
||
{
|
||
$mapping['type'] = self::MANY_TO_MANY;
|
||
$mapping = $this->_validateAndCompleteManyToManyMapping($mapping);
|
||
$this->_storeAssociationMapping($mapping);
|
||
}
|
||
|
||
/**
|
||
* Stores the association mapping.
|
||
*
|
||
* @param array $assocMapping
|
||
*
|
||
* @return void
|
||
*
|
||
* @throws MappingException
|
||
*/
|
||
protected function _storeAssociationMapping(array $assocMapping)
|
||
{
|
||
$sourceFieldName = $assocMapping['fieldName'];
|
||
|
||
$this->assertFieldNotMapped($sourceFieldName);
|
||
|
||
$this->associationMappings[$sourceFieldName] = $assocMapping;
|
||
}
|
||
|
||
/**
|
||
* Registers a custom repository class for the entity class.
|
||
*
|
||
* @param string $repositoryClassName The class name of the custom mapper.
|
||
*
|
||
* @return void
|
||
*/
|
||
public function setCustomRepositoryClass($repositoryClassName)
|
||
{
|
||
$this->customRepositoryClassName = $this->fullyQualifiedClassName($repositoryClassName);
|
||
}
|
||
|
||
/**
|
||
* Dispatches the lifecycle event of the given entity to the registered
|
||
* lifecycle callbacks and lifecycle listeners.
|
||
*
|
||
* @deprecated Deprecated since version 2.4 in favor of \Doctrine\ORM\Event\ListenersInvoker
|
||
*
|
||
* @param string $lifecycleEvent The lifecycle event.
|
||
* @param object $entity The Entity on which the event occurred.
|
||
*
|
||
* @return void
|
||
*/
|
||
public function invokeLifecycleCallbacks($lifecycleEvent, $entity)
|
||
{
|
||
foreach ($this->lifecycleCallbacks[$lifecycleEvent] as $callback) {
|
||
$entity->$callback();
|
||
}
|
||
}
|
||
|
||
/**
|
||
* Whether the class has any attached lifecycle listeners or callbacks for a lifecycle event.
|
||
*
|
||
* @param string $lifecycleEvent
|
||
*
|
||
* @return boolean
|
||
*/
|
||
public function hasLifecycleCallbacks($lifecycleEvent)
|
||
{
|
||
return isset($this->lifecycleCallbacks[$lifecycleEvent]);
|
||
}
|
||
|
||
/**
|
||
* Gets the registered lifecycle callbacks for an event.
|
||
*
|
||
* @param string $event
|
||
*
|
||
* @return array
|
||
*/
|
||
public function getLifecycleCallbacks($event)
|
||
{
|
||
return isset($this->lifecycleCallbacks[$event]) ? $this->lifecycleCallbacks[$event] : array();
|
||
}
|
||
|
||
/**
|
||
* Adds a lifecycle callback for entities of this class.
|
||
*
|
||
* @param string $callback
|
||
* @param string $event
|
||
*
|
||
* @return void
|
||
*/
|
||
public function addLifecycleCallback($callback, $event)
|
||
{
|
||
if (isset($this->lifecycleCallbacks[$event]) && in_array($callback, $this->lifecycleCallbacks[$event])) {
|
||
return;
|
||
}
|
||
|
||
$this->lifecycleCallbacks[$event][] = $callback;
|
||
}
|
||
|
||
/**
|
||
* Sets the lifecycle callbacks for entities of this class.
|
||
* Any previously registered callbacks are overwritten.
|
||
*
|
||
* @param array $callbacks
|
||
*
|
||
* @return void
|
||
*/
|
||
public function setLifecycleCallbacks(array $callbacks)
|
||
{
|
||
$this->lifecycleCallbacks = $callbacks;
|
||
}
|
||
|
||
/**
|
||
* Adds a entity listener for entities of this class.
|
||
*
|
||
* @param string $eventName The entity lifecycle event.
|
||
* @param string $class The listener class.
|
||
* @param string $method The listener callback method.
|
||
*
|
||
* @throws \Doctrine\ORM\Mapping\MappingException
|
||
*/
|
||
public function addEntityListener($eventName, $class, $method)
|
||
{
|
||
$class = $this->fullyQualifiedClassName($class);
|
||
$listener = array(
|
||
'class' => $class,
|
||
'method' => $method
|
||
);
|
||
|
||
if ( ! class_exists($class)) {
|
||
throw MappingException::entityListenerClassNotFound($class, $this->name);
|
||
}
|
||
|
||
if ( ! method_exists($class, $method)) {
|
||
throw MappingException::entityListenerMethodNotFound($class, $method, $this->name);
|
||
}
|
||
|
||
if (isset($this->entityListeners[$eventName]) && in_array($listener, $this->entityListeners[$eventName])) {
|
||
throw MappingException::duplicateEntityListener($class, $method, $this->name);
|
||
}
|
||
|
||
$this->entityListeners[$eventName][] = $listener;
|
||
}
|
||
|
||
/**
|
||
* Sets the discriminator column definition.
|
||
*
|
||
* @param array $columnDef
|
||
*
|
||
* @return void
|
||
*
|
||
* @throws MappingException
|
||
*
|
||
* @see getDiscriminatorColumn()
|
||
*/
|
||
public function setDiscriminatorColumn($columnDef)
|
||
{
|
||
if ($columnDef !== null) {
|
||
if ( ! isset($columnDef['name'])) {
|
||
throw MappingException::nameIsMandatoryForDiscriminatorColumns($this->name);
|
||
}
|
||
|
||
if (isset($this->fieldNames[$columnDef['name']])) {
|
||
throw MappingException::duplicateColumnName($this->name, $columnDef['name']);
|
||
}
|
||
|
||
if ( ! isset($columnDef['fieldName'])) {
|
||
$columnDef['fieldName'] = $columnDef['name'];
|
||
}
|
||
|
||
if ( ! isset($columnDef['type'])) {
|
||
$columnDef['type'] = "string";
|
||
}
|
||
|
||
if (in_array($columnDef['type'], array("boolean", "array", "object", "datetime", "time", "date"))) {
|
||
throw MappingException::invalidDiscriminatorColumnType($this->name, $columnDef['type']);
|
||
}
|
||
|
||
$this->discriminatorColumn = $columnDef;
|
||
}
|
||
}
|
||
|
||
/**
|
||
* Sets the discriminator values used by this class.
|
||
* Used for JOINED and SINGLE_TABLE inheritance mapping strategies.
|
||
*
|
||
* @param array $map
|
||
*
|
||
* @return void
|
||
*/
|
||
public function setDiscriminatorMap(array $map)
|
||
{
|
||
foreach ($map as $value => $className) {
|
||
$this->addDiscriminatorMapClass($value, $className);
|
||
}
|
||
}
|
||
|
||
/**
|
||
* Adds one entry of the discriminator map with a new class and corresponding name.
|
||
*
|
||
* @param string $name
|
||
* @param string $className
|
||
*
|
||
* @return void
|
||
*
|
||
* @throws MappingException
|
||
*/
|
||
public function addDiscriminatorMapClass($name, $className)
|
||
{
|
||
$className = $this->fullyQualifiedClassName($className);
|
||
$className = ltrim($className, '\\');
|
||
$this->discriminatorMap[$name] = $className;
|
||
|
||
if ($this->name === $className) {
|
||
$this->discriminatorValue = $name;
|
||
|
||
return;
|
||
}
|
||
|
||
if ( ! (class_exists($className) || interface_exists($className))) {
|
||
throw MappingException::invalidClassInDiscriminatorMap($className, $this->name);
|
||
}
|
||
|
||
if (is_subclass_of($className, $this->name) && ! in_array($className, $this->subClasses)) {
|
||
$this->subClasses[] = $className;
|
||
}
|
||
}
|
||
|
||
/**
|
||
* Checks whether the class has a named query with the given query name.
|
||
*
|
||
* @param string $queryName
|
||
*
|
||
* @return boolean
|
||
*/
|
||
public function hasNamedQuery($queryName)
|
||
{
|
||
return isset($this->namedQueries[$queryName]);
|
||
}
|
||
|
||
/**
|
||
* Checks whether the class has a named native query with the given query name.
|
||
*
|
||
* @param string $queryName
|
||
*
|
||
* @return boolean
|
||
*/
|
||
public function hasNamedNativeQuery($queryName)
|
||
{
|
||
return isset($this->namedNativeQueries[$queryName]);
|
||
}
|
||
|
||
/**
|
||
* Checks whether the class has a named native query with the given query name.
|
||
*
|
||
* @param string $name
|
||
*
|
||
* @return boolean
|
||
*/
|
||
public function hasSqlResultSetMapping($name)
|
||
{
|
||
return isset($this->sqlResultSetMappings[$name]);
|
||
}
|
||
|
||
/**
|
||
* {@inheritDoc}
|
||
*/
|
||
public function hasAssociation($fieldName)
|
||
{
|
||
return isset($this->associationMappings[$fieldName]);
|
||
}
|
||
|
||
/**
|
||
* {@inheritDoc}
|
||
*/
|
||
public function isSingleValuedAssociation($fieldName)
|
||
{
|
||
return isset($this->associationMappings[$fieldName]) &&
|
||
($this->associationMappings[$fieldName]['type'] & self::TO_ONE);
|
||
}
|
||
|
||
/**
|
||
* {@inheritDoc}
|
||
*/
|
||
public function isCollectionValuedAssociation($fieldName)
|
||
{
|
||
return isset($this->associationMappings[$fieldName]) &&
|
||
! ($this->associationMappings[$fieldName]['type'] & self::TO_ONE);
|
||
}
|
||
|
||
/**
|
||
* Is this an association that only has a single join column?
|
||
*
|
||
* @param string $fieldName
|
||
*
|
||
* @return bool
|
||
*/
|
||
public function isAssociationWithSingleJoinColumn($fieldName)
|
||
{
|
||
return (
|
||
isset($this->associationMappings[$fieldName]) &&
|
||
isset($this->associationMappings[$fieldName]['joinColumns'][0]) &&
|
||
!isset($this->associationMappings[$fieldName]['joinColumns'][1])
|
||
);
|
||
}
|
||
|
||
/**
|
||
* Returns the single association join column (if any).
|
||
*
|
||
* @param string $fieldName
|
||
*
|
||
* @return string
|
||
*
|
||
* @throws MappingException
|
||
*/
|
||
public function getSingleAssociationJoinColumnName($fieldName)
|
||
{
|
||
if ( ! $this->isAssociationWithSingleJoinColumn($fieldName)) {
|
||
throw MappingException::noSingleAssociationJoinColumnFound($this->name, $fieldName);
|
||
}
|
||
return $this->associationMappings[$fieldName]['joinColumns'][0]['name'];
|
||
}
|
||
|
||
/**
|
||
* Returns the single association referenced join column name (if any).
|
||
*
|
||
* @param string $fieldName
|
||
*
|
||
* @return string
|
||
*
|
||
* @throws MappingException
|
||
*/
|
||
public function getSingleAssociationReferencedJoinColumnName($fieldName)
|
||
{
|
||
if ( ! $this->isAssociationWithSingleJoinColumn($fieldName)) {
|
||
throw MappingException::noSingleAssociationJoinColumnFound($this->name, $fieldName);
|
||
}
|
||
return $this->associationMappings[$fieldName]['joinColumns'][0]['referencedColumnName'];
|
||
}
|
||
|
||
/**
|
||
* Used to retrieve a fieldname for either field or association from a given column.
|
||
*
|
||
* This method is used in foreign-key as primary-key contexts.
|
||
*
|
||
* @param string $columnName
|
||
*
|
||
* @return string
|
||
*
|
||
* @throws MappingException
|
||
*/
|
||
public function getFieldForColumn($columnName)
|
||
{
|
||
if (isset($this->fieldNames[$columnName])) {
|
||
return $this->fieldNames[$columnName];
|
||
} else {
|
||
foreach ($this->associationMappings as $assocName => $mapping) {
|
||
if ($this->isAssociationWithSingleJoinColumn($assocName) &&
|
||
$this->associationMappings[$assocName]['joinColumns'][0]['name'] == $columnName) {
|
||
|
||
return $assocName;
|
||
}
|
||
}
|
||
|
||
throw MappingException::noFieldNameFoundForColumn($this->name, $columnName);
|
||
}
|
||
}
|
||
|
||
/**
|
||
* Sets the ID generator used to generate IDs for instances of this class.
|
||
*
|
||
* @param \Doctrine\ORM\Id\AbstractIdGenerator $generator
|
||
*
|
||
* @return void
|
||
*/
|
||
public function setIdGenerator($generator)
|
||
{
|
||
$this->idGenerator = $generator;
|
||
}
|
||
|
||
/**
|
||
* Sets definition.
|
||
*
|
||
* @param array $definition
|
||
*
|
||
* @return void
|
||
*/
|
||
public function setCustomGeneratorDefinition(array $definition)
|
||
{
|
||
$this->customGeneratorDefinition = $definition;
|
||
}
|
||
|
||
/**
|
||
* Sets the definition of the sequence ID generator for this class.
|
||
*
|
||
* The definition must have the following structure:
|
||
* <code>
|
||
* array(
|
||
* 'sequenceName' => 'name',
|
||
* 'allocationSize' => 20,
|
||
* 'initialValue' => 1
|
||
* 'quoted' => 1
|
||
* )
|
||
* </code>
|
||
*
|
||
* @param array $definition
|
||
*
|
||
* @return void
|
||
*/
|
||
public function setSequenceGeneratorDefinition(array $definition)
|
||
{
|
||
if ( ! isset($definition['sequenceName'])) {
|
||
throw MappingException::missingSequenceName($this->name);
|
||
}
|
||
|
||
if ($definition['sequenceName'][0] == '`') {
|
||
$definition['sequenceName'] = trim($definition['sequenceName'], '`');
|
||
$definition['quoted'] = true;
|
||
}
|
||
|
||
$this->sequenceGeneratorDefinition = $definition;
|
||
}
|
||
|
||
/**
|
||
* Sets the version field mapping used for versioning. Sets the default
|
||
* value to use depending on the column type.
|
||
*
|
||
* @param array $mapping The version field mapping array.
|
||
*
|
||
* @return void
|
||
*
|
||
* @throws MappingException
|
||
*/
|
||
public function setVersionMapping(array &$mapping)
|
||
{
|
||
$this->isVersioned = true;
|
||
$this->versionField = $mapping['fieldName'];
|
||
|
||
if ( ! isset($mapping['default'])) {
|
||
if (in_array($mapping['type'], array('integer', 'bigint', 'smallint'))) {
|
||
$mapping['default'] = 1;
|
||
} else if ($mapping['type'] == 'datetime') {
|
||
$mapping['default'] = 'CURRENT_TIMESTAMP';
|
||
} else {
|
||
throw MappingException::unsupportedOptimisticLockingType($this->name, $mapping['fieldName'], $mapping['type']);
|
||
}
|
||
}
|
||
}
|
||
|
||
/**
|
||
* Sets whether this class is to be versioned for optimistic locking.
|
||
*
|
||
* @param boolean $bool
|
||
*
|
||
* @return void
|
||
*/
|
||
public function setVersioned($bool)
|
||
{
|
||
$this->isVersioned = $bool;
|
||
}
|
||
|
||
/**
|
||
* Sets the name of the field that is to be used for versioning if this class is
|
||
* versioned for optimistic locking.
|
||
*
|
||
* @param string $versionField
|
||
*
|
||
* @return void
|
||
*/
|
||
public function setVersionField($versionField)
|
||
{
|
||
$this->versionField = $versionField;
|
||
}
|
||
|
||
/**
|
||
* Marks this class as read only, no change tracking is applied to it.
|
||
*
|
||
* @return void
|
||
*/
|
||
public function markReadOnly()
|
||
{
|
||
$this->isReadOnly = true;
|
||
}
|
||
|
||
/**
|
||
* {@inheritDoc}
|
||
*/
|
||
public function getFieldNames()
|
||
{
|
||
return array_keys($this->fieldMappings);
|
||
}
|
||
|
||
/**
|
||
* {@inheritDoc}
|
||
*/
|
||
public function getAssociationNames()
|
||
{
|
||
return array_keys($this->associationMappings);
|
||
}
|
||
|
||
/**
|
||
* {@inheritDoc}
|
||
*
|
||
* @throws InvalidArgumentException
|
||
*/
|
||
public function getAssociationTargetClass($assocName)
|
||
{
|
||
if ( ! isset($this->associationMappings[$assocName])) {
|
||
throw new InvalidArgumentException("Association name expected, '" . $assocName ."' is not an association.");
|
||
}
|
||
|
||
return $this->associationMappings[$assocName]['targetEntity'];
|
||
}
|
||
|
||
/**
|
||
* {@inheritDoc}
|
||
*/
|
||
public function getName()
|
||
{
|
||
return $this->name;
|
||
}
|
||
|
||
/**
|
||
* Gets the (possibly quoted) identifier column names for safe use in an SQL statement.
|
||
*
|
||
* @deprecated Deprecated since version 2.3 in favor of \Doctrine\ORM\Mapping\QuoteStrategy
|
||
*
|
||
* @param \Doctrine\DBAL\Platforms\AbstractPlatform $platform
|
||
*
|
||
* @return array
|
||
*/
|
||
public function getQuotedIdentifierColumnNames($platform)
|
||
{
|
||
$quotedColumnNames = array();
|
||
|
||
foreach ($this->identifier as $idProperty) {
|
||
if (isset($this->fieldMappings[$idProperty])) {
|
||
$quotedColumnNames[] = isset($this->fieldMappings[$idProperty]['quoted'])
|
||
? $platform->quoteIdentifier($this->fieldMappings[$idProperty]['columnName'])
|
||
: $this->fieldMappings[$idProperty]['columnName'];
|
||
|
||
continue;
|
||
}
|
||
|
||
// Association defined as Id field
|
||
$joinColumns = $this->associationMappings[$idProperty]['joinColumns'];
|
||
$assocQuotedColumnNames = array_map(
|
||
function ($joinColumn) use ($platform) {
|
||
return isset($joinColumn['quoted'])
|
||
? $platform->quoteIdentifier($joinColumn['name'])
|
||
: $joinColumn['name'];
|
||
},
|
||
$joinColumns
|
||
);
|
||
|
||
$quotedColumnNames = array_merge($quotedColumnNames, $assocQuotedColumnNames);
|
||
}
|
||
|
||
return $quotedColumnNames;
|
||
}
|
||
|
||
/**
|
||
* Gets the (possibly quoted) column name of a mapped field for safe use in an SQL statement.
|
||
*
|
||
* @deprecated Deprecated since version 2.3 in favor of \Doctrine\ORM\Mapping\QuoteStrategy
|
||
*
|
||
* @param string $field
|
||
* @param \Doctrine\DBAL\Platforms\AbstractPlatform $platform
|
||
*
|
||
* @return string
|
||
*/
|
||
public function getQuotedColumnName($field, $platform)
|
||
{
|
||
return isset($this->fieldMappings[$field]['quoted'])
|
||
? $platform->quoteIdentifier($this->fieldMappings[$field]['columnName'])
|
||
: $this->fieldMappings[$field]['columnName'];
|
||
}
|
||
|
||
/**
|
||
* Gets the (possibly quoted) primary table name of this class for safe use in an SQL statement.
|
||
*
|
||
* @deprecated Deprecated since version 2.3 in favor of \Doctrine\ORM\Mapping\QuoteStrategy
|
||
*
|
||
* @param \Doctrine\DBAL\Platforms\AbstractPlatform $platform
|
||
*
|
||
* @return string
|
||
*/
|
||
public function getQuotedTableName($platform)
|
||
{
|
||
return isset($this->table['quoted']) ? $platform->quoteIdentifier($this->table['name']) : $this->table['name'];
|
||
}
|
||
|
||
/**
|
||
* Gets the (possibly quoted) name of the join table.
|
||
*
|
||
* @deprecated Deprecated since version 2.3 in favor of \Doctrine\ORM\Mapping\QuoteStrategy
|
||
*
|
||
* @param array $assoc
|
||
* @param \Doctrine\DBAL\Platforms\AbstractPlatform $platform
|
||
*
|
||
* @return string
|
||
*/
|
||
public function getQuotedJoinTableName(array $assoc, $platform)
|
||
{
|
||
return isset($assoc['joinTable']['quoted']) ? $platform->quoteIdentifier($assoc['joinTable']['name']) : $assoc['joinTable']['name'];
|
||
}
|
||
|
||
/**
|
||
* {@inheritDoc}
|
||
*/
|
||
public function isAssociationInverseSide($fieldName)
|
||
{
|
||
return isset($this->associationMappings[$fieldName]) && ! $this->associationMappings[$fieldName]['isOwningSide'];
|
||
}
|
||
|
||
/**
|
||
* {@inheritDoc}
|
||
*/
|
||
public function getAssociationMappedByTargetField($fieldName)
|
||
{
|
||
return $this->associationMappings[$fieldName]['mappedBy'];
|
||
}
|
||
|
||
/**
|
||
* @param string $targetClass
|
||
*
|
||
* @return array
|
||
*/
|
||
public function getAssociationsByTargetClass($targetClass)
|
||
{
|
||
$relations = array();
|
||
foreach ($this->associationMappings as $mapping) {
|
||
if ($mapping['targetEntity'] == $targetClass) {
|
||
$relations[$mapping['fieldName']] = $mapping;
|
||
}
|
||
}
|
||
return $relations;
|
||
}
|
||
|
||
/**
|
||
* @param string|null $className
|
||
* @return string|null null if the input value is null
|
||
*/
|
||
public function fullyQualifiedClassName($className)
|
||
{
|
||
if (empty($className)) {
|
||
return $className;
|
||
}
|
||
|
||
if ($className !== null && strpos($className, '\\') === false && strlen($this->namespace) > 0) {
|
||
return $this->namespace . '\\' . $className;
|
||
}
|
||
|
||
return $className;
|
||
}
|
||
|
||
/**
|
||
* @param string $name
|
||
*
|
||
* @return mixed
|
||
*/
|
||
public function getMetadataValue($name) {
|
||
|
||
if (isset($this->$name)) {
|
||
return $this->$name;
|
||
}
|
||
|
||
return null;
|
||
}
|
||
|
||
/**
|
||
* Map Embedded Class
|
||
*
|
||
* @param array $mapping
|
||
* @throws MappingException
|
||
* @return void
|
||
*/
|
||
public function mapEmbedded(array $mapping)
|
||
{
|
||
$this->assertFieldNotMapped($mapping['fieldName']);
|
||
|
||
$this->embeddedClasses[$mapping['fieldName']] = array(
|
||
'class' => $this->fullyQualifiedClassName($mapping['class']),
|
||
'columnPrefix' => $mapping['columnPrefix'],
|
||
'declaredField' => isset($mapping['declaredField']) ? $mapping['declaredField'] : null,
|
||
'originalField' => isset($mapping['originalField']) ? $mapping['originalField'] : null,
|
||
);
|
||
}
|
||
|
||
/**
|
||
* Inline the embeddable class
|
||
*
|
||
* @param string $property
|
||
* @param ClassMetadataInfo $embeddable
|
||
*/
|
||
public function inlineEmbeddable($property, ClassMetadataInfo $embeddable)
|
||
{
|
||
foreach ($embeddable->fieldMappings as $fieldMapping) {
|
||
$fieldMapping['originalClass'] = isset($fieldMapping['originalClass'])
|
||
? $fieldMapping['originalClass']
|
||
: $embeddable->name;
|
||
$fieldMapping['declaredField'] = isset($fieldMapping['declaredField'])
|
||
? $property . '.' . $fieldMapping['declaredField']
|
||
: $property;
|
||
$fieldMapping['originalField'] = isset($fieldMapping['originalField'])
|
||
? $fieldMapping['originalField']
|
||
: $fieldMapping['fieldName'];
|
||
$fieldMapping['fieldName'] = $property . "." . $fieldMapping['fieldName'];
|
||
|
||
if (! empty($this->embeddedClasses[$property]['columnPrefix'])) {
|
||
$fieldMapping['columnName'] = $this->embeddedClasses[$property]['columnPrefix'] . $fieldMapping['columnName'];
|
||
} elseif ($this->embeddedClasses[$property]['columnPrefix'] !== false) {
|
||
$fieldMapping['columnName'] = $this->namingStrategy
|
||
->embeddedFieldToColumnName(
|
||
$property,
|
||
$fieldMapping['columnName'],
|
||
$this->reflClass->name,
|
||
$embeddable->reflClass->name
|
||
);
|
||
}
|
||
|
||
$this->mapField($fieldMapping);
|
||
}
|
||
}
|
||
|
||
/**
|
||
* @param string $fieldName
|
||
* @throws MappingException
|
||
*/
|
||
private function assertFieldNotMapped($fieldName)
|
||
{
|
||
if (isset($this->fieldMappings[$fieldName]) ||
|
||
isset($this->associationMappings[$fieldName]) ||
|
||
isset($this->embeddedClasses[$fieldName])) {
|
||
|
||
throw MappingException::duplicateFieldMapping($this->name, $fieldName);
|
||
}
|
||
}
|
||
|
||
/**
|
||
* Gets the sequence name based on class metadata.
|
||
*
|
||
* @param AbstractPlatform $platform
|
||
* @return string
|
||
*
|
||
* @todo Sequence names should be computed in DBAL depending on the platform
|
||
*/
|
||
public function getSequenceName(AbstractPlatform $platform)
|
||
{
|
||
$sequencePrefix = $this->getSequencePrefix($platform);
|
||
|
||
$columnName = $this->getSingleIdentifierColumnName();
|
||
$sequenceName = $sequencePrefix . '_' . $columnName . '_seq';
|
||
|
||
return $sequenceName;
|
||
}
|
||
|
||
/**
|
||
* Gets the sequence name prefix based on class metadata.
|
||
*
|
||
* @param AbstractPlatform $platform
|
||
* @return string
|
||
*
|
||
* @todo Sequence names should be computed in DBAL depending on the platform
|
||
*/
|
||
public function getSequencePrefix(AbstractPlatform $platform)
|
||
{
|
||
$tableName = $this->getTableName();
|
||
$sequencePrefix = $tableName;
|
||
|
||
// Prepend the schema name to the table name if there is one
|
||
if ($schemaName = $this->getSchemaName()) {
|
||
$sequencePrefix = $schemaName . '.' . $tableName;
|
||
|
||
if ( ! $platform->supportsSchemas() && $platform->canEmulateSchemas()) {
|
||
$sequencePrefix = $schemaName . '__' . $tableName;
|
||
}
|
||
}
|
||
|
||
return $sequencePrefix;
|
||
}
|
||
}
|