1. 8.5.x core/tests/Drupal/KernelTests/Core/Entity/EntityQueryRelationshipTest.php
  2. 8.0.x core/modules/system/src/Tests/Entity/EntityQueryRelationshipTest.php
  3. 8.1.x core/tests/Drupal/KernelTests/Core/Entity/EntityQueryRelationshipTest.php
  4. 8.2.x core/tests/Drupal/KernelTests/Core/Entity/EntityQueryRelationshipTest.php
  5. 8.3.x core/tests/Drupal/KernelTests/Core/Entity/EntityQueryRelationshipTest.php
  6. 8.4.x core/tests/Drupal/KernelTests/Core/Entity/EntityQueryRelationshipTest.php
  7. 8.6.x core/tests/Drupal/KernelTests/Core/Entity/EntityQueryRelationshipTest.php

Namespace

Drupal\KernelTests\Core\Entity

File

core/tests/Drupal/KernelTests/Core/Entity/EntityQueryRelationshipTest.php
View source
<?php

namespace Drupal\KernelTests\Core\Entity;

use Drupal\Component\Plugin\Exception\PluginNotFoundException;
use Drupal\Component\Utility\Unicode;
use Drupal\entity_test\Entity\EntityTest;
use Drupal\field\Tests\EntityReference\EntityReferenceTestTrait;
use Drupal\taxonomy\Entity\Vocabulary;
use Drupal\taxonomy\Entity\Term;

/**
 * Tests the Entity Query relationship API.
 *
 * @group Entity
 */
class EntityQueryRelationshipTest extends EntityKernelTestBase {
  use EntityReferenceTestTrait;

  /**
   * Modules to enable.
   *
   * @var array
   */
  public static $modules = array(
    'taxonomy',
  );

  /**
   * @var \Drupal\Core\Entity\Query\QueryFactory
   */
  protected $factory;

  /**
   * Term entities.
   *
   * @var array
   */
  protected $terms;

  /**
   * User entities.
   *
   * @var array
   */
  public $accounts;

  /**
   * entity_test entities.
   *
   * @var array
   */
  protected $entities;

  /**
   * The name of the taxonomy field used for test.
   *
   * @var string
   */
  protected $fieldName;

  /**
   * The results returned by EntityQuery.
   *
   * @var array
   */
  protected $queryResults;
  protected function setUp() {
    parent::setUp();
    $this
      ->installEntitySchema('taxonomy_term');

    // We want an entity reference field. It needs a vocabulary, terms, a field
    // storage and a field. First, create the vocabulary.
    $vocabulary = Vocabulary::create([
      'vid' => Unicode::strtolower($this
        ->randomMachineName()),
    ]);
    $vocabulary
      ->save();

    // Second, create the field.
    entity_test_create_bundle('test_bundle');
    $this->fieldName = strtolower($this
      ->randomMachineName());
    $handler_settings = array(
      'target_bundles' => array(
        $vocabulary
          ->id() => $vocabulary
          ->id(),
      ),
      'auto_create' => TRUE,
    );
    $this
      ->createEntityReferenceField('entity_test', 'test_bundle', $this->fieldName, NULL, 'taxonomy_term', 'default', $handler_settings);

    // Create two terms and also two accounts.
    for ($i = 0; $i <= 1; $i++) {
      $term = Term::create([
        'name' => $this
          ->randomMachineName(),
        'vid' => $vocabulary
          ->id(),
      ]);
      $term
        ->save();
      $this->terms[] = $term;
      $this->accounts[] = $this
        ->createUser();
    }

    // Create three entity_test entities, the 0th entity will point to the
    // 0th account and 0th term, the 1st and 2nd entity will point to the
    // 1st account and 1st term.
    for ($i = 0; $i <= 2; $i++) {
      $entity = EntityTest::create(array(
        'type' => 'test_bundle',
      ));
      $entity->name->value = $this
        ->randomMachineName();
      $index = $i ? 1 : 0;
      $entity->user_id->target_id = $this->accounts[$index]
        ->id();
      $entity->{$this->fieldName}->target_id = $this->terms[$index]
        ->id();
      $entity
        ->save();
      $this->entities[] = $entity;
    }
    $this->factory = \Drupal::service('entity.query');
  }

