vendor/api-platform/core/src/Core/DataProvider/OperationDataProviderTrait.php line 98

Open in your IDE?
  1. <?php
  3. /*
  4.  * This file is part of the API Platform project.
  5.  *
  6.  * (c) Kévin Dunglas <dunglas@gmail.com>
  7.  *
  8.  * For the full copyright and license information, please view the LICENSE
  9.  * file that was distributed with this source code.
  10.  */
  12. declare(strict_types=1);
  14. namespace ApiPlatform\Core\DataProvider;
  16. use ApiPlatform\Core\Identifier\CompositeIdentifierParser;
  17. use ApiPlatform\Core\Identifier\ContextAwareIdentifierConverterInterface;
  18. use ApiPlatform\Core\Identifier\IdentifierConverterInterface;
  19. use ApiPlatform\Exception\InvalidIdentifierException;
  20. use ApiPlatform\Exception\RuntimeException;
  22. /**
  23.  * @internal
  24.  */
  25. trait OperationDataProviderTrait
  26. {
  27.     /**
  28.      * @var CollectionDataProviderInterface
  29.      */
  30.     private $collectionDataProvider;
  32.     /**
  33.      * @var ItemDataProviderInterface
  34.      */
  35.     private $itemDataProvider;
  37.     /**
  38.      * @var SubresourceDataProviderInterface|null
  39.      */
  40.     private $subresourceDataProvider;
  42.     /**
  43.      * @var IdentifierConverterInterface|null
  44.      */
  45.     private $identifierConverter;
  47.     /**
  48.      * Retrieves data for a collection operation.
  49.      */
  50.     private function getCollectionData(array $attributes, array $context): iterable
  51.     {
  52.         return $this->collectionDataProvider->getCollection($attributes['resource_class'], $attributes['collection_operation_name'], $context);
  53.     }
  55.     /**
  56.      * Gets data for an item operation.
  57.      *
  58.      * @param mixed $identifiers
  59.      *
  60.      * @return object|null
  61.      */
  62.     private function getItemData($identifiers, array $attributes, array $context)
  63.     {
  64.         return $this->itemDataProvider->getItem($attributes['resource_class'], $identifiers, $attributes['item_operation_name'], $context);
  65.     }
  67.     /**
  68.      * Gets data for a nested operation.
  69.      *
  70.      * @param mixed $identifiers
  71.      *
  72.      * @throws RuntimeException
  73.      *
  74.      * @return array|object|null
  75.      */
  76.     private function getSubresourceData($identifiers, array $attributes, array $context)
  77.     {
  78.         if (null === $this->subresourceDataProvider) {
  79.             throw new RuntimeException('Subresources not supported');
  80.         }
  82.         // TODO: SubresourceDataProvider wants: ['id' => ['id' => 1], 'relatedDummies' => ['id' => 2]], identifiers is ['id' => 1, 'relatedDummies' => 2]
  83.         $subresourceIdentifiers = [];
  84.         foreach ($attributes['identifiers'] as $parameterName => [$class, $property]) {
  85.             if (false !== ($attributes['identifiers'][$parameterName][2] ?? null)) {
  86.                 $subresourceIdentifiers[$parameterName] = [$property => $identifiers[$parameterName]];
  87.             }
  88.         }
  90.         return $this->subresourceDataProvider->getSubresource($attributes['resource_class'], $subresourceIdentifiers, $attributes['subresource_context'] + $context, $attributes['subresource_operation_name']);
  91.     }
  93.     /**
  94.      * @param array $parameters - usually comes from $request->attributes->all()
  95.      *
  96.      * @throws InvalidIdentifierException
  97.      */
  98.     private function extractIdentifiers(array $parameters, array $attributes)
  99.     {
  100.         $identifiersKeys = $attributes['identifiers'] ?? ['id' => [$attributes['resource_class'], 'id']];
  101.         $identifiers = [];
  103.         $identifiersNumber = \count($identifiersKeys);
  104.         foreach ($identifiersKeys as $parameterName => $identifiedBy) {
  105.             if (!isset($parameters[$parameterName])) {
  106.                 if ($attributes['has_composite_identifier']) {
  107.                     $identifiers = CompositeIdentifierParser::parse($parameters['id']);
  108.                     if (($currentIdentifiersNumber = \count($identifiers)) !== $identifiersNumber) {
  109.                         throw new InvalidIdentifierException(sprintf('Expected %d identifiers, got %d', $identifiersNumber, $currentIdentifiersNumber));
  110.                     }
  112.                     return $this->identifierConverter->convert($identifiers, $identifiedBy[0]);
  113.                 }
  115.                 // TODO: Subresources tuple may have a third item representing if it is a "collection", this behavior will be removed in 3.0
  116.                 if (false === ($identifiedBy[2] ?? null)) {
  117.                     continue;
  118.                 }
  120.                 throw new InvalidIdentifierException(sprintf('Parameter "%s" not found', $parameterName));
  121.             }
  123.             $identifiers[$parameterName] = $parameters[$parameterName];
  124.         }
  126.         if ($this->identifierConverter instanceof ContextAwareIdentifierConverterInterface) {
  127.             return $this->identifierConverter->convert($identifiers, $attributes['resource_class'], ['identifiers' => $identifiersKeys]);
  128.         }
  130.         return $this->identifierConverter->convert($identifiers, $attributes['resource_class']);
  131.     }
  132. }