You are here

ContainerTest.php in Service Container 7

File

tests/src/DependencyInjection/ContainerTest.php
View source
<?php

/**
 * @file
 * Contains \Drupal\Tests\service_container\DependencyInjection\ContainerTest
 */
namespace Drupal\Tests\service_container\DependencyInjection;

use Drupal\service_container\DependencyInjection\Container;
use Drupal\service_container\DependencyInjection\ContainerInterface;
use Mockery;

/**
 * @coversDefaultClass \Drupal\service_container\DependencyInjection\Container
 * @group dic
 */
class ContainerTest extends \PHPUnit_Framework_TestCase {

  /**
   * The tested container.
   *
   * @var \Drupal\service_container\DependencyInjection\Container
   */
  protected $container;

  /**
   * The container definition used for the test.
   *
   * @var []
   */
  protected $containerDefinition;
  public function setUp() {
    $this->containerDefinition = $this
      ->getMockContainerDefinition();
    $this->container = new Container($this->containerDefinition);
  }

  /**
   * Tests that Container::hasDefinition() works properly.
   * @covers ::hasDefinition()
   */
  public function test_hasDefinition() {
    $this
      ->assertEquals($this->container
      ->hasDefinition('service_container'), TRUE, 'Container has definition of itself.');
    $this
      ->assertEquals($this->container
      ->hasDefinition('service.does_not_exist'), FALSE, 'Container does not have non-existent service.');
    $this
      ->assertEquals($this->container
      ->hasDefinition('service.provider'), TRUE, 'Container has service.provider service.');
  }

  /**
   * Tests that Container::getDefinition() works properly.
   * @covers ::getDefinition()
   */
  public function test_getDefinition() {
    $this
      ->assertEquals($this->containerDefinition['services']['service_container'], $this->container
      ->getDefinition('service_container'), 'Container definition matches for container service.');
    $this
      ->assertEquals($this->containerDefinition['services']['service.provider'], $this->container
      ->getDefinition('service.provider'), 'Container definition matches for service.provider service.');
  }

  /**
   * Tests that Container::getDefinition() works properly.
   * @expectedException \RuntimeException
   * @covers ::getDefinition()
   */
  public function test_getDefinition_exception() {
    $this->container
      ->getDefinition('service_not_exist');
  }

  /**
   * Tests that Container::getDefinitions() works properly.
   * @covers ::getDefinitions()
   */
  public function test_getDefinitions() {
    $this
      ->assertEquals($this->containerDefinition['services'], $this->container
      ->getDefinitions(), 'Container definition matches input.');
  }

  /**
   * Tests that Container::getParameter() works properly.
   * @covers ::getParameter()
   */
  public function test_getParameter() {
    $this
      ->assertEquals($this->containerDefinition['parameters']['some_config'], $this->container
      ->getParameter('some_config'), 'Container parameter matches for %some_config%.');
    $this
      ->assertEquals($this->containerDefinition['parameters']['some_other_config'], $this->container
      ->getParameter('some_other_config'), 'Container parameter matches for %some_other_config%.');
  }

  /**
   * Tests that Container::hasParameter() works properly.
   * @covers ::hasParameter()
   */
  public function test_hasParameter() {
    $this
      ->assertTrue($this->container
      ->hasParameter('some_config'), 'Container parameters include %some_config%.');
    $this
      ->assertFalse($this->container
      ->hasParameter('some_config_not_exists'), 'Container parameters do not include %some_config_not_exists%.');
  }

  /**
   * Tests that Container::setParameter() in an unfrozen case works properly.
   *
   * @covers ::setParameter()
   */
  public function test_setParameter_unfrozenContainer() {
    $this->containerDefinition['frozen'] = FALSE;
    $this->container = new Container($this->containerDefinition);
    $this->container
      ->setParameter('some_config', 'new_value');
    $this
      ->assertEquals('new_value', $this->container
      ->getParameter('some_config'), 'Container parameters can be set.');
  }

