TYPO3\CMS\Extbase\Persistence\Generic\Mapper\DataMapper Class Reference

Public Member Functions
	__construct (ReflectionService $reflectionService, QueryObjectModelFactory $qomFactory, Session $persistenceSession, DataMapFactory $dataMapFactory, QueryFactoryInterface $queryFactory, ObjectManagerInterface $objectManager, EventDispatcherInterface $eventDispatcher)
	setQuery (QueryInterface $query)
array	map ($className, array $rows)
string	getTargetType ($className, array $row)
TYPO3 CMS Extbase Persistence Generic LazyObjectStorage Persistence QueryResultInterface	fetchRelated (DomainObjectInterface $parentObject, $propertyName, $fieldValue='', $enableLazyLoading=true)
array< string, getOrderingsForColumnMap(ColumnMap $columnMap):?array { if( $columnMap->getChildSortByFieldName() !==null) { return[ $columnMap->	getChildSortByFieldName ()
mixed	mapResultToPropertyValue (DomainObjectInterface $parentObject, $propertyName, $result)
int	countRelated (DomainObjectInterface $parentObject, $propertyName, $fieldValue='')
DataMap	getDataMap ($className)
string	convertClassNameToTableName ($className)
string	convertPropertyNameToColumnName ($propertyName, $className=null)
string	getType ($parentClassName, $propertyName)
int string	getPlainValue ($input, $columnMap=null)

Public Attributes
if($columnMap->getChildTableDefaultSortings()===null)	$orderings = []
	$fields = QueryHelper::parseOrderBy($columnMap->getChildTableDefaultSortings())
foreach($fields as $field) return	$orderings == [] ? $orderings : null

Protected Member Functions
object	mapSingleRow ($className, array $row)
DomainObjectInterface	createEmptyObject ($className)
	thawProperties (DomainObjectInterface $object, array $row)
TYPO3 CMS Core Type TypeInterface	mapCoreType ($type, $value)
DateTimeInterface	mapDateTime ($value, $storageFormat=null, $targetType=\DateTime::class)
mixed	fetchRelatedEager (DomainObjectInterface $parentObject, $propertyName, $fieldValue='')
array null	getEmptyRelationValue (DomainObjectInterface $parentObject, $propertyName)
Persistence QueryResultInterface	getNonEmptyRelationValue (DomainObjectInterface $parentObject, $propertyName, $fieldValue)
Persistence QueryInterface	getPreparedQuery (DomainObjectInterface $parentObject, $propertyName, $fieldValue='')
TYPO3 CMS Extbase Persistence Generic Qom ConstraintInterface	getConstraint (QueryInterface $query, DomainObjectInterface $parentObject, $propertyName, $fieldValue='', $relationTableMatchFields=[])
array false mixed	resolveRelationValuesOfField (DataMap $dataMap, ColumnMap $columnMap, DomainObjectInterface $parentObject, $fieldValue, int $workspaceId)
TYPO3 CMS Extbase Persistence Generic Qom SourceInterface	getSource (DomainObjectInterface $parentObject, $propertyName)
mixed	mapObjectToClassProperty (DomainObjectInterface $parentObject, $propertyName, $fieldValue)
bool	propertyMapsByForeignKey (DomainObjectInterface $parentObject, $propertyName)

Protected Attributes
ReflectionService	$reflectionService
QueryObjectModelFactory	$qomFactory
Session	$persistenceSession
DataMapFactory	$dataMapFactory
QueryFactoryInterface	$queryFactory
ObjectManagerInterface	$objectManager
EventDispatcherInterface	$eventDispatcher
QueryInterface null	$query

Detailed Description

A mapper to map database tables configured in $TCA on domain objects.

only to be used within Extbase, not part of TYPO3 Core API.

Definition at line 50 of file DataMapper.php.

Constructor & Destructor Documentation

__construct()

TYPO3\CMS\Extbase\Persistence\Generic\Mapper\DataMapper::__construct	(	ReflectionService	$reflectionService,
		QueryObjectModelFactory	$qomFactory,
		Session	$persistenceSession,
		DataMapFactory	$dataMapFactory,
		QueryFactoryInterface	$queryFactory,
		ObjectManagerInterface	$objectManager,
		EventDispatcherInterface	$eventDispatcher
	)

Definition at line 65 of file DataMapper.php.

References TYPO3\CMS\Extbase\Persistence\Generic\Mapper\DataMapper\$dataMapFactory, TYPO3\CMS\Extbase\Persistence\Generic\Mapper\DataMapper\$eventDispatcher, TYPO3\CMS\Extbase\Persistence\Generic\Mapper\DataMapper\$objectManager, TYPO3\CMS\Extbase\Persistence\Generic\Mapper\DataMapper\$persistenceSession, TYPO3\CMS\Extbase\Persistence\Generic\Mapper\DataMapper\$qomFactory, TYPO3\CMS\Extbase\Persistence\Generic\Mapper\DataMapper\$queryFactory, and TYPO3\CMS\Extbase\Persistence\Generic\Mapper\DataMapper\$reflectionService.

Member Function Documentation

convertClassNameToTableName()

string TYPO3\CMS\Extbase\Persistence\Generic\Mapper\DataMapper::convertClassNameToTableName

(

$className

)

Returns the selector (table) name for a given class name.

Parameters

string

$className

Returns

‪string The selector name

Definition at line 729 of file DataMapper.php.

References TYPO3\CMS\Extbase\Persistence\Generic\Mapper\DataMapper\getDataMap(), and TYPO3\CMS\Extbase\Persistence\Generic\Mapper\DataMap\getTableName().

convertPropertyNameToColumnName()

string TYPO3\CMS\Extbase\Persistence\Generic\Mapper\DataMapper::convertPropertyNameToColumnName	(		$propertyName,
			$className = null
	)

Returns the column name for a given property name of the specified class.

Parameters

string	$propertyName
string	$className

Returns

‪string The column name

Definition at line 741 of file DataMapper.php.

References TYPO3\CMS\Core\Utility\GeneralUtility\camelCaseToLowerCaseUnderscored(), TYPO3\CMS\Extbase\Persistence\Generic\Mapper\ColumnMap\getColumnName(), and TYPO3\CMS\Extbase\Persistence\Generic\Mapper\DataMapper\getDataMap().

countRelated()

int TYPO3\CMS\Extbase\Persistence\Generic\Mapper\DataMapper::countRelated	(	DomainObjectInterface	$parentObject,
			$propertyName,
			$fieldValue = ''
	)

Counts the number of related objects assigned to a property of a parent object

Parameters

DomainObjectInterface	$parentObject	‪The object instance this proxy is part of
string	$propertyName	‪The name of the proxied property in it's parent
mixed	$fieldValue	‪The raw field value.

Returns

‪int

Definition at line 702 of file DataMapper.php.

References TYPO3\CMS\Extbase\Persistence\Generic\Mapper\DataMapper\$query, TYPO3\CMS\Extbase\Persistence\QueryInterface\execute(), and TYPO3\CMS\Extbase\Persistence\Generic\Mapper\DataMapper\getPreparedQuery().

createEmptyObject()

DomainObjectInterface TYPO3\CMS\Extbase\Persistence\Generic\Mapper\DataMapper::createEmptyObject (   $className )

protected

Creates a skeleton of the specified object

Parameters

string

$className

‪Name of the class to create a skeleton for

Exceptions

CannotReconstituteObjectException

Returns

‪DomainObjectInterface The object skeleton

Definition at line 161 of file DataMapper.php.

Referenced by TYPO3\CMS\Extbase\Persistence\Generic\Mapper\DataMapper\mapSingleRow().

fetchRelated()

TYPO3 CMS Extbase Persistence Generic LazyObjectStorage Persistence QueryResultInterface TYPO3\CMS\Extbase\Persistence\Generic\Mapper\DataMapper::fetchRelated	(	DomainObjectInterface	$parentObject,
			$propertyName,
			$fieldValue = '',
			$enableLazyLoading = true
	)

Fetches a collection of objects related to a property of a parent object

Parameters

DomainObjectInterface	$parentObject	‪The object instance this proxy is part of
string	$propertyName	‪The name of the proxied property in it's parent
mixed	$fieldValue	‪The raw field value.
bool	$enableLazyLoading	‪A flag indication if the related objects should be lazy loaded

Returns

‪\TYPO3\CMS\Extbase\Persistence\Generic\LazyObjectStorage|Persistence\QueryResultInterface The result

Definition at line 321 of file DataMapper.php.

References TYPO3\CMS\Extbase\Persistence\Generic\Mapper\DataMapper\fetchRelatedEager().

Referenced by TYPO3\CMS\Extbase\Persistence\Generic\Mapper\DataMapper\mapObjectToClassProperty(), and TYPO3\CMS\Extbase\Persistence\Generic\Mapper\DataMapper\thawProperties().

fetchRelatedEager()

mixed TYPO3\CMS\Extbase\Persistence\Generic\Mapper\DataMapper::fetchRelatedEager ( DomainObjectInterface  $parentObject,   $propertyName,   $fieldValue = ''  )

protected

Fetches the related objects from the storage backend.

Parameters

DomainObjectInterface	$parentObject	‪The object instance this proxy is part of
string	$propertyName	‪The name of the proxied property in it's parent
mixed	$fieldValue	‪The raw field value.

Returns

‪mixed

Definition at line 346 of file DataMapper.php.

References TYPO3\CMS\Extbase\Persistence\Generic\Mapper\DataMapper\getEmptyRelationValue(), and TYPO3\CMS\Extbase\Persistence\Generic\Mapper\DataMapper\getNonEmptyRelationValue().

Referenced by TYPO3\CMS\Extbase\Persistence\Generic\Mapper\DataMapper\fetchRelated().

getChildSortByFieldName()

array<string, getOrderingsForColumnMap(ColumnMap $columnMap): ?array { if ($columnMap->getChildSortByFieldName() !== null) { return [$columnMap-> TYPO3\CMS\Extbase\Persistence\Generic\Mapper\DataMapper::getChildSortByFieldName

(

)

Get orderings array for extbase query by columnMap

Returns

‪array<string, string>|null

getConstraint()

TYPO3 CMS Extbase Persistence Generic Qom ConstraintInterface TYPO3\CMS\Extbase\Persistence\Generic\Mapper\DataMapper::getConstraint ( QueryInterface  $query, DomainObjectInterface  $parentObject,   $propertyName,   $fieldValue = '',   $relationTableMatchFields = []  )

protected

Builds and returns the constraint for multi value properties.

Parameters

Persistence\QueryInterface	$query
DomainObjectInterface	$parentObject
string	$propertyName
string	$fieldValue
array	$relationTableMatchFields

Returns

‪\TYPO3\CMS\Extbase\Persistence\Generic\Qom\ConstraintInterface $constraint

Definition at line 475 of file DataMapper.php.

References TYPO3\CMS\Extbase\Persistence\Generic\Mapper\DataMapper\$query, TYPO3\CMS\Extbase\DomainObject\DomainObjectInterface\_getProperty(), TYPO3\CMS\Extbase\Persistence\QueryInterface\equals(), TYPO3\CMS\Extbase\Persistence\Generic\Mapper\DataMapper\getDataMap(), TYPO3\CMS\Extbase\Persistence\Generic\Mapper\ColumnMap\getParentKeyFieldName(), TYPO3\CMS\Extbase\Persistence\Generic\Mapper\ColumnMap\getParentTableFieldName(), TYPO3\CMS\Extbase\Persistence\QueryInterface\getQuerySettings(), TYPO3\CMS\Extbase\Persistence\QueryInterface\getSource(), TYPO3\CMS\Extbase\Persistence\Generic\Mapper\ColumnMap\getTypeOfRelation(), TYPO3\CMS\Extbase\Persistence\QueryInterface\in(), TYPO3\CMS\Core\Utility\GeneralUtility\intExplode(), TYPO3\CMS\Extbase\Persistence\QueryInterface\logicalAnd(), TYPO3\CMS\Extbase\Persistence\Generic\Mapper\ColumnMap\RELATION_HAS_AND_BELONGS_TO_MANY, TYPO3\CMS\Extbase\Persistence\Generic\Mapper\DataMapper\resolveRelationValuesOfField(), TYPO3\CMS\Extbase\Persistence\Generic\QuerySettingsInterface\setEnableFieldsToBeIgnored(), and TYPO3\CMS\Extbase\Persistence\Generic\QuerySettingsInterface\setIgnoreEnableFields().

Referenced by TYPO3\CMS\Extbase\Persistence\Generic\Mapper\DataMapper\getPreparedQuery().

getDataMap()

DataMap TYPO3\CMS\Extbase\Persistence\Generic\Mapper\DataMapper::getDataMap

(

$className

)

Returns a data map for a given class name

Parameters

string

$className

‪The class name you want to fetch the Data Map for

Exceptions

Persistence

Definition at line 715 of file DataMapper.php.

Referenced by TYPO3\CMS\Extbase\Persistence\Generic\Mapper\DataMapper\convertClassNameToTableName(), TYPO3\CMS\Extbase\Persistence\Generic\Mapper\DataMapper\convertPropertyNameToColumnName(), TYPO3\CMS\Extbase\Persistence\Generic\Mapper\DataMapper\getConstraint(), TYPO3\CMS\Extbase\Persistence\Generic\Mapper\DataMapper\getEmptyRelationValue(), TYPO3\CMS\Extbase\Persistence\Generic\Mapper\DataMapper\getPreparedQuery(), TYPO3\CMS\Extbase\Persistence\Generic\Mapper\DataMapper\getSource(), TYPO3\CMS\Extbase\Persistence\Generic\Mapper\DataMapper\getTargetType(), TYPO3\CMS\Extbase\Persistence\Generic\Mapper\DataMapper\propertyMapsByForeignKey(), and TYPO3\CMS\Extbase\Persistence\Generic\Mapper\DataMapper\thawProperties().

getEmptyRelationValue()

array null TYPO3\CMS\Extbase\Persistence\Generic\Mapper\DataMapper::getEmptyRelationValue ( DomainObjectInterface  $parentObject,   $propertyName  )

protected

Parameters

DomainObjectInterface	$parentObject
string	$propertyName

Returns

‪array|null

Definition at line 356 of file DataMapper.php.

References TYPO3\CMS\Extbase\Persistence\Generic\Mapper\DataMap\getColumnMap(), TYPO3\CMS\Extbase\Persistence\Generic\Mapper\DataMapper\getDataMap(), TYPO3\CMS\Extbase\Persistence\Generic\Mapper\ColumnMap\getTypeOfRelation(), and TYPO3\CMS\Extbase\Persistence\Generic\Mapper\ColumnMap\RELATION_HAS_ONE.

Referenced by TYPO3\CMS\Extbase\Persistence\Generic\Mapper\DataMapper\fetchRelatedEager(), and TYPO3\CMS\Extbase\Persistence\Generic\Mapper\DataMapper\mapObjectToClassProperty().

getNonEmptyRelationValue()

Persistence QueryResultInterface TYPO3\CMS\Extbase\Persistence\Generic\Mapper\DataMapper::getNonEmptyRelationValue ( DomainObjectInterface  $parentObject,   $propertyName,   $fieldValue  )

protected

Parameters

DomainObjectInterface	$parentObject
string	$propertyName
string	$fieldValue

Returns

‪Persistence\QueryResultInterface

Definition at line 369 of file DataMapper.php.

References TYPO3\CMS\Extbase\Persistence\Generic\Mapper\DataMapper\$query, TYPO3\CMS\Extbase\Persistence\QueryInterface\execute(), and TYPO3\CMS\Extbase\Persistence\Generic\Mapper\DataMapper\getPreparedQuery().

Referenced by TYPO3\CMS\Extbase\Persistence\Generic\Mapper\DataMapper\fetchRelatedEager().

getPlainValue()

int string TYPO3\CMS\Extbase\Persistence\Generic\Mapper\DataMapper::getPlainValue	(		$input,
			$columnMap = null
	)

Returns a plain value, i.e. objects are flattened out if possible. Multi value objects or arrays will be converted to a comma-separated list for use in IN SQL queries.

Parameters

mixed	$input	‪The value that will be converted.
ColumnMap	$columnMap	‪Optional column map for retrieving the date storage format.

Exceptions

Definition at line 791 of file DataMapper.php.

References TYPO3\CMS\Extbase\Persistence\Generic\Mapper\ColumnMap\getDateTimeStorageFormat(), TYPO3\CMS\Extbase\Utility\TypeHandlingUtility\isCoreType(), and TYPO3\CMS\Extbase\Utility\TypeHandlingUtility\isValidTypeForMultiValueComparison().

getPreparedQuery()

Persistence QueryInterface TYPO3\CMS\Extbase\Persistence\Generic\Mapper\DataMapper::getPreparedQuery ( DomainObjectInterface  $parentObject,   $propertyName,   $fieldValue = ''  )

protected

Builds and returns the prepared query, ready to be executed.

Parameters

DomainObjectInterface	$parentObject
string	$propertyName
string	$fieldValue

Returns

‪Persistence\QueryInterface

Definition at line 383 of file DataMapper.php.

References TYPO3\CMS\Extbase\Persistence\Generic\Mapper\DataMapper\$orderings, TYPO3\CMS\Extbase\Persistence\Generic\Mapper\DataMapper\$query, TYPO3\CMS\Extbase\DomainObject\DomainObjectInterface\_getProperty(), TYPO3\CMS\Extbase\Persistence\Generic\Mapper\DataMapper\getConstraint(), TYPO3\CMS\Extbase\Persistence\Generic\Mapper\DataMapper\getDataMap(), TYPO3\CMS\Extbase\Persistence\QueryInterface\getQuerySettings(), TYPO3\CMS\Extbase\Persistence\Generic\Mapper\DataMapper\getSource(), TYPO3\CMS\Extbase\Persistence\Generic\Mapper\DataMapper\getType(), TYPO3\CMS\Extbase\Persistence\QueryInterface\matching(), TYPO3\CMS\Extbase\Persistence\QueryInterface\ORDER_ASCENDING, TYPO3\CMS\Extbase\Persistence\Generic\Mapper\ColumnMap\RELATION_HAS_AND_BELONGS_TO_MANY, TYPO3\CMS\Extbase\Persistence\Generic\Mapper\ColumnMap\RELATION_HAS_MANY, TYPO3\CMS\Extbase\Persistence\Generic\QuerySettingsInterface\setLanguageOverlayMode(), TYPO3\CMS\Extbase\Persistence\Generic\QuerySettingsInterface\setLanguageUid(), TYPO3\CMS\Extbase\Persistence\QueryInterface\setOrderings(), TYPO3\CMS\Extbase\Persistence\Generic\QuerySettingsInterface\setRespectStoragePage(), TYPO3\CMS\Extbase\Persistence\Generic\QuerySettingsInterface\setRespectSysLanguage(), and TYPO3\CMS\Extbase\Persistence\QueryInterface\setSource().

Referenced by TYPO3\CMS\Extbase\Persistence\Generic\Mapper\DataMapper\countRelated(), and TYPO3\CMS\Extbase\Persistence\Generic\Mapper\DataMapper\getNonEmptyRelationValue().

getSource()

TYPO3 CMS Extbase Persistence Generic Qom SourceInterface TYPO3\CMS\Extbase\Persistence\Generic\Mapper\DataMapper::getSource ( DomainObjectInterface  $parentObject,   $propertyName  )

protected

Builds and returns the source to build a join for a m:n relation.

Parameters

DomainObjectInterface	$parentObject
string	$propertyName

Returns

‪\TYPO3\CMS\Extbase\Persistence\Generic\Qom\SourceInterface $source

Definition at line 592 of file DataMapper.php.

References TYPO3\CMS\Extbase\Persistence\Generic\Mapper\ColumnMap\getChildKeyFieldName(), TYPO3\CMS\Extbase\Persistence\Generic\Mapper\ColumnMap\getChildTableName(), TYPO3\CMS\Extbase\Persistence\Generic\Mapper\DataMap\getColumnMap(), TYPO3\CMS\Extbase\Persistence\Generic\Mapper\DataMapper\getDataMap(), TYPO3\CMS\Extbase\Persistence\Generic\Mapper\ColumnMap\getRelationTableName(), TYPO3\CMS\Extbase\Persistence\Generic\Mapper\DataMapper\getType(), and TYPO3\CMS\Extbase\Persistence\Generic\Query\JCR_JOIN_TYPE_INNER.

Referenced by TYPO3\CMS\Extbase\Persistence\Generic\Mapper\DataMapper\getPreparedQuery().

getTargetType()

string TYPO3\CMS\Extbase\Persistence\Generic\Mapper\DataMapper::getTargetType	(		$className,
		array	$row
	)

Returns the target type for the given row.

Parameters

string	$className	‪The name of the class
array	$row	‪A single array with field_name => value pairs

Returns

‪string The target type (a class name)

Definition at line 115 of file DataMapper.php.

References TYPO3\CMS\Extbase\Persistence\Generic\Mapper\DataMapper\getDataMap(), and TYPO3\CMS\Extbase\Persistence\Generic\Mapper\DataMap\getRecordType().

Referenced by TYPO3\CMS\Extbase\Persistence\Generic\Mapper\DataMapper\map().

getType()

string TYPO3\CMS\Extbase\Persistence\Generic\Mapper\DataMapper::getType	(		$parentClassName,
			$propertyName
	)

Returns the type of a child object.

Parameters

string	$parentClassName	‪The class name of the object this proxy is part of
string	$propertyName	‪The name of the proxied property in it's parent

Exceptions

UnexpectedTypeException

Returns

‪string The class name of the child object

Definition at line 763 of file DataMapper.php.

Referenced by TYPO3\CMS\Extbase\Persistence\Generic\Mapper\DataMapper\getPreparedQuery(), and TYPO3\CMS\Extbase\Persistence\Generic\Mapper\DataMapper\getSource().

map()

array TYPO3\CMS\Extbase\Persistence\Generic\Mapper\DataMapper::map	(		$className,
		array	$rows
	)

Maps the given rows on objects

Parameters

string	$className	‪The name of the class
array	$rows	‪An array of arrays with field_name => value pairs

Returns

‪array An array of objects of the given class

Definition at line 99 of file DataMapper.php.

References TYPO3\CMS\Extbase\Persistence\Generic\Mapper\DataMapper\getTargetType(), and TYPO3\CMS\Extbase\Persistence\Generic\Mapper\DataMapper\mapSingleRow().

mapCoreType()

TYPO3 CMS Core Type TypeInterface TYPO3\CMS\Extbase\Persistence\Generic\Mapper\DataMapper::mapCoreType (   $type,   $value  )

protected

Map value to a core type

Parameters

string	$type
mixed	$value

Returns

‪\TYPO3\CMS\Core\Type\TypeInterface

Definition at line 280 of file DataMapper.php.

Referenced by TYPO3\CMS\Extbase\Persistence\Generic\Mapper\DataMapper\thawProperties().

mapDateTime()

DateTimeInterface TYPO3\CMS\Extbase\Persistence\Generic\Mapper\DataMapper::mapDateTime (   $value,   $storageFormat = null,   $targetType = \DateTime::class  )

protected

Creates a DateTime from a unix timestamp or date/datetime/time value. If the input is empty, NULL is returned.

Parameters

int | string	$value	‪Unix timestamp or date/datetime/time value
string | null	$storageFormat	‪Storage format for native date/datetime/time fields
string	$targetType	‪The object class name to be created

Returns

‪\DateTimeInterface

Definition at line 294 of file DataMapper.php.

References TYPO3\CMS\Core\Database\Query\QueryHelper\getDateTimeTypes().

Referenced by TYPO3\CMS\Extbase\Persistence\Generic\Mapper\DataMapper\thawProperties().

mapObjectToClassProperty()

mixed TYPO3\CMS\Extbase\Persistence\Generic\Mapper\DataMapper::mapObjectToClassProperty ( DomainObjectInterface  $parentObject,   $propertyName,   $fieldValue  )

protected

Returns the mapped classProperty from the identityMap or mapResultToPropertyValue()

If the field value is empty and the column map has no parent key field name, the relation will be empty. If the persistence session has a registered object of the correct type and identity (fieldValue), this function returns that object. Otherwise, it proceeds with mapResultToPropertyValue().

Parameters

DomainObjectInterface	$parentObject
string	$propertyName
mixed	$fieldValue	‪the raw field value

Returns

‪mixed

See also

‪mapResultToPropertyValue()

Definition at line 618 of file DataMapper.php.

References TYPO3\CMS\Extbase\Persistence\Generic\Mapper\DataMapper\fetchRelated(), TYPO3\CMS\Extbase\Persistence\Generic\Mapper\DataMapper\getEmptyRelationValue(), TYPO3\CMS\Extbase\Persistence\Generic\Mapper\DataMapper\mapResultToPropertyValue(), and TYPO3\CMS\Extbase\Persistence\Generic\Mapper\DataMapper\propertyMapsByForeignKey().

Referenced by TYPO3\CMS\Extbase\Persistence\Generic\Mapper\DataMapper\thawProperties().

mapResultToPropertyValue()

mixed TYPO3\CMS\Extbase\Persistence\Generic\Mapper\DataMapper::mapResultToPropertyValue	(	DomainObjectInterface	$parentObject,
			$propertyName,
			$result
	)

Returns the given result as property value of the specified property type.

Parameters

DomainObjectInterface	$parentObject
string	$propertyName
mixed	$result	‪The result

Returns

‪mixed

Definition at line 659 of file DataMapper.php.

Referenced by TYPO3\CMS\Extbase\Persistence\Generic\Mapper\DataMapper\mapObjectToClassProperty(), and TYPO3\CMS\Extbase\Persistence\Generic\Mapper\DataMapper\thawProperties().

mapSingleRow()

object TYPO3\CMS\Extbase\Persistence\Generic\Mapper\DataMapper::mapSingleRow (   $className, array  $row  )

protected

Maps a single row on an object of the given class

Parameters

string	$className	‪The name of the target class
array	$row	‪A single array with field_name => value pairs

Returns

‪object An object of the given class

Definition at line 138 of file DataMapper.php.

References TYPO3\CMS\Extbase\Persistence\Generic\Mapper\DataMapper\createEmptyObject(), and TYPO3\CMS\Extbase\Persistence\Generic\Mapper\DataMapper\thawProperties().

Referenced by TYPO3\CMS\Extbase\Persistence\Generic\Mapper\DataMapper\map().

propertyMapsByForeignKey()

bool TYPO3\CMS\Extbase\Persistence\Generic\Mapper\DataMapper::propertyMapsByForeignKey ( DomainObjectInterface  $parentObject,   $propertyName  )

protected

Checks if the relation is based on a foreign key.

Parameters

DomainObjectInterface	$parentObject
string	$propertyName

Returns

‪bool TRUE if the property is mapped

Definition at line 645 of file DataMapper.php.

References TYPO3\CMS\Extbase\Persistence\Generic\Mapper\DataMap\getColumnMap(), TYPO3\CMS\Extbase\Persistence\Generic\Mapper\DataMapper\getDataMap(), and TYPO3\CMS\Extbase\Persistence\Generic\Mapper\ColumnMap\getParentKeyFieldName().

Referenced by TYPO3\CMS\Extbase\Persistence\Generic\Mapper\DataMapper\mapObjectToClassProperty().

resolveRelationValuesOfField()

array false mixed TYPO3\CMS\Extbase\Persistence\Generic\Mapper\DataMapper::resolveRelationValuesOfField ( DataMap  $dataMap, ColumnMap  $columnMap, DomainObjectInterface  $parentObject,   $fieldValue, int  $workspaceId  )

protected

This resolves relations via RelationHandler and returns their UIDs respectively, and works for MM/ForeignField/CSV in IRRE + Select + Group.

Note: This only happens for resolving properties for models. When limiting a parentQuery, the Typo3DbQueryParser is taking care of it.

By using the RelationHandler, the localized, deleted and moved records turn out to be properly resolved without having to build intermediate queries.

This is currently only used in workspaces' context, as it is 1 additional DB query needed.

Parameters

DataMap	$dataMap
ColumnMap	$columnMap
DomainObjectInterface	$parentObject
string	$fieldValue
int	$workspaceId

Returns

‪array|false|mixed

Definition at line 550 of file DataMapper.php.

References $GLOBALS, TYPO3\CMS\Extbase\DomainObject\DomainObjectInterface\_getProperty(), TYPO3\CMS\Extbase\Persistence\Generic\Mapper\ColumnMap\getColumnName(), TYPO3\CMS\Extbase\Persistence\Generic\Mapper\DataMap\getTableName(), and TYPO3\CMS\Extbase\DomainObject\DomainObjectInterface\getUid().

Referenced by TYPO3\CMS\Extbase\Persistence\Generic\Mapper\DataMapper\getConstraint().

setQuery()

TYPO3\CMS\Extbase\Persistence\Generic\Mapper\DataMapper::setQuery

(

QueryInterface

$query

)

Parameters

QueryInterface

$query

Definition at line 87 of file DataMapper.php.

References TYPO3\CMS\Extbase\Persistence\Generic\Mapper\DataMapper\$query.

thawProperties()

TYPO3\CMS\Extbase\Persistence\Generic\Mapper\DataMapper::thawProperties ( DomainObjectInterface  $object, array  $row  )

protected

Sets the given properties on the object.

Parameters

DomainObjectInterface	$object	‪The object to set properties on
array	$row

Exceptions

NonExistentPropertyException
UnknownPropertyTypeException

Definition at line 182 of file DataMapper.php.

References $GLOBALS, TYPO3\CMS\Extbase\DomainObject\DomainObjectInterface\_setProperty(), TYPO3\CMS\Extbase\Persistence\Generic\Mapper\DataMapper\fetchRelated(), TYPO3\CMS\Extbase\Persistence\Generic\Mapper\DataMapper\getDataMap(), TYPO3\CMS\Extbase\Utility\TypeHandlingUtility\isCoreType(), TYPO3\CMS\Extbase\Persistence\Generic\Mapper\DataMapper\mapCoreType(), TYPO3\CMS\Extbase\Persistence\Generic\Mapper\DataMapper\mapDateTime(), TYPO3\CMS\Extbase\Persistence\Generic\Mapper\DataMapper\mapObjectToClassProperty(), and TYPO3\CMS\Extbase\Persistence\Generic\Mapper\DataMapper\mapResultToPropertyValue().

Referenced by TYPO3\CMS\Extbase\Persistence\Generic\Mapper\DataMapper\mapSingleRow().

Member Data Documentation

$dataMapFactory

DataMapFactory TYPO3\CMS\Extbase\Persistence\Generic\Mapper\DataMapper::$dataMapFactory

protected

Definition at line 55 of file DataMapper.php.

Referenced by TYPO3\CMS\Extbase\Persistence\Generic\Mapper\DataMapper\__construct().

$eventDispatcher

EventDispatcherInterface TYPO3\CMS\Extbase\Persistence\Generic\Mapper\DataMapper::$eventDispatcher

protected

Definition at line 59 of file DataMapper.php.

Referenced by TYPO3\CMS\Extbase\Persistence\Generic\Mapper\DataMapper\__construct().

$fields

TYPO3\CMS\Extbase\Persistence\Generic\Mapper\DataMapper::$fields = QueryHelper::parseOrderBy($columnMap->getChildTableDefaultSortings())

Definition at line 442 of file DataMapper.php.

$objectManager

ObjectManagerInterface TYPO3\CMS\Extbase\Persistence\Generic\Mapper\DataMapper::$objectManager

protected

Definition at line 58 of file DataMapper.php.

Referenced by TYPO3\CMS\Extbase\Persistence\Generic\Mapper\DataMapper\__construct().

$orderings [1/2]

if ( $columnMap->getChildTableDefaultSortings()===null) TYPO3\CMS\Extbase\Persistence\Generic\Mapper\DataMapper::$orderings = []

Definition at line 441 of file DataMapper.php.

Referenced by TYPO3\CMS\Extbase\Persistence\Generic\Mapper\DataMapper\getPreparedQuery().

$orderings [2/2]

foreach ( $fields as $field) return TYPO3\CMS\Extbase\Persistence\Generic\Mapper\DataMapper::$orderings == [] ? $orderings : null

Definition at line 462 of file DataMapper.php.

$persistenceSession

Session TYPO3\CMS\Extbase\Persistence\Generic\Mapper\DataMapper::$persistenceSession

protected

Definition at line 54 of file DataMapper.php.

Referenced by TYPO3\CMS\Extbase\Persistence\Generic\Mapper\DataMapper\__construct().

$qomFactory

QueryObjectModelFactory TYPO3\CMS\Extbase\Persistence\Generic\Mapper\DataMapper::$qomFactory

protected

Definition at line 53 of file DataMapper.php.

Referenced by TYPO3\CMS\Extbase\Persistence\Generic\Mapper\DataMapper\__construct().

$query

QueryInterface null TYPO3\CMS\Extbase\Persistence\Generic\Mapper\DataMapper::$query

protected

Definition at line 63 of file DataMapper.php.

Referenced by TYPO3\CMS\Extbase\Persistence\Generic\Mapper\DataMapper\countRelated(), TYPO3\CMS\Extbase\Persistence\Generic\Mapper\DataMapper\getConstraint(), TYPO3\CMS\Extbase\Persistence\Generic\Mapper\DataMapper\getNonEmptyRelationValue(), TYPO3\CMS\Extbase\Persistence\Generic\Mapper\DataMapper\getPreparedQuery(), and TYPO3\CMS\Extbase\Persistence\Generic\Mapper\DataMapper\setQuery().

$queryFactory

QueryFactoryInterface TYPO3\CMS\Extbase\Persistence\Generic\Mapper\DataMapper::$queryFactory

protected

Definition at line 56 of file DataMapper.php.

Referenced by TYPO3\CMS\Extbase\Persistence\Generic\Mapper\DataMapper\__construct().

$reflectionService

ReflectionService TYPO3\CMS\Extbase\Persistence\Generic\Mapper\DataMapper::$reflectionService

protected

Definition at line 52 of file DataMapper.php.

Referenced by TYPO3\CMS\Extbase\Persistence\Generic\Mapper\DataMapper\__construct().