class ViewExecutableTest

Tests the ViewExecutable class.

Hierarchy

Expanded class hierarchy of ViewExecutableTest

See also

Drupal\views\ViewExecutable

File

drupal/core/modules/views/lib/Drupal/views/Tests/ViewExecutableTest.php, line 26
Contains \Drupal\views\Tests\ViewExecutableTest.

Namespace

Drupal\views\Tests
View source
class ViewExecutableTest extends ViewUnitTestBase {
  public static $modules = array(
    'system',
    'node',
    'comment',
    'user',
    'filter',
  );

  /**
   * Views used by this test.
   *
   * @var array
   */
  public static $testViews = array(
    'test_destroy',
    'test_executable_displays',
  );

  /**
   * Properties that should be stored in the configuration.
   *
   * @var array
   */
  protected $configProperties = array(
    'disabled',
    'name',
    'description',
    'tag',
    'base_table',
    'label',
    'core',
    'display',
  );

  /**
   * Properties that should be stored in the executable.
   *
   * @var array
   */
  protected $executableProperties = array(
    'storage',
    'built',
    'executed',
    'args',
    'build_info',
    'result',
    'attachment_before',
    'attachment_after',
    'exposed_data',
    'exposed_input',
    'exposed_raw_input',
    'old_view',
    'parent_views',
  );
  public static function getInfo() {
    return array(
      'name' => 'View executable tests',
      'description' => 'Tests the ViewExecutable class.',
      'group' => 'Views',
    );
  }
  protected function setUpFixtures() {
    $this
      ->installSchema('user', array(
      'users',
      'role_permission',
    ));
    $this
      ->installSchema('node', array(
      'node_type',
      'node',
      'node_field_data',
    ));
    $this
      ->installSchema('comment', array(
      'comment',
      'node_comment_statistics',
    ));
    parent::setUpFixtures();
    $this
      ->installConfig(array(
      'filter',
    ));
  }

  /**
   * Tests the views.exectuable container service.
   */
  public function testFactoryService() {
    $factory = $this->container
      ->get('views.executable');
    $this
      ->assertTrue($factory instanceof ViewExecutableFactory, 'A ViewExecutableFactory instance was returned from the container.');
    $view = entity_load('view', 'test_executable_displays');
    $this
      ->assertTrue($factory
      ->get($view) instanceof ViewExecutable, 'A ViewExecutable instance was returned from the factory.');
  }

  /**
   * Tests the initDisplay() and initHandlers() methods.
   */
  public function testInitMethods() {
    $view = views_get_view('test_destroy');
    $view
      ->initDisplay();
    $this
      ->assertTrue($view->display_handler instanceof DefaultDisplay, 'Make sure a reference to the current display handler is set.');
    $this
      ->assertTrue($view->displayHandlers
      ->get('default') instanceof DefaultDisplay, 'Make sure a display handler is created for each display.');
    $view
      ->destroy();
    $view
      ->initHandlers();

    // Check for all handler types.
    $handler_types = array_keys(ViewExecutable::viewsHandlerTypes());
    foreach ($handler_types as $type) {

      // The views_test integration doesn't have relationships.
      if ($type == 'relationship') {
        continue;
      }
      $this
        ->assertTrue(count($view->{$type}), format_string('Make sure a %type instance got instantiated.', array(
        '%type' => $type,
      )));
    }

    // initHandlers() should create display handlers automatically as well.
    $this
      ->assertTrue($view->display_handler instanceof DefaultDisplay, 'Make sure a reference to the current display handler is set.');
    $this
      ->assertTrue($view->displayHandlers
      ->get('default') instanceof DefaultDisplay, 'Make sure a display handler is created for each display.');
    $view_hash = spl_object_hash($view);
    $display_hash = spl_object_hash($view->display_handler);

    // Test the initStyle() method.
    $view
      ->initStyle();
    $this
      ->assertTrue($view->style_plugin instanceof DefaultStyle, 'Make sure a reference to the style plugin is set.');

    // Test the plugin has been inited and view have references to the view and
    // display handler.
    $this
      ->assertEqual(spl_object_hash($view->style_plugin->view), $view_hash);
    $this
      ->assertEqual(spl_object_hash($view->style_plugin->displayHandler), $display_hash);

    // Test the initQuery method().
    $view
      ->initQuery();
    $this
      ->assertTrue($view->query instanceof Sql, 'Make sure a reference to the query is set');
    $this
      ->assertEqual(spl_object_hash($view->query->view), $view_hash);
    $this
      ->assertEqual(spl_object_hash($view->query->displayHandler), $display_hash);
  }

