You are here

Home » API reference » Drupal 8 » TaggedHandlersPassTest.php

class TaggedHandlersPassTest in Drupal 8

Same name and namespace in other branches
  1. 9 core/tests/Drupal/Tests/Core/DependencyInjection/Compiler/TaggedHandlersPassTest.php \Drupal\Tests\Core\DependencyInjection\Compiler\TaggedHandlersPassTest
  2. 10 core/tests/Drupal/Tests/Core/DependencyInjection/Compiler/TaggedHandlersPassTest.php \Drupal\Tests\Core\DependencyInjection\Compiler\TaggedHandlersPassTest

@coversDefaultClass \Drupal\Core\DependencyInjection\Compiler\TaggedHandlersPass @group DependencyInjection

Hierarchy

Expanded class hierarchy of TaggedHandlersPassTest

File

core/tests/Drupal/Tests/Core/DependencyInjection/Compiler/TaggedHandlersPassTest.php, line 20
Contains \Drupal\Tests\Core\DependencyInjection\Compiler\TaggedHandlersPassTest.

Namespace

Drupal\Tests\Core\DependencyInjection\Compiler
View source 
class TaggedHandlersPassTest extends UnitTestCase {
  protected function buildContainer($environment = 'dev') {
    $container = new ContainerBuilder();
    $container
      ->setParameter('kernel.environment', $environment);
    return $container;
  }

  /**
   * Tests without any consumers.
   *
   * @covers ::process
   */
  public function testProcessNoConsumers() {
    $container = $this
      ->buildContainer();
    $container
      ->register('consumer_id', __NAMESPACE__ . '\\ValidConsumer');
    $handler_pass = new TaggedHandlersPass();
    $handler_pass
      ->process($container);
    $this
      ->assertCount(2, $container
      ->getDefinitions());
    $this
      ->assertFalse($container
      ->getDefinition('consumer_id')
      ->hasMethodCall('addHandler'));
  }

  /**
   * Tests a required consumer with no handlers.
   *
   * @covers ::process
   */
  public function testProcessRequiredHandlers() {
    $container = $this
      ->buildContainer();
    $container
      ->register('consumer_id', __NAMESPACE__ . '\\ValidConsumer')
      ->addTag('service_collector', [
      'required' => TRUE,
    ]);
    $handler_pass = new TaggedHandlersPass();
    $this
      ->expectException(LogicException::class);
    $this
      ->expectExceptionMessage("At least one service tagged with 'consumer_id' is required.");
    $handler_pass
      ->process($container);
  }

  /**
   * Tests a required consumer with no handlers.
   *
   * @covers ::process
   * @covers ::processServiceIdCollectorPass
   */
  public function testIdCollectorProcessRequiredHandlers() {
    $this
      ->expectException(LogicException::class);
    $this
      ->expectExceptionMessage("At least one service tagged with 'consumer_id' is required.");
    $container = $this
      ->buildContainer();
    $container
      ->register('consumer_id', __NAMESPACE__ . '\\ValidConsumer')
      ->addTag('service_id_collector', [
      'required' => TRUE,
    ]);
    $handler_pass = new TaggedHandlersPass();
    $handler_pass
      ->process($container);
  }

  /**
   * Tests consumer with missing interface in non-production environment.
   *
   * @covers ::process
   */
  public function testProcessMissingInterface() {
    $container = $this
      ->buildContainer();
    $container
      ->register('consumer_id0', __NAMESPACE__ . '\\ValidConsumer')
      ->addTag('service_collector');
    $container
      ->register('consumer_id1', __NAMESPACE__ . '\\InvalidConsumer')
      ->addTag('service_collector');
    $handler_pass = new TaggedHandlersPass();
    $this
      ->expectException(LogicException::class);
    $this
      ->expectExceptionMessage("Service consumer 'consumer_id1' class method Drupal\\Tests\\Core\\DependencyInjection\\Compiler\\InvalidConsumer::addHandler() has to type-hint an interface.");
    $handler_pass
      ->process($container);
  }

