class DefaultHtmlRouteProviderTest

Same name and namespace in other branches
  1. 9 core/tests/Drupal/Tests/Core/Entity/Routing/DefaultHtmlRouteProviderTest.php \Drupal\Tests\Core\Entity\Routing\DefaultHtmlRouteProviderTest
  2. 8.9.x core/tests/Drupal/Tests/Core/Entity/Routing/DefaultHtmlRouteProviderTest.php \Drupal\Tests\Core\Entity\Routing\DefaultHtmlRouteProviderTest
  3. 11.x core/tests/Drupal/Tests/Core/Entity/Routing/DefaultHtmlRouteProviderTest.php \Drupal\Tests\Core\Entity\Routing\DefaultHtmlRouteProviderTest

@coversDefaultClass \Drupal\Core\Entity\Routing\DefaultHtmlRouteProvider
@group Entity

Hierarchy

Expanded class hierarchy of DefaultHtmlRouteProviderTest

File

core/tests/Drupal/Tests/Core/Entity/Routing/DefaultHtmlRouteProviderTest.php, line 25

Namespace

Drupal\Tests\Core\Entity\Routing
View source
class DefaultHtmlRouteProviderTest extends UnitTestCase {
  
  /**
   * The entity type manager prophecy used in the test.
   *
   * @var \Prophecy\Prophecy\ProphecyInterface|\Drupal\Core\Entity\EntityTypeManagerInterface
   */
  protected $entityTypeManager;
  
  /**
   * The entity field manager prophecy used in the test.
   *
   * @var \Prophecy\Prophecy\ProphecyInterface|\Drupal\Core\Entity\EntityFieldManagerInterface
   */
  protected $entityFieldManager;
  
  /**
   * The HTML route provider used in the test.
   *
   * @var \Drupal\Tests\Core\Entity\Routing\TestDefaultHtmlRouteProvider
   */
  protected $routeProvider;
  
  /**
   * {@inheritdoc}
   */
  protected function setUp() : void {
    parent::setUp();
    $this->entityTypeManager = $this->prophesize(EntityTypeManagerInterface::class);
    $this->entityFieldManager = $this->prophesize(EntityFieldManagerInterface::class);
    $this->routeProvider = new TestDefaultHtmlRouteProvider($this->entityTypeManager
      ->reveal(), $this->entityFieldManager
      ->reveal());
  }
  
  /**
   * @covers ::getAddPageRoute
   * @dataProvider providerTestGetAddPageRoute
   */
  public function testGetAddPageRoute(?Route $expected, EntityTypeInterface $entity_type) : void {
    $route = $this->routeProvider
      ->getAddPageRoute($entity_type);
    $this->assertEquals($expected, $route);
  }
  public static function providerTestGetAddPageRoute() {
    $data = [];
    $entity_type1 = static::getEntityType();
    $entity_type1->hasLinkTemplate('add-page')
      ->willReturn(FALSE);
    $data['no_add_page_link_template'] = [
      NULL,
      $entity_type1->reveal(),
    ];
    $entity_type2 = static::getEntityType();
    $entity_type2->hasLinkTemplate('add-page')
      ->willReturn(TRUE);
    $entity_type2->getKey('bundle')
      ->willReturn(NULL);
    $data['no_bundle'] = [
      NULL,
      $entity_type2->reveal(),
    ];
    $entity_type3 = static::getEntityType();
    $entity_type3->hasLinkTemplate('add-page')
      ->willReturn(TRUE);
    $entity_type3->getLinkTemplate('add-page')
      ->willReturn('/the/add/page/link/template');
    $entity_type3->id()
      ->willReturn('the_entity_type_id');
    $entity_type3->getKey('bundle')
      ->willReturn('type');
    $route = new Route('/the/add/page/link/template');
    $route->setDefaults([
      '_controller' => 'Drupal\\Core\\Entity\\Controller\\EntityController::addPage',
      '_title_callback' => 'Drupal\\Core\\Entity\\Controller\\EntityController::addTitle',
      'entity_type_id' => 'the_entity_type_id',
    ]);
    $route->setRequirement('_entity_create_any_access', 'the_entity_type_id');
    $data['add_page'] = [
      clone $route,
      $entity_type3->reveal(),
    ];
    return $data;
  }
  
