class RouteProviderTest

Basic tests for the RouteProvider.

Hierarchy

Expanded class hierarchy of RouteProviderTest

File

drupal/core/modules/system/lib/Drupal/system/Tests/Routing/RouteProviderTest.php, line 24
Contains Drupal\system\Tests\Routing\RouteProviderTest.

Namespace

Drupal\system\Tests\Routing
View source
class RouteProviderTest extends UnitTestBase {

  /**
   * A collection of shared fixture data for tests.
   *
   * @var RoutingFixtures
   */
  protected $fixtures;
  public static function getInfo() {
    return array(
      'name' => 'Route Provider tests',
      'description' => 'Confirm that the default route provider is working correctly.',
      'group' => 'Routing',
    );
  }
  function __construct($test_id = NULL) {
    parent::__construct($test_id);
    $this->fixtures = new RoutingFixtures();
  }
  public function tearDown() {
    $this->fixtures
      ->dropTables(Database::getConnection());
    parent::tearDown();
  }

  /**
   * Confirms that the correct candidate outlines are generated.
   */
  public function testCandidateOutlines() {
    $connection = Database::getConnection();
    $provider = new RouteProvider($connection);
    $parts = array(
      'node',
      '5',
      'edit',
    );
    $candidates = $provider
      ->getCandidateOutlines($parts);
    $candidates = array_flip($candidates);
    $this
      ->assertTrue(count($candidates) == 8, 'Correct number of candidates found');
    $this
      ->assertTrue(array_key_exists('/node/5/edit', $candidates), 'First candidate found.');
    $this
      ->assertTrue(array_key_exists('/node/5/%', $candidates), 'Second candidate found.');
    $this
      ->assertTrue(array_key_exists('/node/%/edit', $candidates), 'Third candidate found.');
    $this
      ->assertTrue(array_key_exists('/node/%/%', $candidates), 'Fourth candidate found.');
    $this
      ->assertTrue(array_key_exists('/node/5', $candidates), 'Fifth candidate found.');
    $this
      ->assertTrue(array_key_exists('/node/%', $candidates), 'Sixth candidate found.');
    $this
      ->assertTrue(array_key_exists('/node', $candidates), 'Seventh candidate found.');
    $this
      ->assertTrue(array_key_exists('/', $candidates), 'Eighth candidate found.');
  }

  /**
   * Confirms that we can find routes with the exact incoming path.
   */
  function testExactPathMatch() {
    $connection = Database::getConnection();
    $provider = new RouteProvider($connection, 'test_routes');
    $this->fixtures
      ->createTables($connection);
    $dumper = new MatcherDumper($connection, 'test_routes');
    $dumper
      ->addRoutes($this->fixtures
      ->sampleRouteCollection());
    $dumper
      ->dump();
    $path = '/path/one';
    $request = Request::create($path, 'GET');
    $routes = $provider
      ->getRouteCollectionForRequest($request);
    foreach ($routes as $route) {
      $this
        ->assertEqual($route
        ->getPattern(), $path, 'Found path has correct pattern');
    }
  }

  /**
   * Confirms that we can find routes whose pattern would match the request.
   */
  function testOutlinePathMatch() {
    $connection = Database::getConnection();
    $provider = new RouteProvider($connection, 'test_routes');
    $this->fixtures
      ->createTables($connection);
    $dumper = new MatcherDumper($connection, 'test_routes');
    $dumper
      ->addRoutes($this->fixtures
      ->complexRouteCollection());
    $dumper
      ->dump();
    $path = '/path/1/one';
    $request = Request::create($path, 'GET');
    $routes = $provider
      ->getRouteCollectionForRequest($request);

    // All of the matching paths have the correct pattern.
    foreach ($routes as $route) {
      $this
        ->assertEqual($route
        ->compile()
        ->getPatternOutline(), '/path/%/one', 'Found path has correct pattern');
    }
    $this
      ->assertEqual(count($routes), 2, 'The correct number of routes was found.');
    $this
      ->assertNotNull($routes
      ->get('route_a'), 'The first matching route was found.');
    $this
      ->assertNotNull($routes
      ->get('route_b'), 'The second matching route was not found.');
  }