  /**
   * Tests one consumer and two handlers.
   *
   * @covers ::process
   */
  public function testProcess() {
    $container = $this
      ->buildContainer();
    $container
      ->register('consumer_id', __NAMESPACE__ . '\\ValidConsumer')
      ->addTag('service_collector');
    $container
      ->register('handler1', __NAMESPACE__ . '\\ValidHandler')
      ->addTag('consumer_id');
    $container
      ->register('handler2', __NAMESPACE__ . '\\ValidHandler')
      ->addTag('consumer_id');
    $handler_pass = new TaggedHandlersPass();
    $handler_pass
      ->process($container);
    $method_calls = $container
      ->getDefinition('consumer_id')
      ->getMethodCalls();
    $this
      ->assertCount(2, $method_calls);
  }

  /**
   * Tests one consumer and two handlers with service ID collection.
   *
   * @covers ::process
   */
  public function testserviceIdProcess() {
    $container = $this
      ->buildContainer();
    $container
      ->register('consumer_id', __NAMESPACE__ . '\\ValidConsumer')
      ->addTag('service_id_collector');
    $container
      ->register('handler1', __NAMESPACE__ . '\\ValidHandler')
      ->addTag('consumer_id');
    $container
      ->register('handler2', __NAMESPACE__ . '\\ValidHandler')
      ->addTag('consumer_id');
    $handler_pass = new TaggedHandlersPass();
    $handler_pass
      ->process($container);
    $arguments = $container
      ->getDefinition('consumer_id')
      ->getArguments();
    $this
      ->assertCount(1, $arguments);
    $this
      ->assertCount(2, $arguments[0]);
  }

  /**
   * Tests handler priority sorting.
   *
   * @covers ::process
   */
  public function testProcessPriority() {
    $container = $this
      ->buildContainer();
    $container
      ->register('consumer_id', __NAMESPACE__ . '\\ValidConsumer')
      ->addTag('service_collector');
    $container
      ->register('handler1', __NAMESPACE__ . '\\ValidHandler')
      ->addTag('consumer_id');
    $container
      ->register('handler2', __NAMESPACE__ . '\\ValidHandler')
      ->addTag('consumer_id', [
      'priority' => 10,
    ]);
    $handler_pass = new TaggedHandlersPass();
    $handler_pass
      ->process($container);
    $method_calls = $container
      ->getDefinition('consumer_id')
      ->getMethodCalls();
    $this
      ->assertCount(2, $method_calls);
    $this
      ->assertEquals(new Reference('handler2'), $method_calls[0][1][0]);
    $this
      ->assertEquals(10, $method_calls[0][1][1]);
    $this
      ->assertEquals(new Reference('handler1'), $method_calls[1][1][0]);
    $this
      ->assertEquals(0, $method_calls[1][1][1]);
  }

  /**
   * Tests handler priority sorting for service ID collection.
   *
   * @covers ::process
   */
  public function testserviceIdProcessPriority() {
    $container = $this
      ->buildContainer();
    $container
      ->register('consumer_id', __NAMESPACE__ . '\\ValidConsumer')
      ->addTag('service_id_collector');
    $container
      ->register('handler1', __NAMESPACE__ . '\\ValidHandler')
      ->addTag('consumer_id');
    $container
      ->register('handler2', __NAMESPACE__ . '\\ValidHandler')
      ->addTag('consumer_id', [
      'priority' => 20,
    ]);
    $container
      ->register('handler3', __NAMESPACE__ . '\\ValidHandler')
      ->addTag('consumer_id', [
      'priority' => 10,
    ]);
    $handler_pass = new TaggedHandlersPass();
    $handler_pass
      ->process($container);
    $arguments = $container
      ->getDefinition('consumer_id')
      ->getArguments();
    $this
      ->assertCount(1, $arguments);
    $this
      ->assertSame([
      'handler2',
      'handler3',
      'handler1',
    ], $arguments[0]);
  }

  /**
   * Tests consumer method without priority parameter.
   *
   * @covers ::process
   */
  public function testProcessNoPriorityParam() {
    $container = $this
      ->buildContainer();
    $container
      ->register('consumer_id', __NAMESPACE__ . '\\ValidConsumer')
      ->addTag('service_collector', [
      'call' => 'addNoPriority',
    ]);
    $container
      ->register('handler1', __NAMESPACE__ . '\\ValidHandler')
      ->addTag('consumer_id');
    $container
      ->register('handler2', __NAMESPACE__ . '\\ValidHandler')
      ->addTag('consumer_id', [
      'priority' => 10,
    ]);
    $handler_pass = new TaggedHandlersPass();
    $handler_pass
      ->process($container);
    $method_calls = $container
      ->getDefinition('consumer_id')
      ->getMethodCalls();
    $this
      ->assertCount(2, $method_calls);
    $this
      ->assertEquals(new Reference('handler2'), $method_calls[0][1][0]);
    $this
      ->assertCount(1, $method_calls[0][1]);
    $this
      ->assertEquals(new Reference('handler1'), $method_calls[1][1][0]);
    $this
      ->assertCount(1, $method_calls[0][1]);
  }

