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

Public Member Functions
	__construct (private readonly ReflectionService $reflectionService, private readonly QueryObjectModelFactory $qomFactory, private readonly Session $persistenceSession, private readonly DataMapFactory $dataMapFactory, private readonly QueryFactoryInterface $queryFactory, private readonly EventDispatcherInterface $eventDispatcher, private readonly InstantiatorInterface $instantiator,)
	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|null { 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 (mixed $input, ?ColumnMap $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)
	createEmptyObject (string $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
QueryInterface null	$query

Private Member Functions
	thawObjectProperty (Property $propertySchema, ColumnMap $columnMap, DomainObjectInterface $parent, string $propertyName, mixed $propertyValue, ?string $targetClassName)

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 57 of file DataMapper.php.

Constructor & Destructor Documentation

__construct()

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

Definition at line 63 of file DataMapper.php.

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 789 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 801 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 762 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()

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

protected

Creates a skeleton of the specified object. This is designed to not call class constructor when hydrating, but do call initializeObject() if exists and obey eventually registered implementation overrides ("xclass").

Parameters

class-string

$className

‪Name of the class to create a skeleton for

Exceptions

InvalidClassException

‪@template T of DomainObjectInterface @phpstan-param class-string<T> $className @phpstan-return T

Definition at line 163 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 357 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\thawObjectProperty().

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 382 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|null { if ($columnMap->getChildSortByFieldName() !== null) { return [$columnMap-> TYPO3\CMS\Extbase\Persistence\Generic\Mapper\DataMapper::getChildSortByFieldName

(

)

Get orderings array for extbase query by columnMap

@phpstan-return array<non-empty-string, QueryInterface::ORDER_*>|null

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

string	$propertyName
string	$fieldValue
array	$relationTableMatchFields

Returns

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

Definition at line 515 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\DomainObject\AbstractDomainObject\PROPERTY_VERSIONED_UID, 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 775 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

string

$propertyName

Returns

‪array|null

Definition at line 391 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\getTypeOfRelation().

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

string	$propertyName
string	$fieldValue

Returns

‪Persistence\QueryResultInterface

Definition at line 403 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	(	mixed	$input,
		?ColumnMap	$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 | null	$columnMap	‪Optional column map for retrieving the date storage format.

Exceptions

Definition at line 859 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

string	$propertyName
string	$fieldValue

Returns

‪Persistence\QueryInterface

Definition at line 416 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\Generic\QuerySettingsInterface\getLanguageAspect(), 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\Core\Context\LanguageAspect\OVERLAYS_MIXED, TYPO3\CMS\Core\Context\LanguageAspect\OVERLAYS_OFF, TYPO3\CMS\Extbase\DomainObject\AbstractDomainObject\PROPERTY_LANGUAGE_UID, TYPO3\CMS\Extbase\Persistence\Generic\QuerySettingsInterface\setLanguageAspect(), 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

string

$propertyName

Returns

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

Definition at line 632 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) @phpstan-param class-string $className @phpstan-return class-string

Definition at line 106 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 823 of file DataMapper.php.

References TYPO3\CMS\Extbase\Reflection\ClassSchema\Exception\NoPropertyTypesException\create().

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 @template T of DomainObjectInterface @phpstan-param class-string<T> $className @phpstan-return list<T>

Definition at line 88 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 316 of file DataMapper.php.

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

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 330 of file DataMapper.php.

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

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

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 658 of file DataMapper.php.

References TYPO3\CMS\Extbase\Reflection\ClassSchema\Exception\NoPropertyTypesException\create(), 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\thawObjectProperty().

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

string	$propertyName
mixed	$result	‪The result

Returns

‪mixed

Definition at line 713 of file DataMapper.php.

References TYPO3\CMS\Extbase\Reflection\ClassSchema\Exception\NoPropertyTypesException\create().

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

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 @template T of DomainObjectInterface @phpstan-param class-string<T> $className @phpstan-return T

Definition at line 132 of file DataMapper.php.

References TYPO3\CMS\Webhooks\Message\$identifier, 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

string

$propertyName

Returns

‪bool TRUE if the property is mapped

Definition at line 700 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 591 of file DataMapper.php.

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

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

setQuery()

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

(

QueryInterface

$query

)

Definition at line 73 of file DataMapper.php.

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

thawObjectProperty()

TYPO3\CMS\Extbase\Persistence\Generic\Mapper\DataMapper::thawObjectProperty ( Property  $propertySchema, ColumnMap  $columnMap, DomainObjectInterface  $parent, string  $propertyName, mixed  $propertyValue, ?string  $targetClassName  )

private

Parameters

non-empty-string	$propertyName
class-string | null	$targetClassName

Definition at line 264 of file DataMapper.php.

References TYPO3\CMS\Extbase\Persistence\Generic\Mapper\DataMapper\fetchRelated(), TYPO3\CMS\Extbase\Persistence\Generic\Mapper\ColumnMap\getDateTimeStorageFormat(), TYPO3\CMS\Extbase\Utility\TypeHandlingUtility\isCoreType(), TYPO3\CMS\Extbase\Reflection\ClassSchema\Property\isNullable(), 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\thawProperties().

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

Exceptions

NonExistentPropertyException
UnknownPropertyTypeException

Definition at line 186 of file DataMapper.php.

References $GLOBALS, TYPO3\CMS\Extbase\DomainObject\DomainObjectInterface\_setProperty(), TYPO3\CMS\Extbase\Persistence\Generic\Mapper\DataMapper\getDataMap(), TYPO3\CMS\Extbase\DomainObject\AbstractDomainObject\PROPERTY_LANGUAGE_UID, TYPO3\CMS\Extbase\DomainObject\AbstractDomainObject\PROPERTY_LOCALIZED_UID, TYPO3\CMS\Extbase\DomainObject\AbstractDomainObject\PROPERTY_PID, TYPO3\CMS\Extbase\DomainObject\AbstractDomainObject\PROPERTY_UID, TYPO3\CMS\Extbase\DomainObject\AbstractDomainObject\PROPERTY_VERSIONED_UID, and TYPO3\CMS\Extbase\Persistence\Generic\Mapper\DataMapper\thawObjectProperty().

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

Member Data Documentation

$fields

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

Definition at line 484 of file DataMapper.php.

$orderings [1/2]

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

Definition at line 483 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 504 of file DataMapper.php.

$query

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

protected

Definition at line 61 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().