  /**
   * Confirms that a trailing slash on the request doesn't result in a 404.
   */
  function testOutlinePathMatchTrailingSlash() {
    $connection = Database::getConnection();
    $provider = new RouteProvider($connection, 'test_routes');
    $this->fixtures
      ->createTables($connection);
    $dumper = new MatcherDumper($connection, 'test_routes');
    $dumper
      ->addRoutes($this->fixtures
      ->complexRouteCollection());
    $dumper
      ->dump();
    $path = '/path/1/one/';
    $request = Request::create($path, 'GET');
    $routes = $provider
      ->getRouteCollectionForRequest($request);

    // All of the matching paths have the correct pattern.
    foreach ($routes as $route) {
      $this
        ->assertEqual($route
        ->compile()
        ->getPatternOutline(), '/path/%/one', 'Found path has correct pattern');
    }
    $this
      ->assertEqual(count($routes), 2, 'The correct number of routes was found.');
    $this
      ->assertNotNull($routes
      ->get('route_a'), 'The first matching route was found.');
    $this
      ->assertNotNull($routes
      ->get('route_b'), 'The second matching route was not found.');
  }

  /**
   * Confirms that we can find routes whose pattern would match the request.
   */
  function testOutlinePathMatchDefaults() {
    $connection = Database::getConnection();
    $provider = new RouteProvider($connection, 'test_routes');
    $this->fixtures
      ->createTables($connection);
    $collection = new RouteCollection();
    $collection
      ->add('poink', new Route('/some/path/{value}', array(
      'value' => 'poink',
    )));
    $dumper = new MatcherDumper($connection, 'test_routes');
    $dumper
      ->addRoutes($collection);
    $dumper
      ->dump();
    $path = '/some/path';
    $request = Request::create($path, 'GET');
    try {
      $routes = $provider
        ->getRouteCollectionForRequest($request);

      // All of the matching paths have the correct pattern.
      foreach ($routes as $route) {
        $this
          ->assertEqual($route
          ->compile()
          ->getPatternOutline(), '/some/path', 'Found path has correct pattern');
      }
      $this
        ->assertEqual(count($routes), 1, 'The correct number of routes was found.');
      $this
        ->assertNotNull($routes
        ->get('poink'), 'The first matching route was found.');
    } catch (ResourceNotFoundException $e) {
      $this
        ->fail('No matching route found with default argument value.');
    }
  }

  /**
   * Confirms that we can find routes whose pattern would match the request.
   */
  function testOutlinePathMatchDefaultsCollision() {
    $connection = Database::getConnection();
    $provider = new RouteProvider($connection, 'test_routes');
    $this->fixtures
      ->createTables($connection);
    $collection = new RouteCollection();
    $collection
      ->add('poink', new Route('/some/path/{value}', array(
      'value' => 'poink',
    )));
    $collection
      ->add('narf', new Route('/some/path/here'));
    $dumper = new MatcherDumper($connection, 'test_routes');
    $dumper
      ->addRoutes($collection);
    $dumper
      ->dump();
    $path = '/some/path';
    $request = Request::create($path, 'GET');
    try {
      $routes = $provider
        ->getRouteCollectionForRequest($request);

      // All of the matching paths have the correct pattern.
      foreach ($routes as $route) {
        $this
          ->assertEqual($route
          ->compile()
          ->getPatternOutline(), '/some/path', 'Found path has correct pattern');
      }
      $this
        ->assertEqual(count($routes), 1, 'The correct number of routes was found.');
      $this
        ->assertNotNull($routes
        ->get('poink'), 'The first matching route was found.');
    } catch (ResourceNotFoundException $e) {
      $this
        ->fail('No matching route found with default argument value.');
    }
  }

