PHP Class Doctrine\OXM\Mapping\ClassMetadataInfo

Since: 2.0

Author: Richard Fullmer ([email protected])

Inheritance: implements Doctrine\Common\Persistence\Mapping\ClassMetadata

Afficher le fichier Open project: doctrine/oxm Class Usage Examples

Méthodes publiques

Свойство	Type	Description
$changeTrackingPolicy	integer	READ-ONLY: The policy used for change-tracking on entities of this class.
$customRepositoryClassName	string	(Optional).
$fieldMappings	array	The mapping definition array supports the following keys: - fieldName (string) The name of the field in the entity this mapping is associated with - id (boolean, optional) Marks this field as the identifier for this class. Used for references - type (string) The type of the field being mapped by this field mapping. Can by any of the allowed Doctrine/OXM/Types or a specific Class name. If used with collection=true, this will assume that each collection object is of the specified type. - xmlName (string, optional) The name of the xml node this class definition will be mapped to. - xmlNode (string) The type of xml object to map this field. Can be one of ('element', 'attribute', or 'text') - required (boolean, optional) Defines if this field is required or not. Checked during marshalling and unmarshalling. - nullable (boolean, optional) Defines if this field is required to be marshalled/unmarshalled if null. - getMethod (string, optional) Defines an optional get method name to use while getting and setting this field on the owning object. - setMethod (string, optional) Defines an optional set method name to use while getting and setting this field on the owning object. - collection (boolean, optional) Define the field as a "collection". This allows for the field to be an array of the above specified type. - direct (boolean, optional, defaults to true) Allow Doctrine OXM to access this field on the class with direct access.
$generatorType	integer	READ-ONLY: The Id generator type used by the class.
$idGenerator	Doctrine\OXM\Id\AbstractIdGenerator	READ-ONLY: The ID generator used for generating IDs for this class.
$identifier		READ-ONLY: The field name of the class identifier.
$isMappedSuperclass	boolean	READ-ONLY: Whether this class describes the mapping of a mapped superclass.
$isRoot	boolean	READ-ONLY: Whether this class describes the mapping xml root element.
$lifecycleCallbacks	array	READ-ONLY: The registered lifecycle callbacks for entities of this class.
$name	string	The name of the class
$parentClasses	array	READ-ONLY: The names of the parent classes (ancestors).
$reflClass	ReflectionClass	The ReflectionClass instance of the mapped class.
$rootXmlEntityName	string	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}.
$xmlFieldMap	array	Mapping xml node names back to class fields keys are xml names
$xmlName	string	The xml node name to map this class to
$xmlNamespaces	array	The mapping definition array supports the following keys - url (required) The url containing this namespace definition. Only one URL can be present within the class which does not have a prefix. One can have any number of prefixed URL's. - prefix (optional) The prefix used by this namespace. Prefixes must be unique.

Méthodes publiques

