You are here

Home » API reference » JSON:API 8 » ResourceResponseValidatorTest.php

class ResourceResponseValidatorTest in JSON:API 8

Same name and namespace in other branches
  1. 8.2 tests/src/Unit/EventSubscriber/ResourceResponseValidatorTest.php \Drupal\Tests\jsonapi\Unit\EventSubscriber\ResourceResponseValidatorTest

@coversDefaultClass \Drupal\jsonapi\EventSubscriber\ResourceResponseValidator @group jsonapi

@internal

Hierarchy

Expanded class hierarchy of ResourceResponseValidatorTest

File

tests/src/Unit/EventSubscriber/ResourceResponseValidatorTest.php, line 27

Namespace

Drupal\Tests\jsonapi\Unit\EventSubscriber
View source 
class ResourceResponseValidatorTest extends UnitTestCase {

  /**
   * The subscriber under test.
   *
   * @var \Drupal\jsonapi\EventSubscriber\ResourceResponseSubscriber
   */
  protected $subscriber;

  /**
   * {@inheritdoc}
   */
  public function setUp() {
    parent::setUp();

    // Check that the validation class is available.
    if (!class_exists("\\JsonSchema\\Validator")) {
      $this
        ->fail('The JSON Schema validator is missing. You can install it with `composer require justinrainbow/json-schema`.');
    }
    $module_handler = $this
      ->prophesize(ModuleHandlerInterface::class);
    $module = $this
      ->prophesize(Extension::class);
    $module_path = dirname(dirname(dirname(dirname(__DIR__))));
    $module
      ->getPath()
      ->willReturn($module_path);
    $module_handler
      ->getModule('jsonapi')
      ->willReturn($module
      ->reveal());
    $subscriber = new ResourceResponseValidator(new Serializer([], [
      new JsonSchemaEncoder(),
    ]), $this
      ->prophesize(LoggerInterface::class)
      ->reveal(), $module_handler
      ->reveal(), '');
    $subscriber
      ->setValidator();
    $this->subscriber = $subscriber;
  }

  /**
   * @covers ::doValidateResponse
   */
  public function testDoValidateResponse() {
    $request = $this
      ->createRequest('jsonapi.node--article.individual', new ResourceType('node', 'article', NULL));
    $response = $this
      ->createResponse('{"data":null}');

    // Capture the default assert settings.
    $zend_assertions_default = ini_get('zend.assertions');
    $assert_active_default = assert_options(ASSERT_ACTIVE);

    // The validator *should* be called when asserts are active.
    $validator = $this
      ->prophesize(Validator::class);
    $validator
      ->check(Argument::any(), Argument::any())
      ->shouldBeCalled('Validation should be run when asserts are active.');
    $validator
      ->isValid()
      ->willReturn(TRUE);
    $this->subscriber
      ->setValidator($validator
      ->reveal());

    // Ensure asset is active.
    ini_set('zend.assertions', 1);
    assert_options(ASSERT_ACTIVE, 1);
    $this->subscriber
      ->doValidateResponse($response, $request);

    // The validator should *not* be called when asserts are inactive.
    $validator = $this
      ->prophesize(Validator::class);
    $validator
      ->check(Argument::any(), Argument::any())
      ->shouldNotBeCalled('Validation should not be run when asserts are not active.');
    $this->subscriber
      ->setValidator($validator
      ->reveal());

    // Ensure asset is inactive.
    ini_set('zend.assertions', 0);
    assert_options(ASSERT_ACTIVE, 0);
    $this->subscriber
      ->doValidateResponse($response, $request);

    // Reset the original assert values.
    ini_set('zend.assertions', $zend_assertions_default);
    assert_options(ASSERT_ACTIVE, $assert_active_default);
  }

