EntitySerializationTest.php

Same filename in other branches
  1. 9 core/modules/serialization/tests/src/Kernel/EntitySerializationTest.php
  2. 8.9.x core/modules/serialization/tests/src/Kernel/EntitySerializationTest.php
  3. 11.x core/modules/serialization/tests/src/Kernel/EntitySerializationTest.php

Namespace

Drupal\Tests\serialization\Kernel

File

core/modules/serialization/tests/src/Kernel/EntitySerializationTest.php

View source
<?php

declare (strict_types=1);
namespace Drupal\Tests\serialization\Kernel;

use Drupal\Core\Cache\CacheableDependencyInterface;
use Drupal\Core\Cache\CacheableMetadata;
use Drupal\entity_test\Entity\EntityTestComputedField;
use Drupal\Component\Serialization\Json;
use Drupal\Component\Datetime\DateTimePlus;
use Drupal\entity_test\Entity\EntitySerializedField;
use Drupal\entity_test\Entity\EntityTestMulRev;
use Drupal\filter\Entity\FilterFormat;
use Drupal\serialization\Normalizer\CacheableNormalizerInterface;

/**
 * Tests that entities can be serialized to supported core formats.
 *
 * @group serialization
 */
class EntitySerializationTest extends NormalizerTestBase {
    
    /**
     * {@inheritdoc}
     */
    protected static $modules = [
        'serialization',
        'system',
        'field',
        'entity_test',
        'text',
        'filter',
        'user',
        'entity_serialization_test',
    ];
    
    /**
     * The test values.
     *
     * @var array
     */
    protected $values;
    
    /**
     * The test entity.
     *
     * @var \Drupal\Core\Entity\ContentEntityInterface
     */
    protected $entity;
    
    /**
     * The test user.
     *
     * @var \Drupal\user\Entity\User
     */
    protected $user;
    
    /**
     * The serializer service.
     *
     * @var \Symfony\Component\Serializer\Serializer
     */
    protected $serializer;
    
    /**
     * The class name of the test class.
     *
     * @var string
     */
    protected $entityClass = 'Drupal\\entity_test\\Entity\\EntityTest';
    
    /**
     * {@inheritdoc}
     */
    protected function setUp() : void {
        parent::setUp();
        FilterFormat::create([
            'format' => 'my_text_format',
            'name' => 'My Text Format',
            'filters' => [
                'filter_html' => [
                    'module' => 'filter',
                    'status' => TRUE,
                    'weight' => 10,
                    'settings' => [
                        'allowed_html' => '<p>',
                    ],
                ],
                'filter_autop' => [
                    'module' => 'filter',
                    'status' => TRUE,
                    'weight' => 10,
                    'settings' => [],
                ],
            ],
        ])->save();
        // Create a test user to use as the entity owner.
        $this->user = \Drupal::entityTypeManager()->getStorage('user')
            ->create([
            'name' => 'serialization_test_user',
            'mail' => 'foo@example.com',
            'pass' => '123456',
        ]);
        $this->user
            ->save();
        // Create a test entity to serialize.
        $test_text_value = $this->randomMachineName();
        $this->values = [
            'name' => $this->randomMachineName(),
            'user_id' => $this->user
                ->id(),
            'field_test_text' => [
                'value' => $test_text_value,
                'format' => 'my_text_format',
            ],
        ];
        $this->entity = EntityTestMulRev::create($this->values);
        $this->entity
            ->save();
        $this->serializer = $this->container
            ->get('serializer');
        $this->installConfig([
            'field',
        ]);
    }
    