  /**
   * Tests that Container::setParameter() in a frozen case works properly.
   *
   * @covers ::setParameter()
   *
   * @expectedException \Symfony\Component\DependencyInjection\Exception\LogicException
   */
  public function test_setParameter_frozenContainer() {
    $this->containerDefinition['frozen'] = TRUE;
    $this->container = new Container($this->containerDefinition);
    $this->container
      ->setParameter('some_config', 'new_value');
  }

  /**
   * Tests that Container::get() works properly.
   * @covers ::get()
   */
  public function test_get() {
    $container = $this->container
      ->get('service_container');
    $this
      ->assertSame($this->container, $container, 'Container can be retrieved from itself.');

    // Retrieve services of the container.
    $other_service_class = $this->containerDefinition['services']['other.service']['class'];
    $other_service = $this->container
      ->get('other.service');
    $this
      ->assertInstanceOf($other_service_class, $other_service, 'other.service has the right class.');
    $some_parameter = $this->containerDefinition['parameters']['some_config'];
    $some_other_parameter = $this->containerDefinition['parameters']['some_other_config'];
    $service = $this->container
      ->get('service.provider');
    $this
      ->assertEquals($other_service, $service
      ->getSomeOtherService(), '@other.service was injected via constructor.');
    $this
      ->assertEquals($some_parameter, $service
      ->getSomeParameter(), '%some_config% was injected via constructor.');
    $this
      ->assertEquals($this->container, $service
      ->getContainer(), 'Container was injected via setter injection.');
    $this
      ->assertEquals($some_other_parameter, $service
      ->getSomeOtherParameter(), '%some_other_config% was injected via setter injection.');
    $this
      ->assertEquals($service->_someProperty, 'foo', 'Service has added properties.');
  }

  /**
   * Tests that Container::set() works properly.
   *
   * @covers ::set()
   */
  public function test_set() {
    $this
      ->assertNull($this->container
      ->get('new_id', ContainerInterface::NULL_ON_INVALID_REFERENCE));
    $mock_service = new MockService();
    $this->container
      ->set('new_id', $mock_service);
    $this
      ->assertSame($mock_service, $this->container
      ->get('new_id'), 'A manual set service works as expected.');
  }

  /**
   * Tests that Container::has() works properly.
   *
   * @covers ::has()
   */
  public function test_has() {
    $this
      ->assertTrue($this->container
      ->has('other.service'));
    $this
      ->assertFalse($this->container
      ->has('another.service'));

    // Set the service manually, ensure that its also respected.
    $mock_service = new MockService();
    $this->container
      ->set('another.service', $mock_service);
    $this
      ->assertTrue($this->container
      ->has('another.service'));
  }

  /**
   * Tests that Container::get() for circular dependencies works properly.
   * @expectedException \RuntimeException
   * @covers ::get()
   */
  public function test_get_circular() {
    $this->container
      ->get('circular_dependency');
  }

  /**
   * Tests that Container::get() for non-existant dependencies works properly.
   * @expectedException \Symfony\Component\DependencyInjection\Exception\ServiceNotFoundException
   * @covers ::get()
   */
  public function test_get_exception() {
    $this->container
      ->get('service_not_exists');
  }

  /**
   * Tests that Container::get() for non-existant parameters works properly.
   * @covers ::get()
   * @covers ::resolveServicesAndParameters()
   */
  public function test_get_notFound_parameter() {
    $service = $this->container
      ->get('service_parameter_not_exists', ContainerInterface::NULL_ON_INVALID_REFERENCE);
    $this
      ->assertNull($service, 'Some service is NULL.');
  }

  /**
   * Tests Container::get() with an exception due to missing parameter on the second call.
   *
   * @covers ::get()
   * @covers ::resolveServicesAndParameters()
   *
   * @expectedException \Symfony\Component\DependencyInjection\Exception\ParameterNotFoundException
   */
  public function test_get_notFound_parameterWithExceptionOnSecondCall() {
    $service = $this->container
      ->get('service_parameter_not_exists', ContainerInterface::NULL_ON_INVALID_REFERENCE);
    $this
      ->assertNull($service, 'Some service is NULL.');

    // Reset the service.
    $this->container
      ->set('service_parameter_not_exists', NULL);
    $this->container
      ->get('service_parameter_not_exists');
  }

