ClassMetadataFactory
extends ClassMetadataFactory
in package
The ClassMetadataFactory is used to create ClassMetadata objects that contain all the metadata mapping information of a class which describes how a class should be mapped to a relational database.
Table of Contents
Properties
- $cacheSalt : string
- Salt used by specific Object Manager implementation.
- $initialized : bool
- $cache : CacheItemPoolInterface|null
- $driver : MappingDriver
- $em : EntityManagerInterface|null
- $embeddablesActiveNesting : array<string|int, mixed>
- $evm : EventManager
- $loadedMetadata : array<string, ClassMetadata>
- $proxyClassNameResolver : ProxyClassNameResolver|null
- $reflectionService : ReflectionService|null
- $targetPlatform : AbstractPlatform|null
Methods
- getAllMetadata() : array<string|int, ClassMetadata>
- Forces the factory to load the metadata of all classes known to the underlying mapping driver.
- getLoadedMetadata() : array<string|int, ClassMetadata>
- Returns an array of all the loaded metadata currently in memory.
- getMetadataFor() : ClassMetadata
- Gets the class metadata descriptor for a class.
- getReflectionService() : ReflectionService
- Gets the reflection service associated with this metadata factory.
- hasMetadataFor() : bool
- Checks whether the factory has the metadata for a class loaded already.
- isTransient() : bool
- Returns whether the class with the specified name should have its metadata loaded.
- setCache() : void
- setEntityManager() : void
- setMetadataFor() : void
- Sets the metadata descriptor for a specific class.
- setProxyClassNameResolver() : void
- setReflectionService() : void
- Sets the reflectionService.
- doLoadMetadata() : void
- Actually loads the metadata from the underlying metadata.
- getCache() : CacheItemPoolInterface|null
- getCacheKey() : string
- getDriver() : MappingDriver
- Returns the mapping driver implementation.
- getFqcnFromAlias() : class-string
- getParentClasses() : array<string|int, string>
- Gets an array of parent classes for the given entity class.
- initialize() : void
- Lazy initialization of this stuff, especially the metadata driver, since these are not needed at all when a metadata cache is active.
- initializeReflection() : void
- Initializes Reflection after ClassMetadata was constructed.
- isEntity() : bool
- Checks whether the class metadata is an entity.
- loadMetadata() : array<int, string>
- Loads the metadata of the class in question and all it's ancestors whose metadata is still not loaded.
- newClassMetadataInstance() : ClassMetadata<string|int, T>
- Creates a new ClassMetadata instance for the given class name.
- onNotFoundMetadata() : ClassMetadata|null
- Provides a fallback hook for loading metadata when loading failed due to reflection/mapping exceptions
- validateRuntimeMetadata() : void
- Validate runtime metadata is correctly defined.
- wakeupReflection() : void
- Wakes up reflection after ClassMetadata gets unserialized from cache.
- addDefaultDiscriminatorMap() : void
- Adds a default discriminator map if no one is given
- addInheritedEmbeddedClasses() : void
- addInheritedFields() : void
- Adds inherited fields to the subclass mapping.
- addInheritedIndexes() : void
- Copy the table indices from the parent class superclass to the child class
- addInheritedNamedNativeQueries() : void
- Adds inherited named native queries to the subclass mapping.
- addInheritedNamedQueries() : void
- Adds inherited named queries to the subclass mapping.
- addInheritedRelations() : void
- Adds inherited association mappings to the subclass mapping.
- addInheritedSqlResultSetMappings() : void
- Adds inherited sql result set mappings to the subclass mapping.
- addMappingInheritanceInformation() : void
- Puts the `inherited` and `declared` values into mapping information for fields, associations and embedded classes.
- addNestedEmbeddedClasses() : void
- Adds nested embedded classes metadata to a parent class.
- completeIdGeneratorMapping() : void
- Completes the ID generator mapping. If "auto" is specified we choose the generator most appropriate for the targeted database platform.
- createDefaultProxyClassNameResolver() : void
- determineIdGeneratorStrategy() : int
- findAbstractEntityClassesNotListedInDiscriminatorMap() : void
- getRealClass() : string
- Gets the real class name of a class name that could be a proxy.
- getShortName() : string
- Gets the lower-case short name of a class.
- getTargetPlatform() : AbstractPlatform
- inheritIdGeneratorMapping() : void
- Inherits the ID generator mapping from a parent class.
- normalizeClassName() : string
- Removes the prepended backslash of a class string to conform with how php outputs class names
- peekIfIsMappedSuperclass() : bool
- truncateSequenceName() : string
Properties
$cacheSalt
Salt used by specific Object Manager implementation.
protected
string
$cacheSalt
= '__CLASSMETADATA__'
$initialized
protected
bool
$initialized
= false
$cache
private
CacheItemPoolInterface|null
$cache
$driver
private
MappingDriver
$driver
$em
private
EntityManagerInterface|null
$em
$embeddablesActiveNesting
private
array<string|int, mixed>
$embeddablesActiveNesting
= []
$evm
private
EventManager
$evm
$loadedMetadata
private
array<string, ClassMetadata>
$loadedMetadata
= []
Tags
$proxyClassNameResolver
private
ProxyClassNameResolver|null
$proxyClassNameResolver
= null
$reflectionService
private
ReflectionService|null
$reflectionService
= null
$targetPlatform
private
AbstractPlatform|null
$targetPlatform
Methods
getAllMetadata()
Forces the factory to load the metadata of all classes known to the underlying mapping driver.
public
getAllMetadata() : array<string|int, ClassMetadata>
Return values
array<string|int, ClassMetadata> —The ClassMetadata instances of all mapped classes.
getLoadedMetadata()
Returns an array of all the loaded metadata currently in memory.
public
getLoadedMetadata() : array<string|int, ClassMetadata>
Tags
Return values
array<string|int, ClassMetadata>getMetadataFor()
Gets the class metadata descriptor for a class.
public
getMetadataFor(string $className) : ClassMetadata
Parameters
- $className : string
-
The name of the class.
Tags
Return values
ClassMetadatagetReflectionService()
Gets the reflection service associated with this metadata factory.
public
getReflectionService() : ReflectionService
Return values
ReflectionServicehasMetadataFor()
Checks whether the factory has the metadata for a class loaded already.
public
hasMetadataFor(string $className) : bool
Parameters
- $className : string
Return values
bool —TRUE if the metadata of the class in question is already loaded, FALSE otherwise.
isTransient()
Returns whether the class with the specified name should have its metadata loaded.
public
isTransient(string $className) : bool
Parameters
- $className : string
Return values
boolsetCache()
public
setCache(CacheItemPoolInterface $cache) : void
Parameters
- $cache : CacheItemPoolInterface
setEntityManager()
public
setEntityManager(EntityManagerInterface $em) : void
Parameters
- $em : EntityManagerInterface
setMetadataFor()
Sets the metadata descriptor for a specific class.
public
setMetadataFor(string $className, ClassMetadata $class) : void
NOTE: This is only useful in very special cases, like when generating proxy classes.
Parameters
- $className : string
- $class : ClassMetadata
Tags
setProxyClassNameResolver()
public
setProxyClassNameResolver(ProxyClassNameResolver $resolver) : void
Parameters
- $resolver : ProxyClassNameResolver
setReflectionService()
Sets the reflectionService.
public
setReflectionService(ReflectionService $reflectionService) : void
Parameters
- $reflectionService : ReflectionService
doLoadMetadata()
Actually loads the metadata from the underlying metadata.
protected
doLoadMetadata(mixed $class, mixed $parent, mixed $rootEntityFound, array<string|int, mixed> $nonSuperclassParents) : void
Parameters
- $class : mixed
- $parent : mixed
- $rootEntityFound : mixed
-
True when there is another entity (non-mapped superclass) class above the current class in the PHP class hierarchy.
- $nonSuperclassParents : array<string|int, mixed>
-
All parent class names that are not marked as mapped superclasses, with the direct parent class being the first and the root entity class the last element.
getCache()
protected
final getCache() : CacheItemPoolInterface|null
Return values
CacheItemPoolInterface|nullgetCacheKey()
protected
getCacheKey(string $realClassName) : string
Parameters
- $realClassName : string
Return values
stringgetDriver()
Returns the mapping driver implementation.
protected
abstract getDriver() : MappingDriver
Return values
MappingDrivergetFqcnFromAlias()
protected
getFqcnFromAlias(mixed $namespaceAlias, mixed $simpleClassName) : class-string
Parameters
- $namespaceAlias : mixed
- $simpleClassName : mixed
Tags
Return values
class-stringgetParentClasses()
Gets an array of parent classes for the given entity class.
protected
getParentClasses(string $name) : array<string|int, string>
Parameters
- $name : string
Tags
Return values
array<string|int, string>initialize()
Lazy initialization of this stuff, especially the metadata driver, since these are not needed at all when a metadata cache is active.
protected
abstract initialize() : void
initializeReflection()
Initializes Reflection after ClassMetadata was constructed.
protected
abstract initializeReflection(ClassMetadata $class, ReflectionService $reflService) : void
Parameters
- $class : ClassMetadata
- $reflService : ReflectionService
Tags
isEntity()
Checks whether the class metadata is an entity.
protected
abstract isEntity(ClassMetadata $class) : bool
This method should return false for mapped superclasses or embedded classes.
Parameters
- $class : ClassMetadata
Tags
Return values
boolloadMetadata()
Loads the metadata of the class in question and all it's ancestors whose metadata is still not loaded.
protected
loadMetadata(string $name) : array<int, string>
Important: The class $name does not necessarily exist at this point here. Scenarios in a code-generation setup might have access to XML/YAML Mapping files without the actual PHP code existing here. That is why the ReflectionService interface should be used for reflection.
Parameters
- $name : string
-
The name of the class for which the metadata should get loaded.
Tags
Return values
array<int, string>newClassMetadataInstance()
Creates a new ClassMetadata instance for the given class name.
protected
abstract newClassMetadataInstance(string $className) : ClassMetadata<string|int, T>
Parameters
- $className : string
Tags
Return values
ClassMetadata<string|int, T>onNotFoundMetadata()
Provides a fallback hook for loading metadata when loading failed due to reflection/mapping exceptions
protected
onNotFoundMetadata(string $className) : ClassMetadata|null
Override this method to implement a fallback strategy for failed metadata loading
Parameters
- $className : string
Tags
Return values
ClassMetadata|nullvalidateRuntimeMetadata()
Validate runtime metadata is correctly defined.
protected
validateRuntimeMetadata(ClassMetadata $class, ClassMetadata|null $parent) : void
Parameters
- $class : ClassMetadata
- $parent : ClassMetadata|null
Tags
wakeupReflection()
Wakes up reflection after ClassMetadata gets unserialized from cache.
protected
abstract wakeupReflection(ClassMetadata $class, ReflectionService $reflService) : void
Parameters
- $class : ClassMetadata
- $reflService : ReflectionService
Tags
addDefaultDiscriminatorMap()
Adds a default discriminator map if no one is given
private
addDefaultDiscriminatorMap(ClassMetadata $class) : void
If an entity is of any inheritance type and does not contain a discriminator map, then the map is generated automatically. This process is expensive computation wise.
The automatically generated discriminator map contains the lowercase short name of each class as key.
Parameters
- $class : ClassMetadata
Tags
addInheritedEmbeddedClasses()
private
addInheritedEmbeddedClasses(ClassMetadata $subClass, ClassMetadata $parentClass) : void
Parameters
- $subClass : ClassMetadata
- $parentClass : ClassMetadata
addInheritedFields()
Adds inherited fields to the subclass mapping.
private
addInheritedFields(ClassMetadata $subClass, ClassMetadata $parentClass) : void
Parameters
- $subClass : ClassMetadata
- $parentClass : ClassMetadata
addInheritedIndexes()
Copy the table indices from the parent class superclass to the child class
private
addInheritedIndexes(ClassMetadata $subClass, ClassMetadata $parentClass) : void
Parameters
- $subClass : ClassMetadata
- $parentClass : ClassMetadata
addInheritedNamedNativeQueries()
Adds inherited named native queries to the subclass mapping.
private
addInheritedNamedNativeQueries(ClassMetadata $subClass, ClassMetadata $parentClass) : void
Parameters
- $subClass : ClassMetadata
- $parentClass : ClassMetadata
addInheritedNamedQueries()
Adds inherited named queries to the subclass mapping.
private
addInheritedNamedQueries(ClassMetadata $subClass, ClassMetadata $parentClass) : void
Parameters
- $subClass : ClassMetadata
- $parentClass : ClassMetadata
addInheritedRelations()
Adds inherited association mappings to the subclass mapping.
private
addInheritedRelations(ClassMetadata $subClass, ClassMetadata $parentClass) : void
Parameters
- $subClass : ClassMetadata
- $parentClass : ClassMetadata
Tags
addInheritedSqlResultSetMappings()
Adds inherited sql result set mappings to the subclass mapping.
private
addInheritedSqlResultSetMappings(ClassMetadata $subClass, ClassMetadata $parentClass) : void
Parameters
- $subClass : ClassMetadata
- $parentClass : ClassMetadata
addMappingInheritanceInformation()
Puts the `inherited` and `declared` values into mapping information for fields, associations and embedded classes.
private
addMappingInheritanceInformation(AssociationMapping|EmbeddedClassMapping|FieldMapping &$mapping, ClassMetadata $parentClass) : void
Parameters
- $mapping : AssociationMapping|EmbeddedClassMapping|FieldMapping
- $parentClass : ClassMetadata
addNestedEmbeddedClasses()
Adds nested embedded classes metadata to a parent class.
private
addNestedEmbeddedClasses(ClassMetadata $subClass, ClassMetadata $parentClass, string $prefix) : void
Parameters
- $subClass : ClassMetadata
-
Sub embedded class metadata to add nested embedded classes metadata from.
- $parentClass : ClassMetadata
-
Parent class to add nested embedded classes metadata to.
- $prefix : string
-
Embedded classes' prefix to use for nested embedded classes field names.
completeIdGeneratorMapping()
Completes the ID generator mapping. If "auto" is specified we choose the generator most appropriate for the targeted database platform.
private
completeIdGeneratorMapping(ClassMetadataInfo $class) : void
Parameters
- $class : ClassMetadataInfo
Tags
createDefaultProxyClassNameResolver()
private
createDefaultProxyClassNameResolver() : void
determineIdGeneratorStrategy()
private
determineIdGeneratorStrategy(AbstractPlatform $platform) : int
Parameters
- $platform : AbstractPlatform
Tags
Return values
intfindAbstractEntityClassesNotListedInDiscriminatorMap()
private
findAbstractEntityClassesNotListedInDiscriminatorMap(ClassMetadata $rootEntityClass) : void
Parameters
- $rootEntityClass : ClassMetadata
getRealClass()
Gets the real class name of a class name that could be a proxy.
private
getRealClass(string $class) : string
Parameters
- $class : string
Tags
Return values
stringgetShortName()
Gets the lower-case short name of a class.
private
getShortName(string $className) : string
Parameters
- $className : string
Tags
Return values
stringgetTargetPlatform()
private
getTargetPlatform() : AbstractPlatform
Return values
AbstractPlatforminheritIdGeneratorMapping()
Inherits the ID generator mapping from a parent class.
private
inheritIdGeneratorMapping(ClassMetadataInfo $class, ClassMetadataInfo $parent) : void
Parameters
- $class : ClassMetadataInfo
- $parent : ClassMetadataInfo
normalizeClassName()
Removes the prepended backslash of a class string to conform with how php outputs class names
private
normalizeClassName(string $className) : string
Parameters
- $className : string
Tags
Return values
stringpeekIfIsMappedSuperclass()
private
peekIfIsMappedSuperclass(class-string $className) : bool
Parameters
- $className : class-string
Return values
booltruncateSequenceName()
private
truncateSequenceName(string $schemaElementName) : string
Parameters
- $schemaElementName : string