  /**
   * Tests querying.
   */
  public function testQuery() {

    // This returns the 0th entity as that's the only one pointing to the 0th
    // account.
    $this->queryResults = $this->factory
      ->get('entity_test')
      ->condition("user_id.entity.name", $this->accounts[0]
      ->getUsername())
      ->execute();
    $this
      ->assertResults(array(
      0,
    ));

    // This returns the 1st and 2nd entity as those point to the 1st account.
    $this->queryResults = $this->factory
      ->get('entity_test')
      ->condition("user_id.entity.name", $this->accounts[0]
      ->getUsername(), '<>')
      ->execute();
    $this
      ->assertResults(array(
      1,
      2,
    ));

    // This returns all three entities because all of them point to an
    // account.
    $this->queryResults = $this->factory
      ->get('entity_test')
      ->exists("user_id.entity.name")
      ->execute();
    $this
      ->assertResults(array(
      0,
      1,
      2,
    ));

    // This returns no entities because all of them point to an account.
    $this->queryResults = $this->factory
      ->get('entity_test')
      ->notExists("user_id.entity.name")
      ->execute();
    $this
      ->assertEqual(count($this->queryResults), 0);

    // This returns the 0th entity as that's only one pointing to the 0th
    // term (test without specifying the field column).
    $this->queryResults = $this->factory
      ->get('entity_test')
      ->condition("{$this-&gt;<span class="php-function-or-constant property member-of-self">fieldName</span>}.entity.name", $this->terms[0]->name->value)
      ->execute();
    $this
      ->assertResults(array(
      0,
    ));

    // This returns the 0th entity as that's only one pointing to the 0th
    // term (test with specifying the column name).
    $this->queryResults = $this->factory
      ->get('entity_test')
      ->condition("{$this-&gt;<span class="php-function-or-constant property member-of-self">fieldName</span>}.target_id.entity.name", $this->terms[0]->name->value)
      ->execute();
    $this
      ->assertResults(array(
      0,
    ));

    // This returns the 1st and 2nd entity as those point to the 1st term.
    $this->queryResults = $this->factory
      ->get('entity_test')
      ->condition("{$this-&gt;<span class="php-function-or-constant property member-of-self">fieldName</span>}.entity.name", $this->terms[0]->name->value, '<>')
      ->execute();
    $this
      ->assertResults(array(
      1,
      2,
    ));

    // This returns the 0th entity as that's only one pointing to the 0th
    // account.
    $this->queryResults = $this->factory
      ->get('entity_test')
      ->condition("user_id.entity:user.name", $this->accounts[0]
      ->getUsername())
      ->execute();
    $this
      ->assertResults(array(
      0,
    ));

    // This returns the 1st and 2nd entity as those point to the 1st account.
    $this->queryResults = $this->factory
      ->get('entity_test')
      ->condition("user_id.entity:user.name", $this->accounts[0]
      ->getUsername(), '<>')
      ->execute();
    $this
      ->assertResults(array(
      1,
      2,
    ));

    // This returns all three entities because all of them point to an
    // account.
    $this->queryResults = $this->factory
      ->get('entity_test')
      ->exists("user_id.entity:user.name")
      ->execute();
    $this
      ->assertResults(array(
      0,
      1,
      2,
    ));

    // This returns no entities because all of them point to an account.
    $this->queryResults = $this->factory
      ->get('entity_test')
      ->notExists("user_id.entity:user.name")
      ->execute();
    $this
      ->assertEqual(count($this->queryResults), 0);

    // This returns the 0th entity as that's only one pointing to the 0th
    // term (test without specifying the field column).
    $this->queryResults = $this->factory
      ->get('entity_test')
      ->condition("{$this-&gt;<span class="php-function-or-constant property member-of-self">fieldName</span>}.entity:taxonomy_term.name", $this->terms[0]->name->value)
      ->execute();
    $this
      ->assertResults(array(
      0,
    ));

    // This returns the 0th entity as that's only one pointing to the 0th
    // term (test with specifying the column name).
    $this->queryResults = $this->factory
      ->get('entity_test')
      ->condition("{$this-&gt;<span class="php-function-or-constant property member-of-self">fieldName</span>}.target_id.entity:taxonomy_term.name", $this->terms[0]->name->value)
      ->execute();
    $this
      ->assertResults(array(
      0,
    ));

    // This returns the 1st and 2nd entity as those point to the 1st term.
    $this->queryResults = $this->factory
      ->get('entity_test')
      ->condition("{$this-&gt;<span class="php-function-or-constant property member-of-self">fieldName</span>}.entity:taxonomy_term.name", $this->terms[0]->name->value, '<>')
      ->execute();
    $this
      ->assertResults(array(
      1,
      2,
    ));
  }

  /**
   * Tests the invalid specifier in the query relationship.
   */
  public function testInvalidSpecifier() {
    $this
      ->setExpectedException(PluginNotFoundException::class);
    $this->factory
      ->get('taxonomy_term')
      ->condition('langcode.language.foo', 'bar')
      ->execute();
  }

  /**
   * Assert the results.
   *
   * @param array $expected
   *   A list of indexes in the $this->entities array.
   */
  protected function assertResults($expected) {
    $this
      ->assertEqual(count($this->queryResults), count($expected));
    foreach ($expected as $key) {
      $id = $this->entities[$key]
        ->id();
      $this
        ->assertEqual($this->queryResults[$id], $id);
    }
  }

}

Classes

Namesort descending Description
EntityQueryRelationshipTest Tests the Entity Query relationship API.