Méthode	Description
__construct ( string $entityName )	Initializes a new ClassMetadata instance that will hold the object-xml mapping metadata of the class with the given name.
addInheritedFieldMapping ( array $fieldMapping )	INTERNAL: Adds a field mapping without completing/validating it.
addLifecycleCallback ( string $callback, string $event )	Adds a lifecycle callback for entities of this class.
getAssociationNames ( ) : array	A numerically indexed list of association names of this persistent class.
getAssociationTargetClass ( string $assocName ) : string	Returns the target class name of the given association.
getFieldMapping ( string $fieldName ) : array	Gets the mapping of a (regular) field that holds some data but not a reference to another object.
getFieldMappings ( ) : array	Returns an array of all field mappings
getFieldName ( string $xmlName ) : string	Gets the field name for a xml name.
getFieldNames ( ) : array	A numerically indexed list of field names of this persistent class.
getFieldXmlName ( $fieldName )
getFieldXmlNode ( $fieldName ) : string	Gets the type of an xml name.
getIdentifier ( ) : string	Gets the mapped identifier field of this class.
getName ( ) : string	The name of this XmlEntity class.
getParentClasses ( ) : array
getReflectionClass ( ) : ReflectionClass	Gets the ReflectionClass instance of the mapped class.
getTypeOfField ( string $fieldName ) : string	Gets the type of a field.
getXmlName ( ) : string	Gets the xml node name used to map this class to an xml node
getXmlNamespaces ( ) : array
getXmlNodeTypes ( ) : array	Returns all bind xml node types
hasAssociation ( string $fieldName ) : boolean	Checks whether the class has a mapped association (embed or reference) with the given field name.
hasField ( $fieldName ) : boolean	Checks whether the class has a (mapped) field with a certain name.
hasFieldWrapping ( $fieldName ) : boolean
hasLifecycleCallbacks ( string $lifecycleEvent ) : boolean	Whether the class has any attached lifecycle listeners or callbacks for a lifecycle event.
hasReference ( string $fieldName ) : boolean	Checks whether the class has a mapped association with the given field name.
hasXmlField ( $xmlName ) : boolean
invokeLifecycleCallbacks ( $lifecycleEvent, XmlEntity $entity, array $arguments = null )	Dispatches the lifecycle event of the given entity to the registered lifecycle callbacks and lifecycle listeners.
isChangeTrackingDeferredExplicit ( ) : boolean	Whether the change tracking policy of this class is "deferred explicit".
isChangeTrackingDeferredImplicit ( ) : boolean	Whether the change tracking policy of this class is "deferred implicit".
isChangeTrackingNotify ( ) : boolean	Whether the change tracking policy of this class is "notify".
isCollection ( $fieldName ) : boolean
isCollectionValuedAssociation ( string $fieldName ) : boolean	Checks whether the class has a mapped reference or embed for the specified field and is a single valued association.
isDirect ( $fieldName ) : boolean
isIdGeneratorAuto ( ) : boolean	Checks whether the class will generate a new \XmlId instance for us.
isIdGeneratorIncrement ( ) : boolean	Checks whether the class will use a collection to generate incremented identifiers.
isIdGeneratorNone ( ) : boolean	Checks whether the class uses no id generator.
isIdGeneratorUuid ( ) : boolean	Checks whether the class will generate a uuid id.
isIdentifier ( string $fieldName ) : boolean	Checks whether a field is part of the identifier/primary key field(s).
isInheritedField ( $fieldName ) : boolean	Checks whether a mapped field is inherited from an entity superclass.
isNullable ( string $fieldName ) : boolean
isRequired ( $fieldName ) : boolean
isSingleValuedAssociation ( string $fieldName ) : boolean	Checks whether the class has a mapped reference or embed for the specified field and is a single valued association.
mapField ( array $mapping ) : void
setChangeTrackingPolicy ( integer $policy )	Sets the change tracking policy used by this class.
setCustomRepositoryClass ( $repositoryClassName )	Registers a custom repository class for the document class.
setIdGenerator ( AbstractIdGenerator $generator )	Sets the ID generator used to generate IDs for instances of this class.
setIdGeneratorType ( $generatorType )	Sets the type of Id generator to use for the mapped class.
setIdentifier ( string $identifier )	INTERNAL: Sets the mapped identifier field of this class.
setLifecycleCallbacks ( array $callbacks )	Sets the lifecycle callbacks for entities of this class.
setName ( string $entityName )
setParentClasses ( array $classNames )	Sets the parent class names.
setXmlName ( $xmlName ) : string	Set the xml node name to be used by this class mapping
setXmlNamespaces ( array $xmlNamespaces ) : void

Méthodes protégées

Méthode	Description
inferGetter ( string $fieldName ) : string
inferSetter ( string $fieldName ) : string

Method Details

__construct() public méthode

Initializes a new ClassMetadata instance that will hold the object-xml mapping metadata of the class with the given name.

public __construct ( string $entityName )
$entityName	string	The name of the entity class the new instance is used for.

addInheritedFieldMapping() public méthode

This is mainly used to add inherited field mappings to derived classes.