  /**
   * @covers ::getAddFormRoute
   * @dataProvider providerTestGetAddFormRoute
   */
  public function testGetAddFormRoute(?Route $expected, EntityTypeInterface $entity_type, ?EntityTypeInterface $bundle_entity_type = NULL, ?FieldStorageDefinitionInterface $field_storage_definition = NULL) : void {
    if ($bundle_entity_type) {
      $this->entityTypeManager
        ->getDefinition('the_bundle_entity_type_id')
        ->willReturn($bundle_entity_type);
      if ($field_storage_definition) {
        $this->entityFieldManager
          ->getFieldStorageDefinitions('the_bundle_entity_type_id')
          ->willReturn([
          'id' => $field_storage_definition,
        ]);
      }
    }
    $route = $this->routeProvider
      ->getAddFormRoute($entity_type);
    $this->assertEquals($expected, $route);
  }
  public static function providerTestGetAddFormRoute() {
    $prophet = new Prophet();
    $data = [];
    $entity_type1 = static::getEntityType();
    $entity_type1->hasLinkTemplate('add-form')
      ->willReturn(FALSE);
    $data['no_add_form_link_template'] = [
      NULL,
      $entity_type1->reveal(),
    ];
    $entity_type2 = static::getEntityType();
    $entity_type2->getBundleEntityType()
      ->willReturn(NULL);
    $entity_type2->hasLinkTemplate('add-form')
      ->willReturn(TRUE);
    $entity_type2->id()
      ->willReturn('the_entity_type_id');
    $entity_type2->getLinkTemplate('add-form')
      ->willReturn('/the/add/form/link/template');
    $entity_type2->getFormClass('add')
      ->willReturn(NULL);
    $entity_type2->getKey('bundle')
      ->willReturn(NULL);
    $route = (new Route('/the/add/form/link/template'))->setDefaults([
      '_entity_form' => 'the_entity_type_id.default',
      'entity_type_id' => 'the_entity_type_id',
      '_title_callback' => 'Drupal\\Core\\Entity\\Controller\\EntityController::addTitle',
    ])
      ->setRequirement('_entity_create_access', 'the_entity_type_id');
    $data['no_add_form_no_bundle'] = [
      clone $route,
      $entity_type2->reveal(),
    ];
    $entity_type3 = static::getEntityType($entity_type2);
    $entity_type3->getFormClass('add')
      ->willReturn('Drupal\\Core\\Entity\\EntityForm');
    $route->setDefault('_entity_form', 'the_entity_type_id.add');
    $data['add_form_no_bundle'] = [
      clone $route,
      $entity_type3->reveal(),
    ];
    $entity_type4 = static::getEntityType($entity_type3);
    $entity_type4->getKey('bundle')
      ->willReturn('the_bundle_key');
    $entity_type4->getBundleEntityType()
      ->willReturn(NULL);
    $entity_type4->getLinkTemplate('add-form')
      ->willReturn('/the/add/form/link/template/{the_bundle_key}');
    $route->setPath('/the/add/form/link/template/{the_bundle_key}');
    $route->setDefault('_title_callback', 'Drupal\\Core\\Entity\\Controller\\EntityController::addBundleTitle')
      ->setDefault('bundle_parameter', 'the_bundle_key')
      ->setRequirement('_entity_create_access', 'the_entity_type_id:{the_bundle_key}');
    $data['add_form_bundle_static'] = [
      clone $route,
      $entity_type4->reveal(),
    ];
    $entity_type5 = static::getEntityType($entity_type4);
    $entity_type5->getBundleEntityType()
      ->willReturn('the_bundle_entity_type_id');
    $entity_type5->getLinkTemplate('add-form')
      ->willReturn('/the/add/form/link/template/{the_bundle_entity_type_id}');
    $bundle_entity_type = static::getEntityType();
    $bundle_entity_type->entityClassImplements(FieldableEntityInterface::class)
      ->willReturn(FALSE);
    $route->setPath('/the/add/form/link/template/{the_bundle_entity_type_id}');
    $route->setDefault('bundle_parameter', 'the_bundle_entity_type_id')
      ->setRequirement('_entity_create_access', 'the_entity_type_id:{the_bundle_entity_type_id}')
      ->setOption('parameters', [
      'the_bundle_entity_type_id' => [
        'type' => 'entity:the_bundle_entity_type_id',
      ],
    ]);
    $data['add_form_bundle_entity_id_key_type_null'] = [
      clone $route,
      $entity_type5->reveal(),
      $bundle_entity_type->reveal(),
    ];
    $entity_type6 = static::getEntityType($entity_type5);
    $bundle_entity_type = static::getEntityType();
    $bundle_entity_type->entityClassImplements(FieldableEntityInterface::class)
      ->willReturn(TRUE);
    $field_storage_definition = $prophet->prophesize(FieldStorageDefinitionInterface::class);
    $field_storage_definition->getType()
      ->willReturn('integer');
    $route->setRequirement('the_entity_type_id', '\\d+');
    $data['add_form_bundle_entity_id_key_type_integer'] = [
      clone $route,
      $entity_type6->reveal(),
      $bundle_entity_type->reveal(),
      $field_storage_definition->reveal(),
    ];
    $entity_type7 = static::getEntityType($entity_type6);
    $bundle_entity_type = $prophet->prophesize(ConfigEntityTypeInterface::class);
    $bundle_entity_type->entityClassImplements(FieldableEntityInterface::class)
      ->willReturn(FALSE);
    $field_storage_definition = $prophet->prophesize(FieldStorageDefinitionInterface::class);
    $route->setRequirements([
      '_entity_create_access' => $route->getRequirement('_entity_create_access'),
    ])
      ->setOption('parameters', [
      'the_bundle_entity_type_id' => [
        'type' => 'entity:the_bundle_entity_type_id',
        'with_config_overrides' => TRUE,
      ],
    ]);
    $data['add_form_bundle_entity_id_key_type_integer'] = [
      clone $route,
      $entity_type7->reveal(),
      $bundle_entity_type->reveal(),
      $field_storage_definition->reveal(),
    ];
    return $data;
  }
  