  /**
   * Tests the generation of the executable object.
   */
  public function testConstructing() {
    views_get_view('test_destroy');
  }

  /**
   * Tests the accessing of values on the object.
   */
  public function testProperties() {
    $view = views_get_view('test_destroy');
    foreach ($this->executableProperties as $property) {
      $this
        ->assertTrue(isset($view->{$property}));
    }
  }

  /**
   * Tests the display related methods and properties.
   */
  public function testDisplays() {
    $view = views_get_view('test_executable_displays');

    // Tests Drupal\views\ViewExecutable::initDisplay().
    $view
      ->initDisplay();
    $this
      ->assertTrue($view->displayHandlers instanceof DisplayBag, 'The displayHandlers property has the right class.');

    // Tests the classes of the instances.
    $this
      ->assertTrue($view->displayHandlers
      ->get('default') instanceof DefaultDisplay);
    $this
      ->assertTrue($view->displayHandlers
      ->get('page_1') instanceof Page);
    $this
      ->assertTrue($view->displayHandlers
      ->get('page_2') instanceof Page);

    // After initializing the default display is the current used display.
    $this
      ->assertEqual($view->current_display, 'default');
    $this
      ->assertEqual(spl_object_hash($view->display_handler), spl_object_hash($view->displayHandlers
      ->get('default')));

    // All handlers should have a reference to the default display.
    $this
      ->assertEqual(spl_object_hash($view->displayHandlers
      ->get('page_1')->default_display), spl_object_hash($view->displayHandlers
      ->get('default')));
    $this
      ->assertEqual(spl_object_hash($view->displayHandlers
      ->get('page_2')->default_display), spl_object_hash($view->displayHandlers
      ->get('default')));

    // Tests Drupal\views\ViewExecutable::setDisplay().
    $view
      ->setDisplay();
    $this
      ->assertEqual($view->current_display, 'default', 'If setDisplay is called with no parameter the default display should be used.');
    $this
      ->assertEqual(spl_object_hash($view->display_handler), spl_object_hash($view->displayHandlers
      ->get('default')));

    // Set two different valid displays.
    $view
      ->setDisplay('page_1');
    $this
      ->assertEqual($view->current_display, 'page_1', 'If setDisplay is called with a valid display id the appropriate display should be used.');
    $this
      ->assertEqual(spl_object_hash($view->display_handler), spl_object_hash($view->displayHandlers
      ->get('page_1')));
    $view
      ->setDisplay('page_2');
    $this
      ->assertEqual($view->current_display, 'page_2', 'If setDisplay is called with a valid display id the appropriate display should be used.');
    $this
      ->assertEqual(spl_object_hash($view->display_handler), spl_object_hash($view->displayHandlers
      ->get('page_2')));

    // Destroy the view, so we can start again and test an invalid display.
    $view
      ->destroy();
    $count_before = count($this->assertions);
    $view
      ->setDisplay('invalid');
    $count_after = count($this->assertions);
    $this
      ->assertTrue($count_after - $count_before, 'Error is triggered while calling the wrong display.');
    $this
      ->assertEqual($view->current_display, 'default', 'If setDisplay is called with an invalid display id the default display should be used.');
    $this
      ->assertEqual(spl_object_hash($view->display_handler), spl_object_hash($view->displayHandlers
      ->get('default')));

    // Test the style and row plugins are replaced correctly when setting the
    // display.
    $view
      ->setDisplay('page_1');
    $view
      ->initStyle();
    $this
      ->assertTrue($view->style_plugin instanceof DefaultStyle);
    $this
      ->assertTrue($view->rowPlugin instanceof Fields);
    $view
      ->setDisplay('page_2');
    $view
      ->initStyle();
    $this
      ->assertTrue($view->style_plugin instanceof Grid);

    // @todo Change this rowPlugin type too.
    $this
      ->assertTrue($view->rowPlugin instanceof Fields);
  }