  /**
   * Confirms that we can find routes whose pattern would match the request.
   */
  function testOutlinePathMatchDefaultsCollision2() {
    $connection = Database::getConnection();
    $provider = new RouteProvider($connection, 'test_routes');
    $this->fixtures
      ->createTables($connection);
    $collection = new RouteCollection();
    $collection
      ->add('poink', new Route('/some/path/{value}', array(
      'value' => 'poink',
    )));
    $collection
      ->add('narf', new Route('/some/path/here'));
    $collection
      ->add('eep', new Route('/something/completely/different'));
    $dumper = new MatcherDumper($connection, 'test_routes');
    $dumper
      ->addRoutes($collection);
    $dumper
      ->dump();
    $path = '/some/path/here';
    $request = Request::create($path, 'GET');
    try {
      $routes = $provider
        ->getRouteCollectionForRequest($request);
      $this
        ->assertEqual(count($routes), 2, 'The correct number of routes was found.');
      $this
        ->assertNotNull($routes
        ->get('narf'), 'The first matching route was found.');
      $this
        ->assertNotNull($routes
        ->get('poink'), 'The second matching route was found.');
      $this
        ->assertNull($routes
        ->get('eep'), 'Noin-matching route was not found.');
    } catch (ResourceNotFoundException $e) {
      $this
        ->fail('No matching route found with default argument value.');
    }
  }

  /**
   * Tests a route with a 0 as value.
   */
  public function testOutlinePathMatchZero() {
    $connection = Database::getConnection();
    $provider = new RouteProvider($connection, 'test_routes');
    $this->fixtures
      ->createTables($connection);
    $collection = new RouteCollection();
    $collection
      ->add('poink', new Route('/some/path/{value}'));
    $dumper = new MatcherDumper($connection, 'test_routes');
    $dumper
      ->addRoutes($collection);
    $dumper
      ->dump();
    $path = '/some/path/0';
    $request = Request::create($path, 'GET');
    try {
      $routes = $provider
        ->getRouteCollectionForRequest($request);

      // All of the matching paths have the correct pattern.
      foreach ($routes as $route) {
        $this
          ->assertEqual($route
          ->compile()
          ->getPatternOutline(), '/some/path/%', 'Found path has correct pattern');
      }
      $this
        ->assertEqual(count($routes), 1, 'The correct number of routes was found.');
    } catch (ResourceNotFoundException $e) {
      $this
        ->fail('No matchout route found with 0 as argument value');
    }
  }

  /**
   * Confirms that an exception is thrown when no matching path is found.
   */
  function testOutlinePathNoMatch() {
    $connection = Database::getConnection();
    $provider = new RouteProvider($connection, 'test_routes');
    $this->fixtures
      ->createTables($connection);
    $dumper = new MatcherDumper($connection, 'test_routes');
    $dumper
      ->addRoutes($this->fixtures
      ->complexRouteCollection());
    $dumper
      ->dump();
    $path = '/no/such/path';
    $request = Request::create($path, 'GET');
    try {
      $routes = $provider
        ->getRouteCollectionForRequest($request);
      $this
        ->fail(t('No exception was thrown.'));
    } catch (\Exception $e) {
      $this
        ->assertTrue($e instanceof ResourceNotFoundException, 'The correct exception was thrown.');
    }
  }

  /**
   * Confirms that system_path attribute overrides request path.
   */
  function testSystemPathMatch() {
    $connection = Database::getConnection();
    $provider = new RouteProvider($connection, 'test_routes');
    $this->fixtures
      ->createTables($connection);
    $dumper = new MatcherDumper($connection, 'test_routes');
    $dumper
      ->addRoutes($this->fixtures
      ->sampleRouteCollection());
    $dumper
      ->dump();
    $request = Request::create('/path/one', 'GET');
    $request->attributes
      ->set('system_path', 'path/two');
    $routes = $provider
      ->getRouteCollectionForRequest($request);
    foreach ($routes as $route) {
      $this
        ->assertEqual($route
        ->getPattern(), '/path/two', 'Found path has correct pattern');
    }
  }