  /**
   * Tests that Container::get() for non-existant parameters works properly.
   * @expectedException \Symfony\Component\DependencyInjection\Exception\ParameterNotFoundException
   * @covers ::get()
   * @covers ::resolveServicesAndParameters()
   */
  public function test_get_notFound_parameter_exception() {
    $this->container
      ->get('service_parameter_not_exists');
  }

  /**
   * Tests that Container::get() for non-existent dependencies works properly.
   * @covers ::get()
   * @covers ::resolveServicesAndParameters()
   */
  public function test_get_notFound_dependency() {
    $service = $this->container
      ->get('service_dependency_not_exists', ContainerInterface::NULL_ON_INVALID_REFERENCE);
    $this
      ->assertNull($service, 'Some service is NULL.');
  }

  /**
   * Tests that Container::get() for non-existant dependencies works properly.
   * @expectedException \Symfony\Component\DependencyInjection\Exception\ServiceNotFoundException
   * @covers ::get()
   * @covers ::resolveServicesAndParameters()
   */
  public function test_get_notFound_dependency_exception() {
    $this->container
      ->get('service_dependency_not_exists');
  }

  /**
   * Tests that Container::get() for non-existant dependencies works properly.
   * @covers ::get()
   */
  public function test_get_notFound() {
    $this
      ->assertNull($this->container
      ->get('service_not_exists', ContainerInterface::NULL_ON_INVALID_REFERENCE), 'Not found service does not throw exception.');
  }

  /**
   * Tests multiple Container::get() calls for non-existing dependencies work.
   *
   * @covers ::get()
   */
  public function test_get_notFoundMultiple() {
    $container = \Mockery::mock('Drupal\\service_container\\DependencyInjection\\Container[getDefinition]', array(
      $this->containerDefinition,
    ));
    $this
      ->assertNull($container
      ->get('service_not_exists', ContainerInterface::NULL_ON_INVALID_REFERENCE, 'Not found service does not throw exception.'));
    $this
      ->assertNull($container
      ->get('service_not_exists', ContainerInterface::NULL_ON_INVALID_REFERENCE, 'Not found service does not throw exception on second call.'));
  }

  /**
   * Tests multiple Container::get() calls with exception on the second time.
   *
   * @covers ::get()
   *
   * @expectedException \Symfony\Component\DependencyInjection\Exception\ServiceNotFoundException
   */
  public function test_get_notFoundMultipleWithExceptionOnSecondCall() {
    $this
      ->assertNull($this->container
      ->get('service_not_exists', ContainerInterface::NULL_ON_INVALID_REFERENCE, 'Not found service does nto throw exception.'));
    $this->container
      ->get('service_not_exists');
  }

  /**
   * Tests that Container::get() for aliased services works properly.
   * @covers ::get()
   */
  public function test_get_alias() {
    $service = $this->container
      ->get('service.provider');
    $aliased_service = $this->container
      ->get('service.provider_alias');
    $this
      ->assertSame($service, $aliased_service);
  }

  /**
   * Tests Container::get() for factories via services (Symfony 2.7.0).
   * @covers ::get()
   */
  public function test_get_factoryServiceNew() {
    $factory_service = $this->container
      ->get('factory_service_new');
    $factory_service_class = $this->container
      ->getParameter('factory_service_class');
    $this
      ->assertInstanceOf($factory_service_class, $factory_service);
  }

  /**
   * Tests that Container::get() for factories via class works (Symfony 2.7.0).
   * @covers ::get()
   */
  public function test_get_factoryClassNew() {
    $service = $this->container
      ->get('service.provider');
    $factory_service = $this->container
      ->get('factory_class_new');
    $this
      ->assertInstanceOf(get_class($service), $factory_service);
    $this
      ->assertEquals('bar', $factory_service
      ->getSomeParameter(), 'Correct parameter was passed via the factory class instantiation.');
    $this
      ->assertEquals($this->container, $factory_service
      ->getContainer(), 'Container was injected via setter injection.');
  }