  /**
   * Tests the setting/getting of properties.
   */
  public function testPropertyMethods() {
    $view = views_get_view('test_executable_displays');

    // Test the setAjaxEnabled() method.
    $this
      ->assertFalse($view
      ->ajaxEnabled());
    $view
      ->setAjaxEnabled(TRUE);
    $this
      ->assertTrue($view
      ->ajaxEnabled());
    $view
      ->setDisplay();

    // There should be no pager set initially.
    $this
      ->assertNull($view
      ->usePager());

    // Add a pager, initialize, and test.
    $view->displayHandlers
      ->get('default')
      ->overrideOption('pager', array(
      'type' => 'full',
      'options' => array(
        'items_per_page' => 10,
      ),
    ));
    $view
      ->initPager();
    $this
      ->assertTrue($view
      ->usePager());

    // Test setting and getting the offset.
    $rand = rand();
    $view
      ->setOffset($rand);
    $this
      ->assertEqual($view
      ->getOffset(), $rand);

    // Test the getBaseTable() method.
    $expected = array(
      'views_test_data' => TRUE,
      '#global' => TRUE,
    );
    $this
      ->assertIdentical($view
      ->getBaseTables(), $expected);

    // Test response methods.
    $this
      ->assertTrue($view
      ->getResponse() instanceof Response, 'New response object returned.');
    $new_response = new Response();
    $view
      ->setResponse($new_response);
    $this
      ->assertIdentical(spl_object_hash($view
      ->getResponse()), spl_object_hash($new_response), 'New response object correctly set.');

    // Test the generateItemId() method.
    $test_ids = drupal_map_assoc(array(
      'test',
      'test_1',
    ));
    $this
      ->assertEqual($view
      ->generateItemId('new', $test_ids), 'new');
    $this
      ->assertEqual($view
      ->generateItemId('test', $test_ids), 'test_2');

    // Test the getPath() method.
    $path = $this
      ->randomName();
    $view->displayHandlers
      ->get('page_1')
      ->overrideOption('path', $path);
    $view
      ->setDisplay('page_1');
    $this
      ->assertEqual($view
      ->getPath(), $path);

    // Test the override_path property override.
    $override_path = $this
      ->randomName();
    $view->override_path = $override_path;
    $this
      ->assertEqual($view
      ->getPath(), $override_path);

    // Test the getUrl method().
    $url = $this
      ->randomString();
    $this
      ->assertEqual($view
      ->getUrl(NULL, $url), $url);

    // Test with arguments.
    $arg1 = $this
      ->randomString();
    $arg2 = rand();
    $this
      ->assertEqual($view
      ->getUrl(array(
      $arg1,
      $arg2,
    ), $url), "{$url}/{$arg1}/{$arg2}");

    // Test the override_url property override.
    $override_url = $this
      ->randomString();
    $view->override_url = $override_url;
    $this
      ->assertEqual($view
      ->getUrl(NULL, $url), $override_url);

    // Test the title methods.
    $title = $this
      ->randomString();
    $view
      ->setTitle($title);
    $this
      ->assertEqual($view
      ->getTitle(), $title);
  }

  /**
   * Tests the deconstructor to be sure that necessary objects are removed.
   */
  public function testDestroy() {
    $view = views_get_view('test_destroy');
    $view
      ->preview();
    $view
      ->destroy();
    $this
      ->assertViewDestroy($view);
  }

  /**
   * Asserts that expected view properties have been unset by destroy().
   *
   * @param \Drupal\views\ViewExecutable $view
   */
  protected function assertViewDestroy($view) {
    $reflection = new \ReflectionClass($view);
    $defaults = $reflection
      ->getDefaultProperties();

    // The storage should remain.
    unset($defaults['storage']);
    foreach ($defaults as $property => $default) {
      $this
        ->assertIdentical($this
        ->getProtectedProperty($view, $property), $default);
    }
  }

  /**
   * Returns a protected property from a class instance.
   *
   * @param object $instance
   *   The class instance to return the property from.
   * @param string $property
   *   The name of the property to return.
   *
   * @return mixed
   *   The instance property value.
   */
  protected function getProtectedProperty($instance, $property) {
    $reflection = new \ReflectionProperty($instance, $property);
    $reflection
      ->setAccessible(TRUE);
    return $reflection
      ->getValue($instance);
  }

  /**
   * Tests ViewExecutable::viewsHandlerTypes().
   */
  public function testViewsHandlerTypes() {
    $types = ViewExecutable::viewsHandlerTypes();
    foreach (array(
      'field',
      'filter',
      'argument',
      'sort',
      'header',
      'footer',
      'empty',
    ) as $type) {
      $this
        ->assertTrue(isset($types[$type]));

      // @todo The key on the display should be footers, headers and empties
      //   or something similar instead of the singular, but so long check for
      //   this special case.
      if (isset($types[$type]['type']) && $types[$type]['type'] == 'area') {
        $this
          ->assertEqual($types[$type]['plural'], $type);
      }
      else {
        $this
          ->assertEqual($types[$type]['plural'], $type . 's');
      }
    }
  }

