Proveedor y procesador reutilizable Entidad->Dto

One issue I came across with the generic/custom StateProcessor is that not all Entities use id/getId() as their identifier.

So in my DTO class, I leveraged the extraProperties array in the #[ApiResource] to expose that information to the StateProcessor.

The upside is that this works! The downside is that I already told ApiPlatform what my resource's ID is in my DTO class in the properties using the ApiProperty attribute. But there doesn't seem to be a way to get that information in the process method of the StateProcessor. Would be nice to not have to add this extraProperties config, but hey, this does the trick!

Any thoughts about gotchas with this approach?

DTO class

<?php

namespace App\ApiResource;

use ApiPlatform\Doctrine\Orm\State\Options;
use ApiPlatform\Metadata\ApiProperty;
use ApiPlatform\Metadata\ApiResource;
use App\Entity\Bookmark;
use App\Entity\User;
use App\State\DtoToEntityStateProcessor;
use App\State\EntityToDtoStateProvider;
use Ramsey\Uuid\UuidInterface;
use Symfony\Component\Serializer\Attribute\Ignore;

#[ApiResource(
    shortName: 'Bookmark',
    paginationItemsPerPage: 10,
    provider: EntityToDtoStateProvider::class,
    processor: DtoToEntityStateProcessor::class,
    stateOptions: new Options(
        entityClass: Bookmark::class,
    ),
    extraProperties: [
        'identifierProperty' => 'uuid',
        'identifierGetter' => 'getUuid',
    ],
)]
class BookmarkApi
{
    #[ApiProperty(identifier: false)]
    #[Ignore]
    public ?int $id = null;

    #[ApiProperty(identifier: true)]
    public ?UuidInterface $uuid = null;

    public ?string $title = null;

    public ?string $description = null;

    public ?User $createdBy = null;

    public ?User $updatedBy = null;
}

DtoToEntityStateProcessor class

<?php

namespace App\State;

use ApiPlatform\Doctrine\Common\State\PersistProcessor;
use ApiPlatform\Doctrine\Common\State\RemoveProcessor;
use ApiPlatform\Doctrine\Orm\State\Options;
use ApiPlatform\Metadata\DeleteOperationInterface;
use ApiPlatform\Metadata\Operation;
use ApiPlatform\State\ProcessorInterface;
use Symfony\Component\DependencyInjection\Attribute\Autowire;
use Symfonycasts\MicroMapper\MicroMapperInterface;

class DtoToEntityStateProcessor implements ProcessorInterface
{
    public function __construct(
        #[Autowire(service: PersistProcessor::class)]
        private PersistProcessor $persistProcessor,
        #[Autowire(service: RemoveProcessor::class)]
        private RemoveProcessor $removeProcessor,
        private MicroMapperInterface $microMapper,
    ) {
    }

    public function process(mixed $data, Operation $operation, array $uriVariables = [], array $context = [])
    {
        $stateOptions = $operation->getStateOptions();
        assert($stateOptions instanceof Options);

        $entityClass = $stateOptions->getEntityClass();

        $entity = $this->mapDtoToEntity($data, $entityClass);

        if ($operation instanceof DeleteOperationInterface) {
            $this->removeProcessor->process($entity, $operation, $uriVariables, $context);

            return null;
        }

        $this->persistProcessor->process($entity, $operation, $uriVariables, $context);

        // Allows custom identifiers to be set in the DTO class
        $extraProperties = $operation->getExtraProperties();
        $identifierProperty = $extraProperties['identifierProperty'] ?? 'id';
        $identifierGetter = $extraProperties['identifierGetter'] ?? 'getId';

        $data->{$identifierProperty} = $entity->{$identifierGetter}();
        return $data;
    }

    private function mapDtoToEntity(object $dto, string $entityClass): object
    {
        return $this->microMapper->map($dto, $entityClass);
    }
}