ParamConverterManagerTest.php in Drupal 9

Namespace

Drupal\Tests\Core\ParamConverter

File

core/tests/Drupal/Tests/Core/ParamConverter/ParamConverterManagerTest.php

<?php

namespace Drupal\Tests\Core\ParamConverter;

use Drupal\Core\ParamConverter\ParamConverterManager;
use Drupal\Core\ParamConverter\ParamNotConvertedException;
use Drupal\Tests\UnitTestCase;
use Drupal\Core\Routing\RouteObjectInterface;
use Symfony\Component\Routing\Route;
use Symfony\Component\Routing\RouteCollection;

/**
 * @coversDefaultClass \Drupal\Core\ParamConverter\ParamConverterManager
 * @group ParamConverter
 */
class ParamConverterManagerTest extends UnitTestCase {

  /**
   * @var \Drupal\Core\ParamConverter\ParamConverterManager
   */
  protected $manager;

  /**
   * {@inheritdoc}
   */
  protected function setUp() : void {
    parent::setUp();
    $this->manager = new ParamConverterManager();
  }

  /**
   * Tests \Drupal\Core\ParamConverter\ParamConverterManager::getConverter().
   *
   * @dataProvider providerTestGetConverter
   *
   * @covers ::getConverter
   */
  public function testGetConverter($name, $class) {
    $converter = $this
      ->getMockBuilder('Drupal\\Core\\ParamConverter\\ParamConverterInterface')
      ->setMockClassName($class)
      ->getMock();
    $this->manager
      ->addConverter($converter, $name);
    $this
      ->assertInstanceOf($class, $this->manager
      ->getConverter($name));

    // Assert that a second call to getConverter() does not use the container.
    $this
      ->assertInstanceOf($class, $this->manager
      ->getConverter($name));
  }

  /**
   * Tests \Drupal\Core\ParamConverter\ParamConverterManager::getConverter().
   *
   * @covers ::getConverter
   */
  public function testGetConverterException() {
    $this
      ->expectException(\InvalidArgumentException::class);
    $this->manager
      ->getConverter('undefined.converter');
  }

  /**
   * Provide data for parameter converter manager tests.
   *
   * @return array
   *   An array of arrays, each containing the input parameters for
   *   providerTestResolvers::testAddConverter().
   *
   * @see ParamConverterManagerTest::testAddConverter()
   */
  public function providerTestAddConverter() {
    $converters[0]['unsorted'] = [
      [
        'name' => 'strawberry',
      ],
      [
        'name' => 'raspberry',
      ],
      [
        'name' => 'pear',
      ],
      [
        'name' => 'peach',
      ],
      [
        'name' => 'pineapple',
      ],
      [
        'name' => 'banana',
      ],
      [
        'name' => 'apple',
      ],
    ];
    $converters[0]['sorted'] = [
      'strawberry',
      'raspberry',
      'pear',
      'peach',
      'pineapple',
      'banana',
      'apple',
    ];
    $converters[1]['unsorted'] = [
      [
        'name' => 'giraffe',
      ],
      [
        'name' => 'zebra',
      ],
      [
        'name' => 'eagle',
      ],
      [
        'name' => 'ape',
      ],
      [
        'name' => 'cat',
      ],
      [
        'name' => 'puppy',
      ],
      [
        'name' => 'llama',
      ],
    ];
    $converters[1]['sorted'] = [
      'giraffe',
      'zebra',
      'eagle',
      'ape',
      'cat',
      'puppy',
      'llama',
    ];
    return $converters;
  }

  /**
   * Provide data for parameter converter manager tests.
   *
   * @return array
   *   An array of arrays, each containing the input parameters for
   *   providerTestResolvers::testGetConverter().
   *
   * @see ParamConverterManagerTest::testGetConverter()
   */
  public function providerTestGetConverter() {
    return [
      [
        'ape',
        'ApeConverterClass',
      ],
      [
        'cat',
        'CatConverterClass',
      ],
      [
        'puppy',
        'PuppyConverterClass',
      ],
      [
        'llama',
        'LlamaConverterClass',
      ],
      [
        'giraffe',
        'GiraffeConverterClass',
      ],
      [
        'zebra',
        'ZebraConverterClass',
      ],
      [
        'eagle',
        'EagleConverterClass',
      ],
    ];
  }