  /**
   * Tests the validation of display handlers.
   */
  public function testValidate() {
    $view = views_get_view('test_executable_displays');
    $view
      ->setDisplay('page_1');
    $validate = $view
      ->validate();

    // Validating a view shouldn't change the active display.
    $this
      ->assertEqual('page_1', $view->current_display, "The display should be constant while validating");
    $count = 0;
    foreach ($view->displayHandlers as $id => $display) {
      $match = function ($value) use ($display) {
        return strpos($value, $display->display['display_title']) !== false;
      };
      $this
        ->assertTrue(array_filter($validate[$id], $match), format_string('Error message found for @id display', array(
        '@id' => $id,
      )));
      $count++;
    }
    $this
      ->assertEqual(count($view->displayHandlers), $count, 'Error messages from all handlers merged.');

    // Test that a deleted display is not included.
    $display =& $view->storage
      ->getDisplay('default');
    $display['deleted'] = TRUE;
    $validate_deleted = $view
      ->validate();
    $this
      ->assertNotIdentical($validate, $validate_deleted, 'Master display has not been validated.');
  }

}

Members

Namesort descending Modifiers Type Description Overrides
DrupalUnitTestBase::$keyValueFactory protected property A KeyValueMemoryFactory instance to use when building the container.
DrupalUnitTestBase::$moduleFiles private property
DrupalUnitTestBase::$themeData private property
DrupalUnitTestBase::$themeFiles private property
DrupalUnitTestBase::containerBuild public function Sets up the base service container for this test. 1
DrupalUnitTestBase::disableModules protected function Disables modules for this test.
DrupalUnitTestBase::enableModules protected function Enables modules for this test.
DrupalUnitTestBase::installConfig protected function Installs default configuration for a given list of modules.
DrupalUnitTestBase::installSchema protected function Installs a specific table from a module schema definition.
DrupalUnitTestBase::tearDown protected function Deletes created files, database tables, and reverts all environment changes. Overrides TestBase::tearDown 2
DrupalUnitTestBase::__construct function Overrides \Drupal\simpletest\UnitTestBase::__construct(). 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
ViewExecutableTest::$configProperties protected property Properties that should be stored in the configuration.
ViewExecutableTest::$executableProperties protected property Properties that should be stored in the executable.
ViewExecutableTest::$modules public static property Modules to enable. Overrides ViewUnitTestBase::$modules
ViewExecutableTest::$testViews public static property Views used by this test.
ViewExecutableTest::assertViewDestroy protected function Asserts that expected view properties have been unset by destroy().
ViewExecutableTest::getInfo public static function
ViewExecutableTest::getProtectedProperty protected function Returns a protected property from a class instance.
ViewExecutableTest::setUpFixtures protected function Sets up the configuration and schema of views and views_test_data modules. Overrides ViewUnitTestBase::setUpFixtures
ViewExecutableTest::testConstructing public function Tests the generation of the executable object.
ViewExecutableTest::testDestroy public function Tests the deconstructor to be sure that necessary objects are removed.
ViewExecutableTest::testDisplays public function Tests the display related methods and properties.
ViewExecutableTest::testFactoryService public function Tests the views.exectuable container service.
ViewExecutableTest::testInitMethods public function Tests the initDisplay() and initHandlers() methods.
ViewExecutableTest::testProperties public function Tests the accessing of values on the object.
ViewExecutableTest::testPropertyMethods public function Tests the setting/getting of properties.
ViewExecutableTest::testValidate public function Tests the validation of display handlers.
ViewExecutableTest::testViewsHandlerTypes public function Tests ViewExecutable::viewsHandlerTypes().
ViewUnitTestBase::assertIdenticalResultset protected function Verifies that a result set returned by a View matches expected values.
ViewUnitTestBase::assertIdenticalResultsetHelper protected function Performs View result assertions.
ViewUnitTestBase::assertNotIdenticalResultset protected function Verifies that a result set returned by a View differs from certain values.
ViewUnitTestBase::dataSet protected function Returns a very simple test dataset. 7
ViewUnitTestBase::executeView protected function Executes a view with debugging.
ViewUnitTestBase::orderResultSet protected function Orders a nested array containing a result set based on a given column.
ViewUnitTestBase::schemaDefinition protected function Returns the schema definition. 4
ViewUnitTestBase::setUp protected function Sets up Drupal unit test environment. Overrides DrupalUnitTestBase::setUp 20
ViewUnitTestBase::viewsData protected function Returns the views data definition. 19