    /**
     * Tests the normalize function.
     */
    public function testNormalize() : void {
        $expected = [
            'id' => [
                [
                    'value' => 1,
                ],
            ],
            'uuid' => [
                [
                    'value' => $this->entity
                        ->uuid(),
                ],
            ],
            'langcode' => [
                [
                    'value' => 'en',
                ],
            ],
            'name' => [
                [
                    'value' => $this->values['name'],
                ],
            ],
            'type' => [
                [
                    'value' => 'entity_test_mulrev',
                ],
            ],
            'created' => [
                [
                    'value' => (new \DateTime())->setTimestamp((int) $this->entity
                        ->get('created')->value)
                        ->setTimezone(new \DateTimeZone('UTC'))
                        ->format(\DateTime::RFC3339),
                    'format' => \DateTime::RFC3339,
                ],
            ],
            'user_id' => [
                [
                    // id() will return the string value as it comes from the database.
'target_id' => (int) $this->user
                        ->id(),
                    'target_type' => $this->user
                        ->getEntityTypeId(),
                    'target_uuid' => $this->user
                        ->uuid(),
                    'url' => $this->user
                        ->toUrl()
                        ->toString(),
                ],
            ],
            'revision_id' => [
                [
                    'value' => 1,
                ],
            ],
            'default_langcode' => [
                [
                    'value' => TRUE,
                ],
            ],
            'revision_translation_affected' => [
                [
                    'value' => TRUE,
                ],
            ],
            'non_rev_field' => [],
            'non_mul_field' => [],
            'field_test_text' => [
                [
                    'value' => $this->values['field_test_text']['value'],
                    'format' => $this->values['field_test_text']['format'],
                    'processed' => "<p>{$this->values['field_test_text']['value']}</p>",
                ],
            ],
        ];
        $normalized = $this->serializer
            ->normalize($this->entity);
        foreach (array_keys($expected) as $fieldName) {
            $this->assertSame($expected[$fieldName], $normalized[$fieldName], "Normalization produces expected array for {$fieldName}.");
        }
        $this->assertEquals([], array_diff_key($normalized, $expected), 'No unexpected data is added to the normalized array.');
    }
    
    /**
     * Tests user normalization with some default access controls overridden.
     *
     * @see entity_serialization_test.module
     */
    public function testUserNormalize() : void {
        // Test password isn't available.
        $normalized = $this->serializer
            ->normalize($this->user);
        $this->assertArrayNotHasKey('pass', $normalized);
        $this->assertArrayNotHasKey('mail', $normalized);
        // Test again using our test user, so that our access control override will
        // allow password viewing.
        $normalized = $this->serializer
            ->normalize($this->user, NULL, [
            'account' => $this->user,
        ]);
        // The key 'pass' will now exist, but the password value should be
        // normalized to NULL.
        $this->assertSame([
            NULL,
        ], $normalized['pass'], '"pass" value is normalized to [NULL]');
    }
    
    /**
     * Tests entity serialization for core's formats by a registered Serializer.
     */
    public function testSerialize() : void {
        // Test that Serializer responds using the ComplexDataNormalizer and
        // JsonEncoder. The output of ComplexDataNormalizer::normalize() is tested
        // elsewhere, so we can just assume that it works properly here.
        $normalized = $this->serializer
            ->normalize($this->entity, 'json');
        $expected = Json::encode($normalized);
        // Test 'json'.
        $actual = $this->serializer
            ->serialize($this->entity, 'json');
        $this->assertSame($expected, $actual, 'Entity serializes to JSON when "json" is requested.');
        $actual = $this->serializer
            ->serialize($normalized, 'json');
        $this->assertSame($expected, $actual, 'A normalized array serializes to JSON when "json" is requested');
        // Test 'ajax'.
        $actual = $this->serializer
            ->serialize($this->entity, 'ajax');
        $this->assertSame($expected, $actual, 'Entity serializes to JSON when "ajax" is requested.');
        $actual = $this->serializer
            ->serialize($normalized, 'ajax');
        $this->assertSame($expected, $actual, 'A normalized array serializes to JSON when "ajax" is requested');
        // Generate the expected xml in a way that allows changes to entity property
        // order.
        $expected_created = [
            'value' => DateTimePlus::createFromTimestamp($this->entity->created->value, 'UTC')
                ->format(\DateTime::RFC3339),
            'format' => \DateTime::RFC3339,
        ];
        $expected = [
            'id' => '<id><value>' . $this->entity
                ->id() . '</value></id>',
            'uuid' => '<uuid><value>' . $this->entity
                ->uuid() . '</value></uuid>',
            'langcode' => '<langcode><value>en</value></langcode>',
            'name' => '<name><value>' . $this->values['name'] . '</value></name>',
            'type' => '<type><value>entity_test_mulrev</value></type>',
            'created' => '<created><value>' . $expected_created['value'] . '</value><format>' . $expected_created['format'] . '</format></created>',
            'user_id' => '<user_id><target_id>' . $this->user
                ->id() . '</target_id><target_type>' . $this->user
                ->getEntityTypeId() . '</target_type><target_uuid>' . $this->user
                ->uuid() . '</target_uuid><url>' . $this->user
                ->toUrl()
                ->toString() . '</url></user_id>',
            'revision_id' => '<revision_id><value>' . $this->entity
                ->getRevisionId() . '</value></revision_id>',
            'default_langcode' => '<default_langcode><value>1</value></default_langcode>',
            'revision_translation_affected' => '<revision_translation_affected><value>1</value></revision_translation_affected>',
            'non_mul_field' => '<non_mul_field/>',
            'non_rev_field' => '<non_rev_field/>',
            'field_test_text' => '<field_test_text><value>' . $this->values['field_test_text']['value'] . '</value><format>' . $this->values['field_test_text']['format'] . '</format><processed><![CDATA[<p>' . $this->values['field_test_text']['value'] . '</p>]]></processed></field_test_text>',
        ];
        // Sort it in the same order as normalized.
        $expected = array_merge($normalized, $expected);
        // Add header and footer.
        array_unshift($expected, '<?xml version="1.0"?>' . PHP_EOL . '<response>');
        $expected[] = '</response>' . PHP_EOL;
        // Reduced the array to a string.
        $expected = implode('', $expected);
        // Test 'xml'. The output should match that of Symfony's XmlEncoder.
        $actual = $this->serializer
            ->serialize($this->entity, 'xml');
        $this->assertSame($expected, $actual);
        $actual = $this->serializer
            ->serialize($normalized, 'xml');
        $this->assertSame($expected, $actual);
    }
    
