ReadTest.php

Definition of Drupal\rest\test\ReadTest.

Namespace

Drupal\rest\Tests

File

drupal/core/modules/rest/lib/Drupal/rest/Tests/ReadTest.php
View source
<?php

/**
 * @file
 * Definition of Drupal\rest\test\ReadTest.
 */
namespace Drupal\rest\Tests;

use Drupal\Core\Language\Language;
use Drupal\rest\Tests\RESTTestBase;

/**
 * Tests resource read operations on test entities, nodes and users.
 */
class ReadTest extends RESTTestBase {

  /**
   * Modules to enable.
   *
   * @var array
   */
  public static $modules = array(
    'hal',
    'rest',
    'entity_test',
  );
  public static function getInfo() {
    return array(
      'name' => 'Read resource',
      'description' => 'Tests the retrieval of resources.',
      'group' => 'REST',
    );
  }

  /**
   * Tests several valid and invalid read requests on all entity types.
   */
  public function testRead() {

    // @todo once EntityNG is implemented for other entity types expand this at
    // least to nodes and users.
    // Define the entity types we want to test.
    $entity_types = array(
      'entity_test',
    );
    foreach ($entity_types as $entity_type) {
      $this
        ->enableService('entity:' . $entity_type, 'GET');

      // Create a user account that has the required permissions to read
      // resources via the REST API.
      $permissions = $this
        ->entityPermissions($entity_type, 'view');
      $permissions[] = 'restful get entity:' . $entity_type;
      $account = $this
        ->drupalCreateUser($permissions);
      $this
        ->drupalLogin($account);

      // Create an entity programmatically.
      $entity = $this
        ->entityCreate($entity_type);
      $entity
        ->save();

      // Read it over the REST API.
      $response = $this
        ->httpRequest('entity/' . $entity_type . '/' . $entity
        ->id(), 'GET', NULL, $this->defaultMimeType);
      $this
        ->assertResponse('200', 'HTTP response code is correct.');
      $this
        ->assertHeader('content-type', $this->defaultMimeType);
      $data = drupal_json_decode($response);

      // Only assert one example property here, other properties should be
      // checked in serialization tests.
      $this
        ->assertEqual($data['uuid'][0]['value'], $entity
        ->uuid(), 'Entity UUID is correct');

      // Try to read the entity with an unsupported mime format.
      $response = $this
        ->httpRequest('entity/' . $entity_type . '/' . $entity
        ->id(), 'GET', NULL, 'application/wrongformat');
      $this
        ->assertResponse(406);

      // Try to read an entity that does not exist.
      $response = $this
        ->httpRequest('entity/' . $entity_type . '/9999', 'GET', NULL, $this->defaultMimeType);
      $this
        ->assertResponse(404);
      $decoded = drupal_json_decode($response);
      $this
        ->assertEqual($decoded['error'], 'Entity with ID 9999 not found', 'Response message is correct.');

      // Make sure that field level access works and that the according field is
      // not available in the response.
      // @see entity_test_entity_field_access()
      $entity->field_test_text->value = 'no access value';
      $entity
        ->save();
      $response = $this
        ->httpRequest('entity/' . $entity_type . '/' . $entity
        ->id(), 'GET', NULL, $this->defaultMimeType);
      $this
        ->assertResponse(200);
      $this
        ->assertHeader('content-type', $this->defaultMimeType);
      $data = drupal_json_decode($response);
      $this
        ->assertFalse(isset($data['field_test_text']), 'Field access protexted field is not visible in the response.');

      // Try to read an entity without proper permissions.
      $this
        ->drupalLogout();
      $response = $this
        ->httpRequest('entity/' . $entity_type . '/' . $entity
        ->id(), 'GET', NULL, $this->defaultMimeType);
      $this
        ->assertResponse(403);
      $this
        ->assertNull(drupal_json_decode($response), 'No valid JSON found.');
    }

    // Try to read a resource which is not REST API enabled.
    $account = $this
      ->drupalCreateUser();
    $this
      ->drupalLogin($account);
    $response = $this
      ->httpRequest('entity/user/' . $account
      ->id(), 'GET', NULL, $this->defaultMimeType);
    $this
      ->assertResponse(404);
    $this
      ->assertNull(drupal_json_decode($response), 'No valid JSON found.');
  }

}

Classes

Namesort descending Description
ReadTest Tests resource read operations on test entities, nodes and users.