  /**
   * @covers ::getCanonicalRoute
   * @dataProvider providerTestGetCanonicalRoute
   */
  public function testGetCanonicalRoute(?Route $expected, EntityTypeInterface $entity_type, ?FieldStorageDefinitionInterface $field_storage_definition = NULL) : void {
    if ($field_storage_definition) {
      $this->entityFieldManager
        ->getFieldStorageDefinitions($entity_type->id())
        ->willReturn([
        $entity_type->getKey('id') => $field_storage_definition,
      ]);
    }
    $route = $this->routeProvider
      ->getCanonicalRoute($entity_type);
    $this->assertEquals($expected, $route);
  }
  public static function providerTestGetCanonicalRoute() {
    $prophet = new Prophet();
    $data = [];
    $entity_type1 = static::getEntityType();
    $entity_type1->hasLinkTemplate('canonical')
      ->willReturn(FALSE);
    $data['no_canonical_link_template'] = [
      NULL,
      $entity_type1->reveal(),
    ];
    $entity_type2 = static::getEntityType();
    $entity_type2->hasLinkTemplate('canonical')
      ->willReturn(TRUE);
    $entity_type2->hasViewBuilderClass()
      ->willReturn(FALSE);
    $data['no_view_builder'] = [
      NULL,
      $entity_type2->reveal(),
    ];
    $entity_type3 = static::getEntityType($entity_type2);
    $entity_type3->hasViewBuilderClass()
      ->willReturn(TRUE);
    $entity_type3->id()
      ->willReturn('the_entity_type_id');
    $entity_type3->getLinkTemplate('canonical')
      ->willReturn('/the/canonical/link/template');
    $entity_type3->entityClassImplements(FieldableEntityInterface::class)
      ->willReturn(FALSE);
    $route = (new Route('/the/canonical/link/template'))->setDefaults([
      '_entity_view' => 'the_entity_type_id.full',
      '_title_callback' => '\\Drupal\\Core\\Entity\\Controller\\EntityController::title',
    ])
      ->setRequirements([
      '_entity_access' => 'the_entity_type_id.view',
    ])
      ->setOptions([
      'parameters' => [
        'the_entity_type_id' => [
          'type' => 'entity:the_entity_type_id',
        ],
      ],
    ]);
    $data['id_key_type_null'] = [
      clone $route,
      $entity_type3->reveal(),
    ];
    $entity_type4 = static::getEntityType($entity_type3);
    $entity_type4->entityClassImplements(FieldableEntityInterface::class)
      ->willReturn(TRUE);
    $entity_type4->getKey('id')
      ->willReturn('id');
    $route->setRequirement('the_entity_type_id', '\\d+');
    $field_storage_definition = $prophet->prophesize(FieldStorageDefinitionInterface::class);
    $field_storage_definition->getType()
      ->willReturn('integer');
    $data['id_key_type_integer'] = [
      clone $route,
      $entity_type4->reveal(),
      $field_storage_definition->reveal(),
    ];
    return $data;
  }
  