public addInheritedFieldMapping ( array $fieldMapping )
$fieldMapping	array

addLifecycleCallback() public méthode

Note: If the same callback is registered more than once, the old one will be overridden.

public addLifecycleCallback ( string $callback, string $event )
$callback	string
$event	string

getAssociationNames() public méthode

This array includes identifier associations if present on this class.

public getAssociationNames ( ) : array
Résultat	array

getAssociationTargetClass() public méthode

Returns the target class name of the given association.

public getAssociationTargetClass ( string $assocName ) : string
$assocName	string
Résultat	string

getFieldMapping() public méthode

Gets the mapping of a (regular) field that holds some data but not a reference to another object.

public getFieldMapping ( string $fieldName ) : array
$fieldName	string	The field name.
Résultat	array	The field mapping.

getFieldMappings() public méthode

Returns an array of all field mappings

public getFieldMappings ( ) : array
Résultat	array

getFieldName() public méthode

If no field name can be found the xml name is returned.

public getFieldName ( string $xmlName ) : string
$xmlName	string	xml name
Résultat	string	field name

getFieldNames() public méthode

This array includes identifier fields if present on this class.

public getFieldNames ( ) : array
Résultat	array

getFieldXmlName() public méthode

public getFieldXmlName ( $fieldName )

getFieldXmlNode() public méthode

Gets the type of an xml name.

public getFieldXmlNode ( $fieldName ) : string
Résultat	string	one of ("node", "attribute", "text")

getIdentifier() public méthode

Gets the mapped identifier field of this class.

public getIdentifier ( ) : string
Résultat	string	$identifier

getName() public méthode

The name of this XmlEntity class.

public getName ( ) : string
Résultat	string	$name The XmlEntity class name.

getParentClasses() public méthode

public getParentClasses ( ) : array
Résultat	array

getReflectionClass() public méthode

Gets the ReflectionClass instance of the mapped class.

public getReflectionClass ( ) : ReflectionClass
Résultat	ReflectionClass

getTypeOfField() public méthode

Gets the type of a field.

public getTypeOfField ( string $fieldName ) : string
$fieldName	string
Résultat	string

getXmlName() public méthode

Gets the xml node name used to map this class to an xml node

public getXmlName ( ) : string
Résultat	string

getXmlNamespaces() public méthode

public getXmlNamespaces ( ) : array
Résultat	array

getXmlNodeTypes() public static méthode

Returns all bind xml node types

public static getXmlNodeTypes ( ) : array
Résultat	array

hasAssociation() public méthode

Checks whether the class has a mapped association (embed or reference) with the given field name.

public hasAssociation ( string $fieldName ) : boolean
$fieldName	string
Résultat	boolean

hasField() public méthode

Checks whether the class has a (mapped) field with a certain name.

public hasField ( $fieldName ) : boolean
Résultat	boolean

hasFieldWrapping() public méthode

public hasFieldWrapping ( $fieldName ) : boolean
Résultat	boolean

hasLifecycleCallbacks() public méthode

Whether the class has any attached lifecycle listeners or callbacks for a lifecycle event.

public hasLifecycleCallbacks ( string $lifecycleEvent ) : boolean
$lifecycleEvent	string
Résultat	boolean

hasReference() public méthode

Checks whether the class has a mapped association with the given field name.

public hasReference ( string $fieldName ) : boolean
$fieldName	string
Résultat	boolean

hasXmlField() public méthode

public hasXmlField ( $xmlName ) : boolean
Résultat	boolean

inferGetter() protected méthode

protected inferGetter ( string $fieldName ) : string
$fieldName	string
Résultat	string

inferSetter() protected méthode

protected inferSetter ( string $fieldName ) : string
$fieldName	string
Résultat	string

invokeLifecycleCallbacks() public méthode

Dispatches the lifecycle event of the given entity to the registered lifecycle callbacks and lifecycle listeners.

public invokeLifecycleCallbacks ( $lifecycleEvent, XmlEntity $entity, array $arguments = null )
$entity	XmlEntity	The XmlEntity on which the event occured.
$arguments	array

