class RelationshipTest

Same name and namespace in other branches
  1. 9 core/modules/views/tests/src/Kernel/Plugin/RelationshipTest.php \Drupal\Tests\views\Kernel\Plugin\RelationshipTest
  2. 8.9.x core/modules/views/tests/src/Kernel/Plugin/RelationshipTest.php \Drupal\Tests\views\Kernel\Plugin\RelationshipTest
  3. 11.x core/modules/views/tests/src/Kernel/Plugin/RelationshipTest.php \Drupal\Tests\views\Kernel\Plugin\RelationshipTest

Tests the base relationship handler.

@group views

Hierarchy

Expanded class hierarchy of RelationshipTest

See also

\Drupal\views\Plugin\views\relationship\RelationshipPluginBase

File

core/modules/views/tests/src/Kernel/Plugin/RelationshipTest.php, line 17

Namespace

Drupal\Tests\views\Kernel\Plugin
View source
class RelationshipTest extends RelationshipJoinTestBase {
  use UserCreationTrait;
  
  /**
   * Views used by this test.
   *
   * @var array
   */
  public static $testViews = [
    'test_view',
  ];
  
  /**
   * Maps between the key in the expected result and the query result.
   *
   * @var array
   */
  protected $columnMap = [
    'views_test_data_name' => 'name',
    'users_field_data_views_test_data_uid' => 'uid',
  ];
  
  /**
   * Tests the query result of a view with a relationship.
   */
  public function testRelationshipQuery() : void {
    $connection = Database::getConnection();
    // Set the first entry to have the admin as author.
    $connection->update('views_test_data')
      ->fields([
      'uid' => 1,
    ])
      ->condition('id', 1)
      ->execute();
    $connection->update('views_test_data')
      ->fields([
      'uid' => 2,
    ])
      ->condition('id', 1, '<>')
      ->execute();
    $view = Views::getView('test_view');
    $view->setDisplay();
    $view->displayHandlers
      ->get('default')
      ->overrideOption('relationships', [
      'uid' => [
        'id' => 'uid',
        'table' => 'views_test_data',
        'field' => 'uid',
      ],
    ]);
    $view->displayHandlers
      ->get('default')
      ->overrideOption('filters', [
      'uid' => [
        'id' => 'uid',
        'table' => 'users_field_data',
        'field' => 'uid',
        'relationship' => 'uid',
      ],
    ]);
    $fields = $view->displayHandlers
      ->get('default')
      ->getOption('fields');
    $view->displayHandlers
      ->get('default')
      ->overrideOption('fields', $fields + [
      'uid' => [
        'id' => 'uid',
        'table' => 'users_field_data',
        'field' => 'uid',
        'relationship' => 'uid',
      ],
    ]);
    $view->initHandlers();
    // Check for all beatles created by admin.
    $view->filter['uid']->value = [
      1,
    ];
    $this->executeView($view);
    $expected_result = [
      [
        'name' => 'John',
        'uid' => 1,
      ],
    ];
    $this->assertIdenticalResultset($view, $expected_result, $this->columnMap);
    $view->destroy();
    // Check for all beatles created by another user, which so doesn't exist.
    $view->initHandlers();
    $view->filter['uid']->value = [
      3,
    ];
    $this->executeView($view);
    $expected_result = [];
    $this->assertIdenticalResultset($view, $expected_result, $this->columnMap);
    $view->destroy();
    // Set the relationship to required, so only results authored by the admin
    // should return.
    $view->initHandlers();
    $view->relationship['uid']->options['required'] = TRUE;
    $this->executeView($view);
    $expected_result = [
      [
        'name' => 'John',
        'uid' => 1,
      ],
    ];
    $this->assertIdenticalResultset($view, $expected_result, $this->columnMap);
    $view->destroy();
    // Set the relationship to optional should cause to return all beatles.
    $view->initHandlers();
    $view->relationship['uid']->options['required'] = FALSE;
    $this->executeView($view);
    $expected_result = $this->dataSet();
    // Alter the expected result to contain the right uids.
    foreach ($expected_result as &$row) {
      // Only John has an existing author.
      if ($row['name'] == 'John') {
        $row['uid'] = 1;
      }
      else {
        // The LEFT join should set an empty {users}.uid field.
        $row['uid'] = NULL;
      }
    }
    $this->assertIdenticalResultset($view, $expected_result, $this->columnMap);
  }
  