  /**
   * @covers ::getCollectionRoute
   * @dataProvider providerTestGetCollectionRoute
   */
  public function testGetCollectionRoute(?Route $expected, EntityTypeInterface $entity_type) : void {
    $route = $this->routeProvider
      ->getCollectionRoute($entity_type);
    $this->assertEquals($expected, $route);
  }
  public static function providerTestGetCollectionRoute() {
    $data = [];
    $entity_type1 = static::getEntityType();
    $entity_type1->hasLinkTemplate('collection')
      ->willReturn(FALSE);
    $entity_type1->getAdminPermission()
      ->willReturn(FALSE);
    $entity_type1->getCollectionPermission()
      ->willReturn(NULL);
    $data['no_collection_link_template'] = [
      NULL,
      $entity_type1->reveal(),
    ];
    $entity_type2 = static::getEntityType();
    $entity_type2->getAdminPermission()
      ->willReturn(FALSE);
    $entity_type2->getCollectionPermission()
      ->willReturn(NULL);
    $entity_type2->hasLinkTemplate('collection')
      ->willReturn(TRUE);
    $entity_type2->hasListBuilderClass()
      ->willReturn(FALSE);
    $data['no_list_builder'] = [
      NULL,
      $entity_type2->reveal(),
    ];
    $entity_type3 = static::getEntityType($entity_type2);
    $entity_type3->hasListBuilderClass()
      ->willReturn(TRUE);
    $entity_type3->getAdminPermission()
      ->willReturn(FALSE);
    $entity_type3->getCollectionPermission()
      ->willReturn(NULL);
    $data['no_permission'] = [
      NULL,
      $entity_type3->reveal(),
    ];
    $entity_type4 = static::getEntityType($entity_type3);
    $entity_type4->getAdminPermission()
      ->willReturn(FALSE);
    $entity_type4->getCollectionPermission()
      ->willReturn('overview the entity type');
    $entity_type4->id()
      ->willReturn('the_entity_type_id');
    $entity_type4->getLabel()
      ->willReturn('The entity type');
    $entity_type4->getCollectionLabel()
      ->willReturn(new TranslatableMarkup('Test entities'));
    $entity_type4->getLinkTemplate('collection')
      ->willReturn('/the/collection/link/template');
    $entity_type4->entityClassImplements(FieldableEntityInterface::class)
      ->willReturn(FALSE);
    $route = (new Route('/the/collection/link/template'))->setDefaults([
      '_entity_list' => 'the_entity_type_id',
      '_title' => 'Test entities',
      '_title_arguments' => [],
      '_title_context' => '',
    ])
      ->setRequirements([
      '_permission' => 'overview the entity type',
    ]);
    $data['collection_route_with_collection_permission'] = [
      clone $route,
      $entity_type4->reveal(),
    ];
    $entity_type5 = static::getEntityType($entity_type4);
    $entity_type5->getAdminPermission()
      ->willReturn('administer the entity type');
    $entity_type5->getCollectionPermission()
      ->willReturn(NULL);
    $entity_type5->id()
      ->willReturn('the_entity_type_id');
    $entity_type5->getLabel()
      ->willReturn('The entity type');
    $entity_type5->getCollectionLabel()
      ->willReturn(new TranslatableMarkup('Test entities'));
    $entity_type5->getLinkTemplate('collection')
      ->willReturn('/the/collection/link/template');
    $entity_type5->entityClassImplements(FieldableEntityInterface::class)
      ->willReturn(FALSE);
    $route = (new Route('/the/collection/link/template'))->setDefaults([
      '_entity_list' => 'the_entity_type_id',
      '_title' => 'Test entities',
      '_title_arguments' => [],
      '_title_context' => '',
    ])
      ->setRequirements([
      '_permission' => 'administer the entity type',
    ]);
    $data['collection_route_with_admin_permission'] = [
      clone $route,
      $entity_type5->reveal(),
    ];
    $entity_type6 = static::getEntityType($entity_type5);
    $entity_type6->getAdminPermission()
      ->willReturn('administer the entity type');
    $entity_type6->getCollectionPermission()
      ->willReturn('overview the entity type');
    $entity_type6->id()
      ->willReturn('the_entity_type_id');
    $entity_type6->getLabel()
      ->willReturn('The entity type');
    $entity_type6->getCollectionLabel()
      ->willReturn(new TranslatableMarkup('Test entities'));
    $entity_type6->getLinkTemplate('collection')
      ->willReturn('/the/collection/link/template');
    $entity_type6->entityClassImplements(FieldableEntityInterface::class)
      ->willReturn(FALSE);
    $route = (new Route('/the/collection/link/template'))->setDefaults([
      '_entity_list' => 'the_entity_type_id',
      '_title' => 'Test entities',
      '_title_arguments' => [],
      '_title_context' => '',
    ])
      ->setRequirements([
      '_permission' => 'administer the entity type+overview the entity type',
    ]);
    $data['collection_route_with_both_permission'] = [
      clone $route,
      $entity_type6->reveal(),
    ];
    return $data;
  }
  
