class FieldNormalizer

Same name in this branch
  1. 9 core/modules/serialization/src/Normalizer/FieldNormalizer.php \Drupal\serialization\Normalizer\FieldNormalizer
  2. 9 core/modules/hal/src/Normalizer/FieldNormalizer.php \Drupal\hal\Normalizer\FieldNormalizer
Same name in other branches
  1. 8.9.x core/modules/jsonapi/src/Normalizer/FieldNormalizer.php \Drupal\jsonapi\Normalizer\FieldNormalizer
  2. 8.9.x core/modules/serialization/src/Normalizer/FieldNormalizer.php \Drupal\serialization\Normalizer\FieldNormalizer
  3. 8.9.x core/modules/hal/src/Normalizer/FieldNormalizer.php \Drupal\hal\Normalizer\FieldNormalizer
  4. 10 core/modules/jsonapi/src/Normalizer/FieldNormalizer.php \Drupal\jsonapi\Normalizer\FieldNormalizer
  5. 10 core/modules/serialization/src/Normalizer/FieldNormalizer.php \Drupal\serialization\Normalizer\FieldNormalizer
  6. 11.x core/modules/jsonapi/src/Normalizer/FieldNormalizer.php \Drupal\jsonapi\Normalizer\FieldNormalizer
  7. 11.x core/modules/serialization/src/Normalizer/FieldNormalizer.php \Drupal\serialization\Normalizer\FieldNormalizer

Converts the Drupal field structure to a JSON:API array structure.

@internal JSON:API maintains no PHP API since its API is the HTTP API. This class may change at any time and this will break any dependencies on it.

Hierarchy

  • class \Drupal\serialization\Normalizer\NormalizerBase implements \Symfony\Component\Serializer\SerializerAwareInterface, \Drupal\serialization\Normalizer\CacheableNormalizerInterface, \Symfony\Component\Serializer\Normalizer\CacheableSupportsMethodInterface uses \Symfony\Component\Serializer\SerializerAwareTrait
    • class \Drupal\jsonapi\Normalizer\NormalizerBase extends \Drupal\serialization\Normalizer\NormalizerBase
      • class \Drupal\jsonapi\Normalizer\FieldNormalizer extends \Drupal\jsonapi\Normalizer\NormalizerBase implements \Symfony\Component\Serializer\Normalizer\DenormalizerInterface

Expanded class hierarchy of FieldNormalizer

See also

https://www.drupal.org/project/drupal/issues/3032787

jsonapi.api.php

1 string reference to 'FieldNormalizer'
jsonapi.services.yml in core/modules/jsonapi/jsonapi.services.yml
core/modules/jsonapi/jsonapi.services.yml
1 service uses FieldNormalizer
serializer.normalizer.field.jsonapi in core/modules/jsonapi/jsonapi.services.yml
Drupal\jsonapi\Normalizer\FieldNormalizer

File

core/modules/jsonapi/src/Normalizer/FieldNormalizer.php, line 21

Namespace

Drupal\jsonapi\Normalizer
View source
class FieldNormalizer extends NormalizerBase implements DenormalizerInterface {
    
    /**
     * The interface or class that this Normalizer supports.
     *
     * @var string
     */
    protected $supportedInterfaceOrClass = FieldItemListInterface::class;
    
    /**
     * {@inheritdoc}
     */
    public function normalize($field, $format = NULL, array $context = []) {
        
        /** @var \Drupal\Core\Field\FieldItemListInterface $field */
        $normalized_items = $this->normalizeFieldItems($field, $format, $context);
        assert($context['resource_object'] instanceof ResourceObject);
        return $context['resource_object']->getResourceType()
            ->getFieldByInternalName($field->getName())
            ->hasOne() ? array_shift($normalized_items) ?: CacheableNormalization::permanent(NULL) : CacheableNormalization::aggregate($normalized_items);
    }
    
    /**
     * {@inheritdoc}
     */
    public function denormalize($data, $class, $format = NULL, array $context = []) {
        $field_definition = $context['field_definition'];
        assert($field_definition instanceof FieldDefinitionInterface);
        $resource_type = $context['resource_type'];
        assert($resource_type instanceof ResourceType);
        // If $data contains items (recognizable by numerical array keys, which
        // Drupal's Field API calls "deltas"), then it already is itemized; it's not
        // using the simplified JSON structure that JSON:API generates.
        $is_already_itemized = is_array($data) && array_reduce(array_keys($data), function ($carry, $index) {
            return $carry && is_numeric($index);
        }, TRUE);
        $itemized_data = $is_already_itemized ? $data : [
            0 => $data,
        ];
        // Single-cardinality fields don't need itemization.
        $field_item_class = $field_definition->getItemDefinition()
            ->getClass();
        if (count($itemized_data) === 1 && $resource_type->getFieldByInternalName($field_definition->getName())
            ->hasOne()) {
            return $this->serializer
                ->denormalize($itemized_data[0], $field_item_class, $format, $context);
        }
        $data_internal = [];
        foreach ($itemized_data as $delta => $field_item_value) {
            $data_internal[$delta] = $this->serializer
                ->denormalize($field_item_value, $field_item_class, $format, $context);
        }
        return $data_internal;
    }
    
    /**
     * Helper function to normalize field items.
     *
     * @param \Drupal\Core\Field\FieldItemListInterface $field
     *   The field object.
     * @param string $format
     *   The format.
     * @param array $context
     *   The context array.
     *
     * @return \Drupal\jsonapi\Normalizer\Value\FieldItemNormalizerValue[]
     *   The array of normalized field items.
     */
    protected function normalizeFieldItems(FieldItemListInterface $field, $format, array $context) {
        $normalizer_items = [];
        if (!$field->isEmpty()) {
            foreach ($field as $field_item) {
                $normalizer_items[] = $this->serializer
                    ->normalize($field_item, $format, $context);
            }
        }
        return $normalizer_items;
    }
    
    /**
     * {@inheritdoc}
     */
    public function hasCacheableSupportsMethod() : bool {
        return TRUE;
    }

}

Members

Title Sort descending Modifiers Object type Summary Overriden Title Overrides
CacheableNormalizerInterface::SERIALIZATION_CONTEXT_CACHEABILITY constant Name of key for bubbling cacheability metadata via serialization context.
FieldNormalizer::$supportedInterfaceOrClass protected property The interface or class that this Normalizer supports. Overrides NormalizerBase::$supportedInterfaceOrClass 1
FieldNormalizer::denormalize public function
FieldNormalizer::hasCacheableSupportsMethod public function Overrides NormalizerBase::hasCacheableSupportsMethod
FieldNormalizer::normalize public function 1
FieldNormalizer::normalizeFieldItems protected function Helper function to normalize field items.
NormalizerBase::$format protected property List of formats which supports (de-)normalization. Overrides NormalizerBase::$format
NormalizerBase::addCacheableDependency protected function Adds cacheability if applicable.
NormalizerBase::checkFormat protected function Checks if the provided format is supported by this normalizer. Overrides NormalizerBase::checkFormat
NormalizerBase::rasterizeValueRecursive protected static function Rasterizes a value recursively.
NormalizerBase::supportsDenormalization public function Implements \Symfony\Component\Serializer\Normalizer\DenormalizerInterface::supportsDenormalization() 1
NormalizerBase::supportsNormalization public function 1

Buggy or inaccurate documentation? Please file an issue. Need support? Need help programming? Connect with the Drupal community.