  /**
   * Tests that private services work correctly.
   * @covers ::get()
   * @covers ::resolveServicesAndParameters()
   */
  public function test_resolveServicesAndParameters_privateService() {
    $service = $this->container
      ->get('service_using_private');
    $private_service = $service
      ->getSomeOtherService();
    $this
      ->assertEquals($private_service
      ->getSomeParameter(), 'really_private_lama', 'Private was found successfully');
  }

  /**
   * Tests that services with an array of arguments work correctly.
   * @covers ::get()
   * @covers ::resolveServicesAndParameters()
   */
  public function test_resolveServicesAndParameters_array() {
    $service = $this->container
      ->get('service_using_array');
    $other_service = $this->container
      ->get('other.service');
    $this
      ->assertEquals($other_service, $service
      ->getSomeOtherService(), '@other.service was injected via constructor.');
  }

  /**
   * Tests that services that are optional work correctly.
   * @covers ::get()
   * @covers ::resolveServicesAndParameters()
   */
  public function test_resolveServicesAndParameters_optional() {
    $service = $this->container
      ->get('service_with_optional_dependency');
    $this
      ->assertNull($service
      ->getSomeOtherService(), 'other service was NULL was expected.');
  }

  /**
   * Tests that Container::initialized works correctly.
   * @covers ::initialized()
   */
  public function test_initialized() {
    $this
      ->assertFalse($this->container
      ->initialized('late.service'), 'Late service is not initialized.');
    $this->container
      ->get('late.service');
    $this
      ->assertTrue($this->container
      ->initialized('late.service'), 'Late service is initialized after it was gotten.');
  }

  /**
   * Camelizes a string.
   *
   * @covers ::camelize
   * @dataProvider underscoreCamelizeDataProvider
   */
  public function test_camelize($string_underscore, $string_camelize) {
    $result = $this->container
      ->camelize($string_underscore);
    $this
      ->assertEquals($string_camelize, $result);
  }

  /**
   * Un-camelizes a string.
   *
   * @covers ::underscore
   * @dataProvider underscoreCamelizeDataProvider
   */
  public function test_underscore($string_underscore, $string_camelize) {
    $result = $this->container
      ->underscore($string_camelize);
    $this
      ->assertEquals($string_underscore, $result);
  }

  /**
   * Data Provider for ::underscore and ::camelize.
   */
  public function underscoreCamelizeDataProvider() {
    return array(
      array(
        'service_container',
        'ServiceContainer',
      ),
      array(
        'service_container_symfony',
        'ServiceContainerSymfony',
      ),
      array(
        '123service_container',
        '123serviceContainer',
      ),
      array(
        '123service_container_symfony',
        '123serviceContainerSymfony',
      ),
      array(
        '123service_container',
        '123serviceContainer',
      ),
      array(
        '123service_container_symfony',
        '123serviceContainerSymfony',
      ),
    );
  }