  /**
   * @covers ::getEntityTypeIdKeyType
   */
  public function testGetEntityTypeIdKeyType() : void {
    $entity_type = $this->prophesize(EntityTypeInterface::class);
    $entity_type->entityClassImplements(FieldableEntityInterface::class)
      ->willReturn(TRUE);
    $entity_type->id()
      ->willReturn('the_entity_type_id');
    $entity_type->getKey('id')
      ->willReturn('id');
    $field_storage_definition = $this->prophesize(FieldStorageDefinitionInterface::class);
    $field_storage_definition->getType()
      ->willReturn('integer');
    $this->entityFieldManager
      ->getFieldStorageDefinitions('the_entity_type_id')
      ->willReturn([
      'id' => $field_storage_definition,
    ]);
    $type = $this->routeProvider
      ->getEntityTypeIdKeyType($entity_type->reveal());
    $this->assertSame('integer', $type);
  }
  
  /**
   * @covers ::getEntityTypeIdKeyType
   */
  public function testGetEntityTypeIdKeyTypeNotFieldable() : void {
    $entity_type = $this->prophesize(EntityTypeInterface::class);
    $entity_type->entityClassImplements(FieldableEntityInterface::class)
      ->willReturn(FALSE);
    $this->entityFieldManager
      ->getFieldStorageDefinitions(Argument::any())
      ->shouldNotBeCalled();
    $type = $this->routeProvider
      ->getEntityTypeIdKeyType($entity_type->reveal());
    $this->assertNull($type);
  }
  
