class ConfigEntityTypeTest in Drupal 8

@coversDefaultClass \Drupal\Core\Config\Entity\ConfigEntityType @group Config

Hierarchy

• class \Drupal\Tests\UnitTestCase extends \PHPUnit\Framework\TestCase uses PhpunitCompatibilityTrait
  • class \Drupal\Tests\Core\Config\Entity\ConfigEntityTypeTest

File

core/tests/Drupal/Tests/Core/Config/Entity/ConfigEntityTypeTest.php, line 15

Namespace

Drupal\Tests\Core\Config\Entity

class ConfigEntityTypeTest extends UnitTestCase {

  /**
   * The mocked typed config manager.
   *
   * @var \Drupal\Core\Config\TypedConfigManagerInterface|\PHPUnit\Framework\MockObject\MockObject
   */
  protected $typedConfigManager;

  /**
   * {@inheritdoc}
   */
  protected function setUp() {
    $this->typedConfigManager = $this
      ->createMock(TypedConfigManagerInterface::class);
    $container = new ContainerBuilder();
    $container
      ->set('config.typed', $this->typedConfigManager);
    \Drupal::setContainer($container);
  }

  /**
   * Sets up a ConfigEntityType object for a given set of values.
   *
   * @param array $definition
   *   An array of values to use for the ConfigEntityType.
   *
   * @return \Drupal\Core\Config\Entity\ConfigEntityTypeInterface
   */
  protected function setUpConfigEntityType($definition) {
    if (!isset($definition['id'])) {
      $definition += [
        'id' => 'example_config_entity_type',
      ];
    }
    return new ConfigEntityType($definition);
  }

  /**
   * Tests that we get an exception when the length of the config prefix that is
   * returned by getConfigPrefix() exceeds the maximum defined prefix length.
   *
   * @covers ::getConfigPrefix
   */
  public function testConfigPrefixLengthExceeds() {

    // A provider length of 24 and config_prefix length of 59 (+1 for the .)
    // results in a config length of 84, which is too long.
    $definition = [
      'provider' => $this
        ->randomMachineName(24),
      'config_prefix' => $this
        ->randomMachineName(59),
    ];
    $config_entity = $this
      ->setUpConfigEntityType($definition);
    $this
      ->expectException('\\Drupal\\Core\\Config\\ConfigPrefixLengthException');
    $this
      ->expectExceptionMessage("The configuration file name prefix {$definition['provider']}.{$definition['config_prefix']} exceeds the maximum character limit of " . ConfigEntityType::PREFIX_LENGTH);
    $this
      ->assertEmpty($config_entity
      ->getConfigPrefix());
  }

  /**
   * Tests that a valid config prefix returned by getConfigPrefix()
   * does not throw an exception and is formatted as expected.
   *
   * @covers ::getConfigPrefix
   */
  public function testConfigPrefixLengthValid() {

    // A provider length of 24 and config_prefix length of 58 (+1 for the .)
    // results in a config length of 83, which is right at the limit.
    $definition = [
      'provider' => $this
        ->randomMachineName(24),
      'config_prefix' => $this
        ->randomMachineName(58),
    ];
    $config_entity = $this
      ->setUpConfigEntityType($definition);
    $expected_prefix = $definition['provider'] . '.' . $definition['config_prefix'];
    $this
      ->assertEquals($expected_prefix, $config_entity
      ->getConfigPrefix());
  }

  /**
   * @covers ::__construct
   */
  public function testConstruct() {
    $config_entity = new ConfigEntityType([
      'id' => 'example_config_entity_type',
    ]);
    $this
      ->assertEquals('Drupal\\Core\\Config\\Entity\\ConfigEntityStorage', $config_entity
      ->getStorageClass());
  }

  /**
   * @covers ::__construct
   */
  public function testConstructBadStorage() {
    $this
      ->expectException(ConfigEntityStorageClassException::class);
    $this
      ->expectExceptionMessage('\\Drupal\\Core\\Entity\\KeyValueStore\\KeyValueEntityStorage is not \\Drupal\\Core\\Config\\Entity\\ConfigEntityStorage or it does not extend it');
    new ConfigEntityType([
      'id' => 'example_config_entity_type',
      'handlers' => [
        'storage' => '\\Drupal\\Core\\Entity\\KeyValueStore\\KeyValueEntityStorage',
      ],
    ]);
  }

  /**
   * @covers ::setStorageClass
   */
  public function testSetStorageClass() {
    $config_entity = $this
      ->setUpConfigEntityType([]);
    $this
      ->expectException(ConfigEntityStorageClassException::class);
    $this
      ->expectExceptionMessage('\\Drupal\\Core\\Entity\\KeyValueStore\\KeyValueEntityStorage is not \\Drupal\\Core\\Config\\Entity\\ConfigEntityStorage or it does not extend it');
    $config_entity
      ->setStorageClass('\\Drupal\\Core\\Entity\\KeyValueStore\\KeyValueEntityStorage');
  }

  /**
   * Tests the getConfigPrefix() method.
   *
   * @dataProvider providerTestGetConfigPrefix
   *
   * @covers ::getConfigPrefix
   */
  public function testGetConfigPrefix($definition, $expected) {
    $entity_type = $this
      ->setUpConfigEntityType($definition);
    $this
      ->assertSame($expected, $entity_type
      ->getConfigPrefix());
  }

  /**
   * Provides test data.
   */
  public function providerTestGetConfigPrefix() {
    return [
      [
        [
          'provider' => 'node',
          'id' => 'node_type',
          'config_prefix' => 'type',
        ],
        'node.type',
      ],
      [
        [
          'provider' => 'views',
          'id' => 'view',
        ],
        'views.view',
      ],
    ];
  }