isChangeTrackingDeferredExplicit() public méthode

Whether the change tracking policy of this class is "deferred explicit".

public isChangeTrackingDeferredExplicit ( ) : boolean
Résultat	boolean

isChangeTrackingDeferredImplicit() public méthode

Whether the change tracking policy of this class is "deferred implicit".

public isChangeTrackingDeferredImplicit ( ) : boolean
Résultat	boolean

isChangeTrackingNotify() public méthode

Whether the change tracking policy of this class is "notify".

public isChangeTrackingNotify ( ) : boolean
Résultat	boolean

isCollection() public méthode

public isCollection ( $fieldName ) : boolean
Résultat	boolean

isCollectionValuedAssociation() public méthode

Checks whether the class has a mapped reference or embed for the specified field and is a single valued association.

public isCollectionValuedAssociation ( string $fieldName ) : boolean
$fieldName	string
Résultat	boolean	TRUE if the association exists and is single-valued, FALSE otherwise.

isDirect() public méthode

public isDirect ( $fieldName ) : boolean
Résultat	boolean

isIdGeneratorAuto() public méthode

Checks whether the class will generate a new \XmlId instance for us.

public isIdGeneratorAuto ( ) : boolean
Résultat	boolean	TRUE if the class uses the AUTO generator, FALSE otherwise.

isIdGeneratorIncrement() public méthode

Checks whether the class will use a collection to generate incremented identifiers.

public isIdGeneratorIncrement ( ) : boolean
Résultat	boolean	TRUE if the class uses the INCREMENT generator, FALSE otherwise.

isIdGeneratorNone() public méthode

Checks whether the class uses no id generator.

public isIdGeneratorNone ( ) : boolean
Résultat	boolean	TRUE if the class does not use any id generator, FALSE otherwise.

isIdGeneratorUuid() public méthode

Checks whether the class will generate a uuid id.

public isIdGeneratorUuid ( ) : boolean
Résultat	boolean	TRUE if the class uses the UUID generator, FALSE otherwise.

isIdentifier() public méthode

Checks whether a field is part of the identifier/primary key field(s).

public isIdentifier ( string $fieldName ) : boolean
$fieldName	string	The field name
Résultat	boolean	TRUE if the field is part of the table identifier/primary key field(s), FALSE otherwise.

isInheritedField() public méthode

Checks whether a mapped field is inherited from an entity superclass.

public isInheritedField ( $fieldName ) : boolean
Résultat	boolean	TRUE if the field is inherited, FALSE otherwise.

isNullable() public méthode

public isNullable ( string $fieldName ) : boolean
$fieldName	string
Résultat	boolean

isRequired() public méthode

public isRequired ( $fieldName ) : boolean
Résultat	boolean

isSingleValuedAssociation() public méthode

Checks whether the class has a mapped reference or embed for the specified field and is a single valued association.

public isSingleValuedAssociation ( string $fieldName ) : boolean
$fieldName	string
Résultat	boolean	TRUE if the association exists and is single-valued, FALSE otherwise.

mapField() public méthode

public mapField ( array $mapping ) : void
$mapping	array
Résultat	void

setChangeTrackingPolicy() public méthode

Sets the change tracking policy used by this class.

public setChangeTrackingPolicy ( integer $policy )
$policy	integer

setCustomRepositoryClass() public méthode

Registers a custom repository class for the document class.

public setCustomRepositoryClass ( $repositoryClassName )

setIdGenerator() public méthode

Sets the ID generator used to generate IDs for instances of this class.

public setIdGenerator ( AbstractIdGenerator $generator )
$generator	AbstractIdGenerator

setIdGeneratorType() public méthode

Sets the type of Id generator to use for the mapped class.

public setIdGeneratorType ( $generatorType )

setIdentifier() public méthode

INTERNAL: Sets the mapped identifier field of this class.

public setIdentifier ( string $identifier )
$identifier	string

setLifecycleCallbacks() public méthode

Any previously registered callbacks are overwritten.