  /**
   * @covers ::onResponse
   */
  public function testValidateResponseSchemata() {
    $request = $this
      ->createRequest('jsonapi.node--article.individual', new ResourceType('node', 'article', NULL));
    $response = $this
      ->createResponse('{"data":null}');

    // The validator should be called *once* if schemata is *not* installed.
    $validator = $this
      ->prophesize(Validator::class);
    $validator
      ->check(Argument::any(), Argument::any())
      ->shouldBeCalledTimes(1);
    $validator
      ->isValid()
      ->willReturn(TRUE);
    $this->subscriber
      ->setValidator($validator
      ->reveal());

    // Run validations.
    $this->subscriber
      ->doValidateResponse($response, $request);

    // The validator should be called *twice* if schemata is installed.
    $validator = $this
      ->prophesize(Validator::class);
    $validator
      ->check(Argument::any(), Argument::any())
      ->shouldBeCalledTimes(2);
    $validator
      ->isValid()
      ->willReturn(TRUE);
    $this->subscriber
      ->setValidator($validator
      ->reveal());

    // Make the schemata factory available.
    $schema_factory = $this
      ->prophesize(SchemaFactory::class);
    $schema_factory
      ->create('node', 'article')
      ->willReturn('{}');
    $this->subscriber
      ->setSchemaFactory($schema_factory
      ->reveal());

    // Run validations.
    $this->subscriber
      ->doValidateResponse($response, $request);

    // The validator resource specific schema should *not* be validated on
    // 'related' routes.
    $request = $this
      ->createRequest('jsonapi.node--article.related', new ResourceType('node', 'article', NULL));

    // Since only the generic schema should be validated, the validator should
    // only be called once.
    $validator = $this
      ->prophesize(Validator::class);
    $validator
      ->check(Argument::any(), Argument::any())
      ->shouldBeCalledTimes(1);
    $validator
      ->isValid()
      ->willReturn(TRUE);
    $this->subscriber
      ->setValidator($validator
      ->reveal());

    // Run validations.
    $this->subscriber
      ->doValidateResponse($response, $request);

    // The validator resource specific schema should *not* be validated on
    // 'relationship' routes.
    $request = $this
      ->createRequest('jsonapi.node--article.relationship', new ResourceType('node', 'article', NULL));

    // Since only the generic schema should be validated, the validator should
    // only be called once.
    $validator = $this
      ->prophesize(Validator::class);
    $validator
      ->check(Argument::any(), Argument::any())
      ->shouldBeCalledTimes(1);
    $validator
      ->isValid()
      ->willReturn(TRUE);
    $this->subscriber
      ->setValidator($validator
      ->reveal());

    // Run validations.
    $this->subscriber
      ->doValidateResponse($response, $request);
  }

  /**
   * @covers ::validateResponse
   * @dataProvider validateResponseProvider
   */
  public function testValidateResponse($request, $response, $expected, $description) {

    // Expose protected ResourceResponseSubscriber::validateResponse() method.
    $object = new \ReflectionObject($this->subscriber);
    $method = $object
      ->getMethod('validateResponse');
    $method
      ->setAccessible(TRUE);
    $this
      ->assertSame($expected, $method
      ->invoke($this->subscriber, $response, $request), $description);
  }

  /**
   * Provides test cases for testValidateResponse.
   *
   * @return array
   *   An array of test cases.
   */
  public function validateResponseProvider() {
    $defaults = [
      'route_name' => 'jsonapi.node--article.individual',
      'resource_type' => new ResourceType('node', 'article', NULL),
    ];
    $test_data = [
      // Test validation success.
      [
        'json' => <<<'EOD'
{
  "data": {
    "type": "node--article",
    "id": "4f342419-e668-4b76-9f87-7ce20c436169",
    "attributes": {
      "nid": "1",
      "uuid": "4f342419-e668-4b76-9f87-7ce20c436169"
    }
  }
}
EOD
,
        'expected' => TRUE,
        'description' => 'Response validation flagged a valid response.',
      ],
      // Test validation failure: no "type" in "data".
      [
        'json' => <<<'EOD'
{
  "data": {
    "id": "4f342419-e668-4b76-9f87-7ce20c436169",
    "attributes": {
      "nid": "1",
      "uuid": "4f342419-e668-4b76-9f87-7ce20c436169"
    }
  }
}
EOD
,
        'expected' => FALSE,
        'description' => 'Response validation failed to flag an invalid response.',
      ],
      // Test validation failure: "errors" at the root level.
      [
        'json' => <<<'EOD'
{
  "data": {
  "type": "node--article",
    "id": "4f342419-e668-4b76-9f87-7ce20c436169",
    "attributes": {
    "nid": "1",
      "uuid": "4f342419-e668-4b76-9f87-7ce20c436169"
    }
  },
  "errors": [{}]
}
EOD
,
        'expected' => FALSE,
        'description' => 'Response validation failed to flag an invalid response.',
      ],
      // Test validation of an empty response passes.
      [
        'json' => NULL,
        'expected' => TRUE,
        'description' => 'Response validation flagged a valid empty response.',
      ],
      // Test validation fails on empty object.
      [
        'json' => '{}',
        'expected' => FALSE,
        'description' => 'Response validation flags empty array as invalid.',
      ],
    ];
    $test_cases = array_map(function ($input) use ($defaults) {
      list($json, $expected, $description, $route_name, $resource_type) = array_values($input + $defaults);
      return [
        $this
          ->createRequest($route_name, $resource_type),
        $this
          ->createResponse($json),
        $expected,
        $description,
      ];
    }, $test_data);
    return $test_cases;
  }