  /**
   * @covers ::getPropertiesToExport
   *
   * @dataProvider providerGetPropertiesToExport
   */
  public function testGetPropertiesToExport($definition, $expected) {
    $entity_type = $this
      ->setUpConfigEntityType($definition);
    $properties_to_export = $entity_type
      ->getPropertiesToExport();
    $this
      ->assertSame($expected, $properties_to_export);

    // Ensure the method is idempotent.
    $properties_to_export = $entity_type
      ->getPropertiesToExport();
    $this
      ->assertSame($expected, $properties_to_export);
  }
  public function providerGetPropertiesToExport() {
    $data = [];
    $data[] = [
      [
        'config_export' => [
          'id',
          'custom_property' => 'customProperty',
        ],
      ],
      [
        'uuid' => 'uuid',
        'langcode' => 'langcode',
        'status' => 'status',
        'dependencies' => 'dependencies',
        'third_party_settings' => 'third_party_settings',
        '_core' => '_core',
        'id' => 'id',
        'custom_property' => 'customProperty',
      ],
    ];
    $data[] = [
      [
        'config_export' => [
          'id',
        ],
        'mergedConfigExport' => [
          'random_key' => 'random_key',
        ],
      ],
      [
        'random_key' => 'random_key',
      ],
    ];
    return $data;
  }

  /**
   * @covers ::getPropertiesToExport
   *
   * @group legacy
   * @expectedDeprecation Entity type "example_config_entity_type" is using config schema as a fallback for a missing `config_export` definition is deprecated in Drupal 8.7.0 and will be removed before Drupal 9.0.0. See https://www.drupal.org/node/2949023.
   */
  public function testGetPropertiesToExportSchemaFallback() {
    $this->typedConfigManager
      ->expects($this
      ->once())
      ->method('getDefinition')
      ->will($this
      ->returnValue([
      'mapping' => [
        'id' => '',
        'dependencies' => '',
      ],
    ]));
    $config_entity_type = new ConfigEntityType([
      'id' => 'example_config_entity_type',
    ]);
    $this
      ->assertEquals([
      'id' => 'id',
      'dependencies' => 'dependencies',
    ], $config_entity_type
      ->getPropertiesToExport('test'));
  }

  /**
   * @covers ::getPropertiesToExport
   */
  public function testGetPropertiesToExportNoFallback() {
    $config_entity_type = new ConfigEntityType([
      'id' => 'example_config_entity_type',
    ]);
    $this
      ->assertNull($config_entity_type
      ->getPropertiesToExport());
  }

}

Members

Name	Modifiers	Type	Description	Overrides
ConfigEntityTypeTest::$typedConfigManager	protected	property	The mocked typed config manager.
ConfigEntityTypeTest::providerGetPropertiesToExport	public	function
ConfigEntityTypeTest::providerTestGetConfigPrefix	public	function	Provides test data.
ConfigEntityTypeTest::setUp	protected	function	Overrides UnitTestCase::setUp
ConfigEntityTypeTest::setUpConfigEntityType	protected	function	Sets up a ConfigEntityType object for a given set of values.
ConfigEntityTypeTest::testConfigPrefixLengthExceeds	public	function	Tests that we get an exception when the length of the config prefix that is returned by getConfigPrefix() exceeds the maximum defined prefix length.
ConfigEntityTypeTest::testConfigPrefixLengthValid	public	function	Tests that a valid config prefix returned by getConfigPrefix() does not throw an exception and is formatted as expected.
ConfigEntityTypeTest::testConstruct	public	function	@covers ::__construct
ConfigEntityTypeTest::testConstructBadStorage	public	function	@covers ::__construct
ConfigEntityTypeTest::testGetConfigPrefix	public	function	Tests the getConfigPrefix() method.
ConfigEntityTypeTest::testGetPropertiesToExport	public	function	@covers ::getPropertiesToExport
ConfigEntityTypeTest::testGetPropertiesToExportNoFallback	public	function	@covers ::getPropertiesToExport
ConfigEntityTypeTest::testGetPropertiesToExportSchemaFallback	public	function	@covers ::getPropertiesToExport
ConfigEntityTypeTest::testSetStorageClass	public	function	@covers ::setStorageClass
PhpunitCompatibilityTrait::getMock Deprecated	public	function	Returns a mock object for the specified class using the available method.
PhpunitCompatibilityTrait::setExpectedException Deprecated	public	function	Compatibility layer for PHPUnit 6 to support PHPUnit 4 code.
UnitTestCase::$randomGenerator	protected	property	The random generator.
UnitTestCase::$root	protected	property	The app root.	1
UnitTestCase::assertArrayEquals	protected	function	Asserts if two arrays are equal by sorting them first.
UnitTestCase::getBlockMockWithMachineName Deprecated	protected	function	Mocks a block with a block plugin.	1
UnitTestCase::getClassResolverStub	protected	function	Returns a stub class resolver.
UnitTestCase::getConfigFactoryStub	public	function	Returns a stub config factory that behaves according to the passed array.
UnitTestCase::getConfigStorageStub	public	function	Returns a stub config storage that returns the supplied configuration.
UnitTestCase::getContainerWithCacheTagsInvalidator	protected	function	Sets up a container with a cache tags invalidator.
UnitTestCase::getRandomGenerator	protected	function	Gets the random generator for the utility methods.
UnitTestCase::getStringTranslationStub	public	function	Returns a stub translation manager that just returns the passed string.
UnitTestCase::randomMachineName	public	function	Generates a unique random string containing letters and numbers.