MediaTypeConverterInterface
interface MediaTypeConverterInterface implements TypeConverterInterface (View source)
A marker interface for type converters that are used to decode the content of a HTTP request
To extend the default media type conversion of HTTP requests, this interface can be implemented by a custom TypeConverter and then set as default implementation via Objects.yaml:
'Neos\Flow\Property\TypeConverter\MediaTypeConverterInterface'.className: Some\Custom\TypeConverter
Constants
| CONFIGURATION_MEDIA_TYPE |
Name of the configuration option that contains the expected media type. This is usually set by the ActionRequest and
corresponds to the browser's Content-Type header |
| DEFAULT_MEDIA_TYPE |
The default media type that should be used if no explicit media type was configured (see CONFIGURATION_MEDIA_TYPE) |
Methods
Returns the list of source types the TypeConverter can handle.
Return the target type this TypeConverter converts to.
Returns the type for a given source, depending on e.g. the __type setting or other properties.
Return the priority of this TypeConverter. TypeConverters with a high priority are chosen before low priority.
Here, the TypeConverter can do some additional runtime checks to see whether it can handle the given source data and the given target type.
Return a list of sub-properties inside the source object.
Return the type of a given sub-property inside the $targetType
Actually convert from $source to $targetType, taking into account the fully built $convertedChildProperties and $configuration.
Details
string[]
getSupportedSourceTypes()
Returns the list of source types the TypeConverter can handle.
Must be PHP simple types, classes or object is not allowed.
string
getSupportedTargetType()
Return the target type this TypeConverter converts to.
Can be a simple type or a class name.
string
getTargetTypeForSource(mixed $source, string $originalTargetType, PropertyMappingConfigurationInterface $configuration = null)
Returns the type for a given source, depending on e.g. the __type setting or other properties.
int
getPriority()
Return the priority of this TypeConverter. TypeConverters with a high priority are chosen before low priority.
bool
canConvertFrom(mixed $source, string $targetType)
Here, the TypeConverter can do some additional runtime checks to see whether it can handle the given source data and the given target type.
array
getSourceChildPropertiesToBeConverted(mixed $source)
Return a list of sub-properties inside the source object.
The "key" is the sub-property name, and the "value" is the value of the sub-property.
string
getTypeOfChildProperty(string $targetType, string $propertyName, PropertyMappingConfigurationInterface $configuration)
Return the type of a given sub-property inside the $targetType
mixed|null|Error
convertFrom(mixed $source, string $targetType, array $convertedChildProperties = [], PropertyMappingConfigurationInterface $configuration = null)
Actually convert from $source to $targetType, taking into account the fully built $convertedChildProperties and $configuration.
The return value can be one of three types:
- an arbitrary object, or a simple type (which has been created while mapping). This is the normal case.
- NULL, indicating that this object should not be mapped (i.e. a "File Upload" Converter could return NULL if no file has been uploaded, and a silent failure should occur.
- An instance of \Neos\Error\Messages\Error -- This will be a user-visible error message later on. Furthermore, it should throw an Exception if an unexpected failure (like a security error) occurred or a configuration issue happened.