FileReferenceConverter

class \TYPO3\CMS\Extbase\Property\TypeConverter\FileReferenceConverter

Extends
AbstractFileFolderConverter

Converter which transforms simple types to \TYPO3\CMS\Extbase\Domain\Model\FileReference.

Table of Contents

Properties

$expectedObjectType  : string
$fileFactory  : ResourceFactory

Methods

convertFrom()  : mixed|Error
Actually convert from $source to $targetType, taking into account the fully built $convertedChildProperties and $configuration.
getSourceChildPropertiesToBeConverted()  : array
Return a list of sub-properties inside the source object.
getTargetTypeForSource()  : string
Returns the type for a given source, depending on e.g. the __type setting or other properties.
getTypeOfChildProperty()  : string
Return the type of a given sub-property inside the $targetType
injectFileFactory()  : void
getOriginalResource()  : ResourceInterface|null

Properties

$expectedObjectType

protected string $expectedObjectType = \TYPO3\CMS\Core\Resource\FileReference::class

Methods

convertFrom()

Actually convert from $source to $targetType, taking into account the fully built $convertedChildProperties and $configuration.

public convertFrom(string|int $source, string $targetType[, array $convertedChildProperties = [] ][, PropertyMappingConfigurationInterface|null $configuration = null ]) : mixed|Error

Parameters

$source : string|int
$targetType : string
$convertedChildProperties : array = []
$configuration : PropertyMappingConfigurationInterface|null = null

Tags

throws
Exception

Return values

mixed|Error —

the target type, or an error object if a user-error occurred

getSourceChildPropertiesToBeConverted()

Return a list of sub-properties inside the source object.

public getSourceChildPropertiesToBeConverted(mixed $source) : array

Parameters

$source : mixed

Tags

todo

this method is only used for converter sources that have children (i.e. objects). Introduce another ChildPropertyAwareTypeConverterInterface and drop this method from the main interface

Returns an empty list of sub property names

Return values

array

getTargetTypeForSource()

Returns the type for a given source, depending on e.g. the __type setting or other properties.

public getTargetTypeForSource(mixed $source, string $originalTargetType[, PropertyMappingConfigurationInterface|null $configuration = null ]) : string

Parameters

$source : mixed

the source data

$originalTargetType : string

the type we originally want to convert to

$configuration : PropertyMappingConfigurationInterface|null = null

Tags

todo

The concept of this method is flawed because it enables the override of the target type depending on the structure of the source. So, technically we no longer convert type A to B but source of type A with structure X to type B defined by X. This makes a type converter non-deterministic.

Returns the $originalTargetType unchanged in this implementation.

Return values

string

getTypeOfChildProperty()

Return the type of a given sub-property inside the $targetType

public getTypeOfChildProperty(string $targetType, string $propertyName, PropertyMappingConfigurationInterface $configuration) : string

Parameters

$targetType : string
$propertyName : string
$configuration : PropertyMappingConfigurationInterface

Tags

todo

this method is only used for converter sources that have children (i.e. objects). Introduce another ChildPropertyAwareTypeConverterInterface and drop this method from the main interface

This method is never called, as getSourceChildPropertiesToBeConverted() returns an empty array.

Return values

string —

the type of $propertyName in $targetType

On this page