    /**
     * Tests denormalization of an entity.
     */
    public function testDenormalize() : void {
        $normalized = $this->serializer
            ->normalize($this->entity);
        foreach ([
            'json',
            'xml',
        ] as $type) {
            $denormalized = $this->serializer
                ->denormalize($normalized, $this->entityClass, $type, [
                'entity_type' => 'entity_test_mulrev',
            ]);
            $this->assertInstanceOf($this->entityClass, $denormalized);
            $this->assertSame($this->entity
                ->getEntityTypeId(), $denormalized->getEntityTypeId(), 'Expected entity type found.');
            $this->assertSame($this->entity
                ->bundle(), $denormalized->bundle(), 'Expected entity bundle found.');
            $this->assertSame($this->entity
                ->uuid(), $denormalized->uuid(), 'Expected entity UUID found.');
        }
    }
    
    /**
     * Tests denormalizing serialized columns.
     */
    public function testDenormalizeSerializedItem() : void {
        $this->expectException(\LogicException::class);
        $this->expectExceptionMessage('The generic FieldItemNormalizer cannot denormalize string values for "value" properties of the "serialized" field (field item class: Drupal\\entity_test\\Plugin\\Field\\FieldType\\SerializedItem).');
        $this->serializer
            ->denormalize([
            'serialized' => [
                [
                    'value' => 'boo',
                ],
            ],
            'type' => 'entity_test_serialized_field',
        ], EntitySerializedField::class);
    }
    
    /**
     * Tests normalizing/denormalizing custom serialized columns.
     */
    public function testDenormalizeCustomSerializedItem() : void {
        $entity = EntitySerializedField::create([
            'serialized_text' => serialize([
                'Hello world!',
            ]),
        ]);
        $normalized = $this->serializer
            ->normalize($entity);
        $this->assertEquals([
            'Hello world!',
        ], $normalized['serialized_text'][0]['value']);
        $this->expectException(\LogicException::class);
        $this->expectExceptionMessage('The generic FieldItemNormalizer cannot denormalize string values for "value" properties of the "serialized_text" field (field item class: Drupal\\entity_test\\Plugin\\Field\\FieldType\\SerializedPropertyItem).');
        $this->serializer
            ->denormalize([
            'serialized_text' => [
                [
                    'value' => 'boo',
                ],
            ],
            'type' => 'entity_test_serialized_field',
        ], EntitySerializedField::class);
    }
    
