vendor/api-platform/core/src/JsonLd/Serializer/ObjectNormalizer.php line 44

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\JsonLd\Serializer;
  16. use ApiPlatform\Api\IriConverterInterface;
  17. use ApiPlatform\Core\Api\IriConverterInterface as LegacyIriConverterInterface;
  18. use ApiPlatform\Exception\InvalidArgumentException;
  19. use ApiPlatform\JsonLd\AnonymousContextBuilderInterface;
  20. use Symfony\Component\Serializer\Normalizer\CacheableSupportsMethodInterface;
  21. use Symfony\Component\Serializer\Normalizer\NormalizerInterface;
  23. /**
  24. * Decorates the output with JSON-LD metadata when appropriate, but otherwise just
  25. * passes through to the decorated normalizer.
  26. */
  27. final class ObjectNormalizer implements NormalizerInterface, CacheableSupportsMethodInterface
  28. {
  29. use JsonLdContextTrait;
  31. public const FORMAT = 'jsonld';
  33. private $decorated;
  34. private $iriConverter;
  35. private $anonymousContextBuilder;
  37. public function __construct(NormalizerInterface $decorated, $iriConverter, AnonymousContextBuilderInterface $anonymousContextBuilder)
  38. {
  39. $this->decorated = $decorated;
  40. $this->iriConverter = $iriConverter;
  41. $this->anonymousContextBuilder = $anonymousContextBuilder;
  43. if ($iriConverter instanceof LegacyIriConverterInterface) {
  44. trigger_deprecation('api-platform/core', '2.7', sprintf('Use an implementation of "%s" instead of "%s".', IriConverterInterface::class, LegacyIriConverterInterface::class));
  45. }
  46. }
  48. public function supportsNormalization($data, $format = null, array $context = []): bool
  49. {
  50. return self::FORMAT === $format && $this->decorated->supportsNormalization($data, $format, $context);
  51. }
  53. public function hasCacheableSupportsMethod(): bool
  54. {
  55. return $this->decorated instanceof CacheableSupportsMethodInterface && $this->decorated->hasCacheableSupportsMethod();
  56. }
  58. /**
  59. * @param mixed|null $format
  60. *
  61. * @return array|string|int|float|bool|\ArrayObject|null
  62. */
  63. public function normalize($object, $format = null, array $context = [])
  64. {
  65. if (isset($context['api_resource'])) {
  66. $originalResource = $context['api_resource'];
  67. unset($context['api_resource']);
  68. }
  70. /*
  71. * Converts the normalized data array of a resource into an IRI, if the
  72. * normalized data array is empty.
  73. *
  74. * This is useful when traversing from a non-resource towards an attribute
  75. * which is a resource, as we do not have the benefit of {@see PropertyMetadata::isReadableLink}.
  76. *
  77. * It must not be propagated to subresources, as {@see PropertyMetadata::isReadableLink}
  78. * should take effect.
  79. */
  80. $context['api_empty_resource_as_iri'] = true;
  82. $data = $this->decorated->normalize($object, $format, $context);
  83. if (!\is_array($data) || !$data) {
  84. return $data;
  85. }
  87. if (isset($originalResource)) {
  88. try {
  89. $context['output']['iri'] = $this->iriConverter instanceof LegacyIriConverterInterface ? $this->iriConverter->getIriFromItem($originalResource) : $this->iriConverter->getIriFromResource($originalResource);
  90. } catch (InvalidArgumentException $e) {
  91. // The original resource has no identifiers
  92. }
  93. $context['api_resource'] = $originalResource;
  94. }
  96. $metadata = $this->createJsonLdContext($this->anonymousContextBuilder, $object, $context);
  98. return $metadata + $data;
  99. }
  100. }
  102. class_alias(ObjectNormalizer::class, \ApiPlatform\Core\JsonLd\Serializer\ObjectNormalizer::class);