  /**
   * Test RouteProvider::getRouteByName() and RouteProvider::getRoutesByNames().
   */
  protected function testRouteByName() {
    $connection = Database::getConnection();
    $provider = new RouteProvider($connection, 'test_routes');
    $this->fixtures
      ->createTables($connection);
    $dumper = new MatcherDumper($connection, 'test_routes');
    $dumper
      ->addRoutes($this->fixtures
      ->sampleRouteCollection());
    $dumper
      ->dump();
    $route = $provider
      ->getRouteByName('route_a');
    $this
      ->assertEqual($route
      ->getPattern(), '/path/one', 'The right route pattern was found.');
    $this
      ->assertEqual($route
      ->getRequirement('_method'), 'GET', 'The right route method was found.');
    $route = $provider
      ->getRouteByName('route_b');
    $this
      ->assertEqual($route
      ->getPattern(), '/path/one', 'The right route pattern was found.');
    $this
      ->assertEqual($route
      ->getRequirement('_method'), 'PUT', 'The right route method was found.');
    $exception_thrown = FALSE;
    try {
      $provider
        ->getRouteByName('invalid_name');
    } catch (RouteNotFoundException $e) {
      $exception_thrown = TRUE;
    }
    $this
      ->assertTrue($exception_thrown, 'Random route was not found.');
    $routes = $provider
      ->getRoutesByNames(array(
      'route_c',
      'route_d',
      $this
        ->randomName(),
    ));
    $this
      ->assertEqual(count($routes), 2, 'Only two valid routes found.');
    $this
      ->assertEqual($routes['route_c']
      ->getPattern(), '/path/two');
    $this
      ->assertEqual($routes['route_d']
      ->getPattern(), '/path/three');
  }

}

Members