  /**
   * Helper method to create a request object.
   *
   * @param string $route_name
   *   The route name with which to construct a request.
   * @param \Drupal\jsonapi\ResourceType\ResourceType $resource_type
   *   The resource type for the requested route.
   *
   * @return \Symfony\Component\HttpFoundation\Request
   *   The mock request object.
   */
  protected function createRequest($route_name, ResourceType $resource_type) {
    $request = new Request();
    $request->attributes
      ->set(RouteObjectInterface::ROUTE_NAME, $route_name);
    $request->attributes
      ->set(Routes::RESOURCE_TYPE_KEY, $resource_type);
    return $request;
  }

  /**
   * Helper method to create a resource response from arbitrary JSON.
   *
   * @param string|null $json
   *   The JSON with which to create a mock response.
   *
   * @return \Drupal\rest\ResourceResponse
   *   The mock response object.
   */
  protected function createResponse($json = NULL) {
    $response = new ResourceResponse();
    if ($json) {
      $response
        ->setContent($json);
    }
    return $response;
  }

}

Members

Namesort descending Modifiers Type Description Overrides
PhpunitCompatibilityTrait::getMock Deprecated public function Returns a mock object for the specified class using the available method.
PhpunitCompatibilityTrait::setExpectedException Deprecated public function Compatibility layer for PHPUnit 6 to support PHPUnit 4 code.
ResourceResponseValidatorTest::$subscriber protected property The subscriber under test.
ResourceResponseValidatorTest::createRequest protected function Helper method to create a request object.
ResourceResponseValidatorTest::createResponse protected function Helper method to create a resource response from arbitrary JSON.
ResourceResponseValidatorTest::setUp public function Overrides UnitTestCase::setUp
ResourceResponseValidatorTest::testDoValidateResponse public function @covers ::doValidateResponse
ResourceResponseValidatorTest::testValidateResponse public function @covers ::validateResponse @dataProvider validateResponseProvider
ResourceResponseValidatorTest::testValidateResponseSchemata public function @covers ::onResponse
ResourceResponseValidatorTest::validateResponseProvider public function Provides test cases for testValidateResponse.
UnitTestCase::$randomGenerator protected property The random generator.
UnitTestCase::$root protected property The app root. 1
UnitTestCase::assertArrayEquals protected function Asserts if two arrays are equal by sorting them first.
UnitTestCase::getBlockMockWithMachineName Deprecated protected function Mocks a block with a block plugin. 1
UnitTestCase::getClassResolverStub protected function Returns a stub class resolver.
UnitTestCase::getConfigFactoryStub public function Returns a stub config factory that behaves according to the passed array.
UnitTestCase::getConfigStorageStub public function Returns a stub config storage that returns the supplied configuration.
UnitTestCase::getContainerWithCacheTagsInvalidator protected function Sets up a container with a cache tags invalidator.
UnitTestCase::getRandomGenerator protected function Gets the random generator for the utility methods.
UnitTestCase::getStringTranslationStub public function Returns a stub translation manager that just returns the passed string.
UnitTestCase::randomMachineName public function Generates a unique random string containing letters and numbers.