  /**
   * @covers ::setRouteParameterConverters
   *
   * @dataProvider providerTestSetRouteParameterConverters
   */
  public function testSetRouteParameterConverters($path, $parameters = NULL, $expected = NULL) {
    $converter = $this
      ->createMock('Drupal\\Core\\ParamConverter\\ParamConverterInterface');
    $converter
      ->expects($this
      ->any())
      ->method('applies')
      ->with($this
      ->anything(), 'id', $this
      ->anything())
      ->will($this
      ->returnValue(TRUE));
    $this->manager
      ->addConverter($converter, 'applied');
    $route = new Route($path);
    if ($parameters) {
      $route
        ->setOption('parameters', $parameters);
    }
    $collection = new RouteCollection();
    $collection
      ->add('test_route', $route);
    $this->manager
      ->setRouteParameterConverters($collection);
    foreach ($collection as $route) {
      $result = $route
        ->getOption('parameters');
      if ($expected) {
        $this
          ->assertSame($expected, $result['id']['converter']);
      }
      else {
        $this
          ->assertNull($result);
      }
    }
  }

  /**
   * Provides data for testSetRouteParameterConverters().
   */
  public function providerTestSetRouteParameterConverters() {
    return [
      [
        '/test',
      ],
      [
        '/test/{id}',
        [
          'id' => [],
        ],
        'applied',
      ],
      [
        '/test/{id}',
        [
          'id' => [
            'converter' => 'predefined',
          ],
        ],
        'predefined',
      ],
    ];
  }

  /**
   * @covers ::convert
   */
  public function testConvert() {
    $route = new Route('/test/{id}/{literal}/{null}');
    $parameters = [
      'id' => [
        'converter' => 'test_convert',
      ],
      'literal' => [],
      'null' => [],
    ];
    $route
      ->setOption('parameters', $parameters);
    $defaults = [
      RouteObjectInterface::ROUTE_OBJECT => $route,
      RouteObjectInterface::ROUTE_NAME => 'test_route',
      'id' => 1,
      'literal' => 'this is a literal',
      'null' => NULL,
    ];
    $expected = $defaults;
    $expected['id'] = 'something_better!';
    $converter = $this
      ->createMock('Drupal\\Core\\ParamConverter\\ParamConverterInterface');
    $converter
      ->expects($this
      ->any())
      ->method('convert')
      ->with(1, $this
      ->isType('array'), 'id', $this
      ->isType('array'))
      ->will($this
      ->returnValue('something_better!'));
    $this->manager
      ->addConverter($converter, 'test_convert');
    $result = $this->manager
      ->convert($defaults);
    $this
      ->assertEquals($expected, $result);
  }

  /**
   * @covers ::convert
   */
  public function testConvertNoConverting() {
    $route = new Route('/test');
    $defaults = [
      RouteObjectInterface::ROUTE_OBJECT => $route,
      RouteObjectInterface::ROUTE_NAME => 'test_route',
    ];
    $expected = $defaults;
    $result = $this->manager
      ->convert($defaults);
    $this
      ->assertEquals($expected, $result);
  }

  /**
   * @covers ::convert
   */
  public function testConvertMissingParam() {
    $route = new Route('/test/{id}');
    $parameters = [
      'id' => [
        'converter' => 'test_convert',
      ],
    ];
    $route
      ->setOption('parameters', $parameters);
    $defaults = [
      RouteObjectInterface::ROUTE_OBJECT => $route,
      RouteObjectInterface::ROUTE_NAME => 'test_route',
      'id' => 1,
    ];
    $converter = $this
      ->createMock('Drupal\\Core\\ParamConverter\\ParamConverterInterface');
    $converter
      ->expects($this
      ->any())
      ->method('convert')
      ->with(1, $this
      ->isType('array'), 'id', $this
      ->isType('array'))
      ->will($this
      ->returnValue(NULL));
    $this->manager
      ->addConverter($converter, 'test_convert');
    $this
      ->expectException(ParamNotConvertedException::class);
    $this
      ->expectExceptionMessage('The "id" parameter was not converted for the path "/test/{id}" (route name: "test_route")');
    $this->manager
      ->convert($defaults);
  }

}

Classes

Name	Description
ParamConverterManagerTest	@coversDefaultClass \Drupal\Core\ParamConverter\ParamConverterManager @group ParamConverter