Namesort descending Modifiers Type Description Overrides
RouteProviderTest::$fixtures protected property A collection of shared fixture data for tests.
RouteProviderTest::getInfo public static function
RouteProviderTest::tearDown public function Deletes created files, database tables, and reverts all environment changes. Overrides TestBase::tearDown
RouteProviderTest::testCandidateOutlines public function Confirms that the correct candidate outlines are generated.
RouteProviderTest::testExactPathMatch function Confirms that we can find routes with the exact incoming path.
RouteProviderTest::testOutlinePathMatch function Confirms that we can find routes whose pattern would match the request.
RouteProviderTest::testOutlinePathMatchDefaults function Confirms that we can find routes whose pattern would match the request.
RouteProviderTest::testOutlinePathMatchDefaultsCollision function Confirms that we can find routes whose pattern would match the request.
RouteProviderTest::testOutlinePathMatchDefaultsCollision2 function Confirms that we can find routes whose pattern would match the request.
RouteProviderTest::testOutlinePathMatchTrailingSlash function Confirms that a trailing slash on the request doesn't result in a 404.
RouteProviderTest::testOutlinePathMatchZero public function Tests a route with a 0 as value.
RouteProviderTest::testOutlinePathNoMatch function Confirms that an exception is thrown when no matching path is found.
RouteProviderTest::testRouteByName protected function Test RouteProvider::getRouteByName() and RouteProvider::getRoutesByNames().
RouteProviderTest::testSystemPathMatch function Confirms that system_path attribute overrides request path.
RouteProviderTest::__construct function Constructor for UnitTestBase. Overrides UnitTestBase::__construct
TestBase::$assertions protected property Assertions thrown in that test case.
TestBase::$configImporter protected property The config importer that can used in a test. 1
TestBase::$container protected property The dependency injection container used in the test. 1
TestBase::$databasePrefix protected property The database prefix of this test run.
TestBase::$dieOnFail public property Whether to die in case any test assertion fails.
TestBase::$originalFileDirectory protected property The original file directory, before it was changed for testing purposes.
TestBase::$originalPrefix protected property The original database prefix when running inside Simpletest.
TestBase::$originalSettings protected property The settings array.
TestBase::$public_files_directory protected property The public file directory for the test environment.
TestBase::$results public property Current results of this test case.
TestBase::$setup protected property Flag to indicate whether the test has been set up.
TestBase::$setupDatabasePrefix protected property
TestBase::$setupEnvironment protected property
TestBase::$skipClasses protected property This class is skipped when looking for the source of an assertion.
TestBase::$testId protected property The test run ID.
TestBase::$timeLimit protected property Time limit for the test.
TestBase::$verbose protected property TRUE if verbose debugging is enabled.
TestBase::$verboseClassName protected property Safe class name for use in verbose output filenames.
TestBase::$verboseDirectory protected property Directory where verbose output files are put.
TestBase::$verboseDirectoryUrl protected property URL to the verbose output file directory.
TestBase::$verboseId protected property Incrementing identifier for verbose output filenames.
TestBase::assert protected function Internal helper: stores the assert.
TestBase::assertEqual protected function Check to see if two values are equal.
TestBase::assertFalse protected function Check to see if a value is false (an empty string, 0, NULL, or FALSE).
TestBase::assertIdentical protected function Check to see if two values are identical.
TestBase::assertIdenticalObject protected function Checks to see if two objects are identical.
TestBase::assertNotEqual protected function Check to see if two values are not equal.
TestBase::assertNotIdentical protected function Check to see if two values are not identical.
TestBase::assertNotNull protected function Check to see if a value is not NULL.
TestBase::assertNull protected function Check to see if a value is NULL.
TestBase::assertTrue protected function Check to see if a value is not false (not an empty string, 0, NULL, or FALSE).
TestBase::changeDatabasePrefix protected function Changes the database connection to the prefixed one.
TestBase::checkRequirements protected function Checks the matching requirements for Test. 4
TestBase::configImporter public function Returns a ConfigImporter object to import test importing of configuration. 1
TestBase::copyConfig public function Copies configuration objects from source storage to target storage.
TestBase::deleteAssert public static function Delete an assertion record by message ID.
TestBase::error protected function Fire an error assertion. 1
TestBase::errorHandler public function Handle errors during test runs.
TestBase::exceptionHandler protected function Handle exceptions.
TestBase::fail protected function Fire an assertion that is always negative.
TestBase::filePreDeleteCallback public static function Ensures test files are deletable within file_unmanaged_delete_recursive().
TestBase::generatePermutations public static function Converts a list of possible parameters into a stack of permutations.
TestBase::getAssertionCall protected function Cycles through backtrace until the first non-assertion method is found.
TestBase::getDatabaseConnection public static function Returns the database connection to the site running Simpletest.
TestBase::insertAssert public static function Store an assertion from outside the testing context.
TestBase::pass protected function Fire an assertion that is always positive.
TestBase::prepareConfigDirectories protected function Create and set new configuration directories. 1
TestBase::prepareDatabasePrefix protected function Generates a database prefix for running tests.
TestBase::prepareEnvironment protected function Prepares the current environment for running the test.
TestBase::randomName public static function Generates a random string containing letters and numbers.
TestBase::randomObject public static function Generates a random PHP object.
TestBase::randomString public static function Generates a random string of ASCII characters of codes 32 to 126.
TestBase::rebuildContainer protected function Rebuild drupal_container(). 1
TestBase::run public function Run all tests in this class.
TestBase::settingsSet protected function Changes in memory settings.
TestBase::verbose protected function Logs verbose message in a text file.
UnitTestBase::$configDirectories protected property
UnitTestBase::setUp protected function Sets up unit test environment. 19