public setLifecycleCallbacks ( array $callbacks )
$callbacks	array

setName() public méthode

public setName ( string $entityName )
$entityName	string

setParentClasses() public méthode

Assumes that the class names in the passed array are in the order: directParent -> directParentParent -> directParentParentParent ... -> root.

public setParentClasses ( array $classNames )
$classNames	array

setXmlName() public méthode

Set the xml node name to be used by this class mapping

public setXmlName ( $xmlName ) : string
Résultat	string

setXmlNamespaces() public méthode

public setXmlNamespaces ( array $xmlNamespaces ) : void
$xmlNamespaces	array
Résultat	void

Property Details

$changeTrackingPolicy public_oe property

READ-ONLY: The policy used for change-tracking on entities of this class.

public int $changeTrackingPolicy
Résultat	integer

$customRepositoryClassName public_oe property

(Optional).

public string $customRepositoryClassName
Résultat	string

$fieldMappings public_oe property

The mapping definition array supports the following keys: - fieldName (string) The name of the field in the entity this mapping is associated with - id (boolean, optional) Marks this field as the identifier for this class. Used for references - type (string) The type of the field being mapped by this field mapping. Can by any of the allowed Doctrine/OXM/Types or a specific Class name. If used with collection=true, this will assume that each collection object is of the specified type. - xmlName (string, optional) The name of the xml node this class definition will be mapped to. - xmlNode (string) The type of xml object to map this field. Can be one of ('element', 'attribute', or 'text') - required (boolean, optional) Defines if this field is required or not. Checked during marshalling and unmarshalling. - nullable (boolean, optional) Defines if this field is required to be marshalled/unmarshalled if null. - getMethod (string, optional) Defines an optional get method name to use while getting and setting this field on the owning object. - setMethod (string, optional) Defines an optional set method name to use while getting and setting this field on the owning object. - collection (boolean, optional) Define the field as a "collection". This allows for the field to be an array of the above specified type. - direct (boolean, optional, defaults to true) Allow Doctrine OXM to access this field on the class with direct access.

public array $fieldMappings
Résultat	array

$generatorType public_oe property

READ-ONLY: The Id generator type used by the class.

public int $generatorType
Résultat	integer

$idGenerator public_oe property

READ-ONLY: The ID generator used for generating IDs for this class.

public AbstractIdGenerator,Doctrine\OXM\Id $idGenerator
Résultat	Doctrine\OXM\Id\AbstractIdGenerator

$identifier public_oe property

READ-ONLY: The field name of the class identifier.

public $identifier

$isMappedSuperclass public_oe property

READ-ONLY: Whether this class describes the mapping of a mapped superclass.

public bool $isMappedSuperclass
Résultat	boolean

$isRoot public_oe property

READ-ONLY: Whether this class describes the mapping xml root element.

public bool $isRoot
Résultat	boolean

$lifecycleCallbacks public_oe property

READ-ONLY: The registered lifecycle callbacks for entities of this class.

public array $lifecycleCallbacks
Résultat	array

$name public_oe property

The name of the class

public string $name
Résultat	string

$parentClasses public_oe property

READ-ONLY: The names of the parent classes (ancestors).

public array $parentClasses
Résultat	array

$reflClass public_oe property

The ReflectionClass instance of the mapped class.

public ReflectionClass $reflClass
Résultat	ReflectionClass

$rootXmlEntityName public_oe property

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}.

public string $rootXmlEntityName
Résultat	string

$xmlFieldMap public_oe property

Mapping xml node names back to class fields keys are xml names

public array $xmlFieldMap
Résultat	array

$xmlName public_oe property

The xml node name to map this class to

public string $xmlName
Résultat	string

$xmlNamespaces public_oe property

The mapping definition array supports the following keys - url (required) The url containing this namespace definition. Only one URL can be present within the class which does not have a prefix. One can have any number of prefixed URL's. - prefix (optional) The prefix used by this namespace. Prefixes must be unique.

public array $xmlNamespaces
Résultat	array