  /**
   * Tests consumer method with an ID parameter.
   *
   * @covers ::process
   */
  public function testProcessWithIdParameter() {
    $container = $this
      ->buildContainer();
    $container
      ->register('consumer_id', __NAMESPACE__ . '\\ValidConsumer')
      ->addTag('service_collector', [
      'call' => 'addWithId',
    ]);
    $container
      ->register('handler1', __NAMESPACE__ . '\\ValidHandler')
      ->addTag('consumer_id');
    $container
      ->register('handler2', __NAMESPACE__ . '\\ValidHandler')
      ->addTag('consumer_id', [
      'priority' => 10,
    ]);
    $handler_pass = new TaggedHandlersPass();
    $handler_pass
      ->process($container);
    $method_calls = $container
      ->getDefinition('consumer_id')
      ->getMethodCalls();
    $this
      ->assertCount(2, $method_calls);
    $this
      ->assertEquals(new Reference('handler2'), $method_calls[0][1][0]);
    $this
      ->assertEquals('handler2', $method_calls[0][1][1]);
    $this
      ->assertEquals(10, $method_calls[0][1][2]);
    $this
      ->assertEquals(new Reference('handler1'), $method_calls[1][1][0]);
    $this
      ->assertEquals('handler1', $method_calls[1][1][1]);
    $this
      ->assertEquals(0, $method_calls[1][1][2]);
  }

  /**
   * Tests interface validation in non-production environment.
   *
   * @covers ::process
   */
  public function testProcessInterfaceMismatch() {
    $container = $this
      ->buildContainer();
    $container
      ->register('consumer_id', __NAMESPACE__ . '\\ValidConsumer')
      ->addTag('service_collector');
    $container
      ->register('handler1', __NAMESPACE__ . '\\InvalidHandler')
      ->addTag('consumer_id');
    $container
      ->register('handler2', __NAMESPACE__ . '\\ValidHandler')
      ->addTag('consumer_id', [
      'priority' => 10,
    ]);
    $handler_pass = new TaggedHandlersPass();
    $this
      ->expectException(LogicException::class);
    $handler_pass
      ->process($container);
  }

  /**
   * Tests consumer method with extra parameters.
   *
   * @covers ::process
   */
  public function testProcessWithExtraArguments() {
    $container = $this
      ->buildContainer();
    $container
      ->register('consumer_id', __NAMESPACE__ . '\\ValidConsumerWithExtraArguments')
      ->addTag('service_collector');
    $container
      ->register('handler1', __NAMESPACE__ . '\\ValidHandler')
      ->addTag('consumer_id', [
      'extra1' => 'extra1',
      'extra2' => 'extra2',
    ]);
    $handler_pass = new TaggedHandlersPass();
    $handler_pass
      ->process($container);
    $method_calls = $container
      ->getDefinition('consumer_id')
      ->getMethodCalls();
    $this
      ->assertCount(4, $method_calls[0][1]);
    $this
      ->assertEquals(new Reference('handler1'), $method_calls[0][1][0]);
    $this
      ->assertEquals(0, $method_calls[0][1][1]);
    $this
      ->assertEquals('extra1', $method_calls[0][1][2]);
    $this
      ->assertEquals('extra2', $method_calls[0][1][3]);
  }

  /**
   * Tests consumer method with extra parameters and no priority.
   *
   * @covers ::process
   */
  public function testProcessNoPriorityAndExtraArguments() {
    $container = $this
      ->buildContainer();
    $container
      ->register('consumer_id', __NAMESPACE__ . '\\ValidConsumerWithExtraArguments')
      ->addTag('service_collector', [
      'call' => 'addNoPriority',
    ]);
    $container
      ->register('handler1', __NAMESPACE__ . '\\ValidHandler')
      ->addTag('consumer_id', [
      'extra' => 'extra',
    ]);
    $handler_pass = new TaggedHandlersPass();
    $handler_pass
      ->process($container);
    $method_calls = $container
      ->getDefinition('consumer_id')
      ->getMethodCalls();
    $this
      ->assertCount(2, $method_calls[0][1]);
    $this
      ->assertEquals(new Reference('handler1'), $method_calls[0][1][0]);
    $this
      ->assertEquals('extra', $method_calls[0][1][1]);
  }