    /**
     * Tests normalizing/denormalizing invalid custom serialized fields.
     */
    public function testDenormalizeInvalidCustomSerializedField() : void {
        $entity = EntitySerializedField::create([
            'serialized_long' => serialize([
                'Hello world!',
            ]),
        ]);
        $normalized = $this->serializer
            ->normalize($entity);
        $this->assertEquals([
            'Hello world!',
        ], $normalized['serialized_long'][0]['value']);
        $this->expectException(\LogicException::class);
        $this->expectExceptionMessage('The generic FieldItemNormalizer cannot denormalize string values for "value" properties of the "serialized_long" field (field item class: Drupal\\Core\\Field\\Plugin\\Field\\FieldType\\StringLongItem).');
        $this->serializer
            ->denormalize([
            'serialized_long' => [
                [
                    'value' => 'boo',
                ],
            ],
            'type' => 'entity_test_serialized_field',
        ], EntitySerializedField::class);
    }
    
    /**
     * Tests normalizing/denormalizing empty custom serialized fields.
     */
    public function testDenormalizeEmptyCustomSerializedField() : void {
        $entity = EntitySerializedField::create([
            'serialized_long' => serialize([]),
        ]);
        $normalized = $this->serializer
            ->normalize($entity);
        $this->assertEquals([], $normalized['serialized_long'][0]['value']);
        $entity = $this->serializer
            ->denormalize($normalized, EntitySerializedField::class);
        $this->assertEquals(serialize([]), $entity->get('serialized_long')->value);
    }
    
    /**
     * Tests normalizing/denormalizing valid custom serialized fields.
     */
    public function testDenormalizeValidCustomSerializedField() : void {
        $entity = EntitySerializedField::create([
            'serialized_long' => serialize([
                'key' => 'value',
            ]),
        ]);
        $normalized = $this->serializer
            ->normalize($entity);
        $this->assertEquals([
            'key' => 'value',
        ], $normalized['serialized_long'][0]['value']);
        $entity = $this->serializer
            ->denormalize($normalized, EntitySerializedField::class);
        $this->assertEquals(serialize([
            'key' => 'value',
        ]), $entity->get('serialized_long')->value);
    }
    
    /**
     * Tests normalizing/denormalizing using string values.
     */
    public function testDenormalizeStringValue() : void {
        $this->expectException(\LogicException::class);
        $this->expectExceptionMessage('The generic FieldItemNormalizer cannot denormalize string values for "value" properties of the "serialized_long" field (field item class: Drupal\\Core\\Field\\Plugin\\Field\\FieldType\\StringLongItem).');
        $this->serializer
            ->denormalize([
            'serialized_long' => [
                'boo',
            ],
            'type' => 'entity_test_serialized_field',
        ], EntitySerializedField::class);
    }
    
    /**
     * Tests normalizing cacheable computed field.
     */
    public function testCacheableComputedField() : void {
        $context[CacheableNormalizerInterface::SERIALIZATION_CONTEXT_CACHEABILITY] = new CacheableMetadata();
        $entity = EntityTestComputedField::create();
        $normalized = $this->serializer
            ->normalize($entity, NULL, $context);
        $this->assertEquals('computed test cacheable string field', $normalized['computed_test_cacheable_string_field'][0]['value']);
        $this->assertInstanceOf(CacheableDependencyInterface::class, $context[CacheableNormalizerInterface::SERIALIZATION_CONTEXT_CACHEABILITY]);
        // See \Drupal\entity_test\Plugin\Field\ComputedTestCacheableStringItemList::computeValue().
        $this->assertEquals($context[CacheableNormalizerInterface::SERIALIZATION_CONTEXT_CACHEABILITY]->getCacheContexts(), [
            'url.query_args:computed_test_cacheable_string_field',
        ]);
        $this->assertEquals($context[CacheableNormalizerInterface::SERIALIZATION_CONTEXT_CACHEABILITY]->getCacheTags(), [
            'field:computed_test_cacheable_string_field',
        ]);
        $this->assertEquals($context[CacheableNormalizerInterface::SERIALIZATION_CONTEXT_CACHEABILITY]->getCacheMaxAge(), 800);
    }

}

Classes

Title Deprecated Summary
EntitySerializationTest Tests that entities can be serialized to supported core formats.

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