  /**
   * Tests rendering of a view with a relationship.
   */
  public function testRelationshipRender() : void {
    $connection = Database::getConnection();
    $author1 = $this->createUser();
    $connection->update('views_test_data')
      ->fields([
      'uid' => $author1->id(),
    ])
      ->condition('id', 1)
      ->execute();
    $author2 = $this->createUser();
    $connection->update('views_test_data')
      ->fields([
      'uid' => $author2->id(),
    ])
      ->condition('id', 2)
      ->execute();
    // Set uid to non-existing author uid for row 3.
    $connection->update('views_test_data')
      ->fields([
      'uid' => $author2->id() + 123,
    ])
      ->condition('id', 3)
      ->execute();
    $view = Views::getView('test_view');
    // Add a relationship for authors.
    $view->getDisplay()
      ->overrideOption('relationships', [
      'uid' => [
        'id' => 'uid',
        'table' => 'views_test_data',
        'field' => 'uid',
      ],
    ]);
    // Add fields for {views_test_data}.id and author name.
    $view->getDisplay()
      ->overrideOption('fields', [
      'id' => [
        'id' => 'id',
        'table' => 'views_test_data',
        'field' => 'id',
      ],
      'author' => [
        'id' => 'author',
        'table' => 'users_field_data',
        'field' => 'name',
        'relationship' => 'uid',
      ],
    ]);
    // Render the view.
    $output = $view->preview();
    $html = $this->container
      ->get('renderer')
      ->renderRoot($output);
    $this->setRawContent($html);
    // Check that the output contains correct values.
    $xpath = '//div[@class="views-row" and div[@class="views-field views-field-id"]=:id and div[@class="views-field views-field-author"]=:author]';
    $this->assertCount(1, $this->xpath($xpath, [
      ':id' => 1,
      ':author' => $author1->getAccountName(),
    ]));
    $this->assertCount(1, $this->xpath($xpath, [
      ':id' => 2,
      ':author' => $author2->getAccountName(),
    ]));
    $this->assertCount(1, $this->xpath($xpath, [
      ':id' => 3,
      ':author' => '',
    ]));
  }

}

Members

Title Sort descending Modifiers Object type Summary Overrides
RelationshipJoinTestBase::$modules protected static property
RelationshipJoinTestBase::$rootUser protected property
RelationshipJoinTestBase::schemaDefinition protected function Overrides \Drupal\views\Tests\ViewTestBase::schemaDefinition().
RelationshipJoinTestBase::setUpFixtures protected function
RelationshipJoinTestBase::viewsData protected function Overrides \Drupal\views\Tests\ViewTestBase::viewsData(). 1
RelationshipTest::$columnMap protected property Maps between the key in the expected result and the query result.
RelationshipTest::$testViews public static property Views used by this test.
RelationshipTest::testRelationshipQuery public function Tests the query result of a view with a relationship.
RelationshipTest::testRelationshipRender public function Tests rendering of a view with a relationship.
UserCreationTrait::checkPermissions protected function Checks whether a given list of permission names is valid.
UserCreationTrait::createAdminRole protected function Creates an administrative role.
UserCreationTrait::createRole protected function Creates a role with specified permissions.
UserCreationTrait::createUser protected function Create a user with a given set of permissions.
UserCreationTrait::grantPermissions protected function Grant permissions to a user role.
UserCreationTrait::setCurrentUser protected function Switch the current logged in user.
UserCreationTrait::setUpCurrentUser protected function Creates a random user account and sets it as current user.

Buggy or inaccurate documentation? Please file an issue. Need support? Need help programming? Connect with the Drupal community.