  /**
   * Tests consumer method with priority, id and extra parameters.
   *
   * @covers ::process
   */
  public function testProcessWithIdAndExtraArguments() {
    $container = $this
      ->buildContainer();
    $container
      ->register('consumer_id', __NAMESPACE__ . '\\ValidConsumerWithExtraArguments')
      ->addTag('service_collector', [
      'call' => 'addWithId',
    ]);
    $container
      ->register('handler1', __NAMESPACE__ . '\\ValidHandler')
      ->addTag('consumer_id', [
      'extra1' => 'extra1',
    ]);
    $handler_pass = new TaggedHandlersPass();
    $handler_pass
      ->process($container);
    $method_calls = $container
      ->getDefinition('consumer_id')
      ->getMethodCalls();
    $this
      ->assertCount(5, $method_calls[0][1]);
    $this
      ->assertEquals(new Reference('handler1'), $method_calls[0][1][0]);
    $this
      ->assertEquals('handler1', $method_calls[0][1][1]);
    $this
      ->assertEquals(0, $method_calls[0][1][2]);
    $this
      ->assertEquals('extra1', $method_calls[0][1][3]);
    $this
      ->assertNull($method_calls[0][1][4]);
  }

  /**
   * Tests consumer method with priority and extra parameters in different order.
   *
   * @covers ::process
   */
  public function testProcessWithDifferentArgumentsOrderAndDefaultValue() {
    $container = $this
      ->buildContainer();
    $container
      ->register('consumer_id', __NAMESPACE__ . '\\ValidConsumerWithExtraArguments')
      ->addTag('service_collector', [
      'call' => 'addWithDifferentOrder',
    ]);
    $container
      ->register('handler1', __NAMESPACE__ . '\\ValidHandler')
      ->addTag('consumer_id', [
      'priority' => 0,
      'extra1' => 'extra1',
      'extra3' => 'extra3',
    ]);
    $handler_pass = new TaggedHandlersPass();
    $handler_pass
      ->process($container);
    $method_calls = $container
      ->getDefinition('consumer_id')
      ->getMethodCalls();
    $this
      ->assertCount(5, $method_calls[0][1]);
    $expected = [
      new Reference('handler1'),
      'extra1',
      0,
      'default2',
      'extra3',
    ];
    $this
      ->assertEquals($expected, array_values($method_calls[0][1]));
  }

}

Members

Namesort descending Modifiers Type Description Overrides
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.
TaggedHandlersPassTest::buildContainer protected function
TaggedHandlersPassTest::testIdCollectorProcessRequiredHandlers public function Tests a required consumer with no handlers.
TaggedHandlersPassTest::testProcess public function Tests one consumer and two handlers.
TaggedHandlersPassTest::testProcessInterfaceMismatch public function Tests interface validation in non-production environment.
TaggedHandlersPassTest::testProcessMissingInterface public function Tests consumer with missing interface in non-production environment.
TaggedHandlersPassTest::testProcessNoConsumers public function Tests without any consumers.
TaggedHandlersPassTest::testProcessNoPriorityAndExtraArguments public function Tests consumer method with extra parameters and no priority.
TaggedHandlersPassTest::testProcessNoPriorityParam public function Tests consumer method without priority parameter.
TaggedHandlersPassTest::testProcessPriority public function Tests handler priority sorting.
TaggedHandlersPassTest::testProcessRequiredHandlers public function Tests a required consumer with no handlers.
TaggedHandlersPassTest::testProcessWithDifferentArgumentsOrderAndDefaultValue public function Tests consumer method with priority and extra parameters in different order.
TaggedHandlersPassTest::testProcessWithExtraArguments public function Tests consumer method with extra parameters.
TaggedHandlersPassTest::testProcessWithIdAndExtraArguments public function Tests consumer method with priority, id and extra parameters.
TaggedHandlersPassTest::testProcessWithIdParameter public function Tests consumer method with an ID parameter.
TaggedHandlersPassTest::testserviceIdProcess public function Tests one consumer and two handlers with service ID collection.
TaggedHandlersPassTest::testserviceIdProcessPriority public function Tests handler priority sorting for service ID collection.
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.
UnitTestCase::setUp protected function 340