  /**
   * @param \Prophecy\Prophecy\ObjectProphecy|null $base_entity_type
   *   (optional) The prophesize base entity type.
   *
   * @return \Prophecy\Prophecy\ObjectProphecy
   */
  protected static function getEntityType(?ObjectProphecy $base_entity_type = NULL) {
    $entity_type = (new Prophet())->prophesize(EntityTypeInterface::class);
    if ($base_entity_type) {
      foreach ($base_entity_type->getMethodProphecies() as $method => $prophecies) {
        foreach ($prophecies as $prophecy) {
          $entity_type->addMethodProphecy(clone $prophecy);
        }
      }
    }
    return $entity_type;
  }

}

Members

Title Sort descending Deprecated Modifiers Object type Summary Overriden Title Overrides
DefaultHtmlRouteProviderTest::$entityFieldManager protected property The entity field manager prophecy used in the test.
DefaultHtmlRouteProviderTest::$entityTypeManager protected property The entity type manager prophecy used in the test.
DefaultHtmlRouteProviderTest::$routeProvider protected property The HTML route provider used in the test.
DefaultHtmlRouteProviderTest::getEntityType protected static function
DefaultHtmlRouteProviderTest::providerTestGetAddFormRoute public static function
DefaultHtmlRouteProviderTest::providerTestGetAddPageRoute public static function
DefaultHtmlRouteProviderTest::providerTestGetCanonicalRoute public static function
DefaultHtmlRouteProviderTest::providerTestGetCollectionRoute public static function
DefaultHtmlRouteProviderTest::setUp protected function Overrides UnitTestCase::setUp
DefaultHtmlRouteProviderTest::testGetAddFormRoute public function @covers ::getAddFormRoute[[api-linebreak]]
@dataProvider providerTestGetAddFormRoute
DefaultHtmlRouteProviderTest::testGetAddPageRoute public function @covers ::getAddPageRoute[[api-linebreak]]
@dataProvider providerTestGetAddPageRoute
DefaultHtmlRouteProviderTest::testGetCanonicalRoute public function @covers ::getCanonicalRoute[[api-linebreak]]
@dataProvider providerTestGetCanonicalRoute
DefaultHtmlRouteProviderTest::testGetCollectionRoute public function @covers ::getCollectionRoute[[api-linebreak]]
@dataProvider providerTestGetCollectionRoute
DefaultHtmlRouteProviderTest::testGetEntityTypeIdKeyType public function @covers ::getEntityTypeIdKeyType[[api-linebreak]]
DefaultHtmlRouteProviderTest::testGetEntityTypeIdKeyTypeNotFieldable public function @covers ::getEntityTypeIdKeyType[[api-linebreak]]
PhpUnitWarnings::$deprecationWarnings private static property Deprecation warnings from PHPUnit to raise with @trigger_error().
PhpUnitWarnings::addWarning public function Converts PHPUnit deprecation warnings to E_USER_DEPRECATED.
RandomGeneratorTrait::getRandomGenerator protected function Gets the random generator for the utility methods.
RandomGeneratorTrait::randomMachineName protected function Generates a unique random string containing letters and numbers.
RandomGeneratorTrait::randomObject public function Generates a random PHP object.
RandomGeneratorTrait::randomString public function Generates a pseudo-random string of ASCII characters of codes 32 to 126.
RandomGeneratorTrait::randomStringValidate Deprecated public function Callback for random string validation.
UnitTestCase::$root protected property The app root. 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::getStringTranslationStub public function Returns a stub translation manager that just returns the passed string.
UnitTestCase::setUpBeforeClass public static function
UnitTestCase::__get public function

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