You are here

PluginManagerBaseTest.php in Zircon Profile 8

File

core/tests/Drupal/Tests/Component/Plugin/PluginManagerBaseTest.php
View source
<?php

/**
 * @file
 * Contains \Drupal\Tests\Component\Plugin\PluginManagerBaseTest.
 */
namespace Drupal\Tests\Component\Plugin;

use Drupal\Component\Plugin\Exception\PluginNotFoundException;
use Drupal\Tests\UnitTestCase;

/**
 * @coversDefaultClass \Drupal\Component\Plugin\PluginManagerBase
 * @group Plugin
 */
class PluginManagerBaseTest extends UnitTestCase {

  /**
   * A callback method for mocking FactoryInterface objects.
   */
  public function createInstanceCallback() {
    $args = func_get_args();
    $plugin_id = $args[0];
    $configuration = $args[1];
    if ('invalid' == $plugin_id) {
      throw new PluginNotFoundException($plugin_id);
    }
    return array(
      'plugin_id' => $plugin_id,
      'configuration' => $configuration,
    );
  }

  /**
   * Generates a mocked FactoryInterface object with known properties.
   */
  public function getMockFactoryInterface($expects_count) {
    $mock_factory = $this
      ->getMockBuilder('Drupal\\Component\\Plugin\\Factory\\FactoryInterface')
      ->setMethods(array(
      'createInstance',
    ))
      ->getMockForAbstractClass();
    $mock_factory
      ->expects($this
      ->exactly($expects_count))
      ->method('createInstance')
      ->willReturnCallback(array(
      $this,
      'createInstanceCallback',
    ));
    return $mock_factory;
  }

  /**
   * Tests createInstance() with no fallback methods.
   *
   * @covers ::createInstance
   */
  public function testCreateInstance() {
    $manager = $this
      ->getMockBuilder('Drupal\\Component\\Plugin\\PluginManagerBase')
      ->getMockForAbstractClass();

    // PluginManagerBase::createInstance() looks for a factory object and then
    // calls createInstance() on it. So we have to mock a factory object.
    $factory_ref = new \ReflectionProperty($manager, 'factory');
    $factory_ref
      ->setAccessible(TRUE);
    $factory_ref
      ->setValue($manager, $this
      ->getMockFactoryInterface(1));

    // Finally the test.
    $configuration_array = array(
      'config' => 'something',
    );
    $result = $manager
      ->createInstance('valid', $configuration_array);
    $this
      ->assertEquals('valid', $result['plugin_id']);
    $this
      ->assertArrayEquals($configuration_array, $result['configuration']);
  }

  /**
   * Tests createInstance() with a fallback method.
   *
   * @covers ::createInstance
   */
  public function testCreateInstanceFallback() {

    // We use our special stub class which extends PluginManagerBase and also
    // implements FallbackPluginManagerInterface.
    $manager = new StubFallbackPluginManager();

    // Put our stubbed factory on the base object.
    $factory_ref = new \ReflectionProperty($manager, 'factory');
    $factory_ref
      ->setAccessible(TRUE);

    // Set up the configuration array.
    $configuration_array = array(
      'config' => 'something',
    );

    // Test with fallback interface and valid plugin_id.
    $factory_ref
      ->setValue($manager, $this
      ->getMockFactoryInterface(1));
    $no_fallback_result = $manager
      ->createInstance('valid', $configuration_array);
    $this
      ->assertEquals('valid', $no_fallback_result['plugin_id']);
    $this
      ->assertArrayEquals($configuration_array, $no_fallback_result['configuration']);

    // Test with fallback interface and invalid plugin_id.
    $factory_ref
      ->setValue($manager, $this
      ->getMockFactoryInterface(2));
    $fallback_result = $manager
      ->createInstance('invalid', $configuration_array);
    $this
      ->assertEquals('invalid_fallback', $fallback_result['plugin_id']);
    $this
      ->assertArrayEquals($configuration_array, $fallback_result['configuration']);
  }

}

Classes

Namesort descending Description
PluginManagerBaseTest @coversDefaultClass \Drupal\Component\Plugin\PluginManagerBase @group Plugin