Nested DTO not deserialized

[MichaelKubovic]

API Platform version(s) affected: 2.5.3

Description

Having a resource that uses DTO for input and that class contains property that contains array of DTOs of other class.

Generated documentation says that the property has type of array of strings.

Sending a request actually makes the data of the nested dto available as an associative array, although I'd expect it to be deserialized into an object.

How to reproduce

/**
 * @ApiResource(
 *     collectionOperations={
 *          "post"={
 *              "status"=202,
 *              "input"=App\Command\CreateFoo::class,
 *              "output"=false
 *          },
 *     },
 *     itemOperations={},
 *     messenger="input",
 *     output=false,
 * )
 */
class TestResource
{
    // not important
    public $foo;
}

final class CreateFoo
{
   // not important
    public $name;

    /** @var CreateBar[] */
    public $bars = [];
}

final class CreateBar
{
    public $baz;
}

Possible Solution

Additional Context

[soyuka]

Would you be able to debug this a bit more? The denormalization of this is done here:

core/src/Serializer/AbstractItemNormalizer.php

Line 189 in 5fa9b56

$denormalizedInput = $this->serializer->denormalize($data, $inputClass, $format, $context);

It'd be interesting to know what it does when it encounters /** @var CreateBar[] */ I'm not sure that the denormalizer is aware that it is a collection of objects (doesn't read php docs).

[teohhanhui]

We have no way to know how to denormalize those objects. You'd have to do this in your DataTransformer.

[Kaspiman]

@teohhanhui I have the same issue (array of strings instead of array of DTO's) and wrote comment in this issue api-platform/api-platform#1202 (comment) with some debug experience.

Offtop: can you explain: all issues from template are not relevant now?

[Kaspiman]

@MichaelKubovic @teohhanhui I found the solution, you have to configure DocumentationNormalizer like this:

    api_platform.swagger.normalizer.documentation:
        arguments:
            $jsonSchemaTypeFactory: '@api_platform.json_schema.type_factory' # here is missing service