  /**
   * Returns a mock container definition.
   *
   * @return array
   *   Associated array with parameters and services.
   */
  protected function getMockContainerDefinition() {
    $fake_service = Mockery::mock('alias:Drupal\\Tests\\service_container\\DependencyInjection\\FakeService');
    $parameters = array();
    $parameters['some_private_config'] = 'really_private_lama';
    $parameters['some_config'] = 'foo';
    $parameters['some_other_config'] = 'lama';
    $parameters['factory_service_class'] = get_class($fake_service);
    $services = array();
    $services['service_container'] = array(
      'class' => '\\Drupal\\service_container\\DependencyInjection\\Container',
    );
    $services['other.service'] = array(
      // @todo Support parameter expansion for classes.
      'class' => get_class($fake_service),
    );
    $services['late.service'] = array(
      'class' => get_class($fake_service),
    );
    $services['service.provider'] = array(
      'class' => '\\Drupal\\Tests\\service_container\\DependencyInjection\\MockService',
      'arguments' => array(
        '@other.service',
        '%some_config%',
      ),
      'properties' => array(
        '_someProperty' => 'foo',
      ),
      'calls' => array(
        array(
          'setContainer',
          array(
            '@service_container',
          ),
        ),
        array(
          'setOtherConfigParameter',
          array(
            '%some_other_config%',
          ),
        ),
      ),
      'priority' => 0,
    );
    $private_service = array(
      'class' => '\\Drupal\\Tests\\service_container\\DependencyInjection\\MockService',
      'arguments' => array(
        '@other.service',
        '%some_private_config%',
      ),
      'public' => FALSE,
    );
    $private_hash = sha1(serialize($private_service));
    $services['service_using_private'] = array(
      'class' => '\\Drupal\\Tests\\service_container\\DependencyInjection\\MockService',
      'arguments' => array(
        (object) array(
          'type' => 'private_service',
          'value' => $private_service,
          'id' => 'private__' . $private_hash,
        ),
        '%some_config%',
      ),
    );
    $services['service_using_array'] = array(
      'class' => '\\Drupal\\Tests\\service_container\\DependencyInjection\\MockService',
      'arguments' => array(
        array(
          '@other.service',
        ),
        '%some_private_config%',
      ),
    );
    $services['service_with_optional_dependency'] = array(
      'class' => '\\Drupal\\Tests\\service_container\\DependencyInjection\\MockService',
      'arguments' => array(
        '@?service.does_not_exist',
        '%some_private_config%',
      ),
    );
    $services['factory_service'] = array(
      'class' => '\\Drupal\\service_container\\ServiceContainer\\ControllerInterface',
      'factory_method' => 'getFactoryMethod',
      'factory_service' => 'service.provider',
      'arguments' => array(
        '%factory_service_class%',
      ),
    );
    $services['factory_class'] = array(
      'class' => '\\Drupal\\service_container\\ServiceContainer\\ControllerInterface',
      'factory_method' => 'getFactoryMethod',
      'factory_class' => '\\Drupal\\Tests\\service_container\\DependencyInjection\\MockService',
      'arguments' => array(
        '\\Drupal\\Tests\\service_container\\DependencyInjection\\MockService',
        array(
          NULL,
          'bar',
        ),
      ),
      'calls' => array(
        array(
          'setContainer',
          array(
            '@service_container',
          ),
        ),
      ),
    );
    $services['factory_service_new'] = array(
      'class' => '\\Drupal\\service_container\\ServiceContainer\\ControllerInterface',
      'factory' => array(
        '@service.provider',
        'getFactoryMethod',
      ),
      'arguments' => array(
        '%factory_service_class%',
      ),
    );
    $services['factory_class_new'] = array(
      'class' => '\\Drupal\\service_container\\ServiceContainer\\ControllerInterface',
      'factory' => '\\Drupal\\Tests\\service_container\\DependencyInjection\\MockService::getFactoryMethod',
      'arguments' => array(
        '\\Drupal\\Tests\\service_container\\DependencyInjection\\MockService',
        array(
          NULL,
          'bar',
        ),
      ),
      'calls' => array(
        array(
          'setContainer',
          array(
            '@service_container',
          ),
        ),
      ),
    );
    $services['wrong_factory'] = array(
      'class' => '\\Drupal\\service_container\\ServiceContainer\\ControllerInterface',
      'factory_method' => 'getFactoryMethod',
    );
    $services['circular_dependency'] = array(
      'class' => '\\Drupal\\Tests\\service_container\\DependencyInjection\\MockService',
      'arguments' => array(
        '@circular_dependency',
      ),
    );
    $services['service_parameter_not_exists'] = array(
      'class' => '\\Drupal\\Tests\\service_container\\DependencyInjection\\MockService',
      'arguments' => array(
        '@service.provider',
        '%not_exists%',
        -1,
      ),
    );
    $services['service_dependency_not_exists'] = array(
      'class' => '\\Drupal\\Tests\\service_container\\DependencyInjection\\MockService',
      'arguments' => array(
        '@service_not_exists',
        '%some_config%',
      ),
    );
    return array(
      'parameters' => $parameters,
      'services' => $services,
      'aliases' => array(
        'service.provider_alias' => 'service.provider',
      ),
    );
  }

}

Classes