You are here

class DefaultExceptionSubscriber in JSON:API 8

Same name and namespace in other branches
  1. 8.2 src/EventSubscriber/DefaultExceptionSubscriber.php \Drupal\jsonapi\EventSubscriber\DefaultExceptionSubscriber

Serializes exceptions in compliance with the JSON API specification.

@internal

Hierarchy

Expanded class hierarchy of DefaultExceptionSubscriber

1 string reference to 'DefaultExceptionSubscriber'
jsonapi.services.yml in ./jsonapi.services.yml
jsonapi.services.yml
1 service uses DefaultExceptionSubscriber
jsonapi.exception_subscriber in ./jsonapi.services.yml
Drupal\jsonapi\EventSubscriber\DefaultExceptionSubscriber

File

src/EventSubscriber/DefaultExceptionSubscriber.php, line 16

Namespace

Drupal\jsonapi\EventSubscriber
View source
class DefaultExceptionSubscriber extends SerializationDefaultExceptionSubscriber {

  /**
   * {@inheritdoc}
   */
  protected static function getPriority() {
    return parent::getPriority() + 25;
  }

  /**
   * {@inheritdoc}
   */
  protected function getHandledFormats() {
    return [
      'api_json',
    ];
  }

  /**
   * {@inheritdoc}
   */
  public function onException(GetResponseForExceptionEvent $event) {
    if (!$this
      ->isJsonApiExceptionEvent($event)) {
      return;
    }
    if (($exception = $event
      ->getException()) && !$exception instanceof HttpException) {
      $exception = new HttpException(500, $exception
        ->getMessage(), $exception);
      $event
        ->setException($exception);
    }
    $this
      ->setEventResponse($event, $exception
      ->getStatusCode());
  }

  /**
   * {@inheritdoc}
   */
  protected function setEventResponse(GetResponseForExceptionEvent $event, $status) {

    /* @var \Symfony\Component\HttpKernel\Exception\HttpException $exception */
    $exception = $event
      ->getException();
    $encoded_content = $this->serializer
      ->serialize($exception, 'api_json', [
      'data_wrapper' => 'errors',
    ]);
    $response = new Response($encoded_content, $status);
    $response->headers
      ->set('Content-Type', 'application/vnd.api+json');
    $event
      ->setResponse($response);
  }

  /**
   * Check if the error should be formatted using JSON API.
   *
   * The JSON API format is supported if the format is explicitly set or the
   * request is for a known JSON API route.
   *
   * @param \Symfony\Component\HttpKernel\Event\GetResponseForExceptionEvent $exception_event
   *   The exception event.
   *
   * @return bool
   *   TRUE if it needs to be formatted using JSON API. FALSE otherwise.
   */
  protected function isJsonApiExceptionEvent(GetResponseForExceptionEvent $exception_event) {
    $request = $exception_event
      ->getRequest();
    $parameters = $request->attributes
      ->all();
    return $request
      ->getRequestFormat() === 'api_json' || (bool) Routes::getResourceTypeNameFromParameters($parameters);
  }

}

Members

Namesort descending Modifiers Type Description Overrides
DefaultExceptionSubscriber::$serializer protected property The serializer.
DefaultExceptionSubscriber::$serializerFormats protected property The available serialization formats.
DefaultExceptionSubscriber::getHandledFormats protected function Specifies the request formats this subscriber will respond to. Overrides DefaultExceptionSubscriber::getHandledFormats
DefaultExceptionSubscriber::getPriority protected static function Specifies the priority of all listeners in this class. Overrides DefaultExceptionSubscriber::getPriority
DefaultExceptionSubscriber::isJsonApiExceptionEvent protected function Check if the error should be formatted using JSON API.
DefaultExceptionSubscriber::on4xx public function Handles all 4xx errors for all serialization failures.
DefaultExceptionSubscriber::onException public function Handles errors for this subscriber. Overrides HttpExceptionSubscriberBase::onException
DefaultExceptionSubscriber::setEventResponse protected function
DefaultExceptionSubscriber::__construct public function DefaultExceptionSubscriber constructor.
HttpExceptionSubscriberBase::getSubscribedEvents public static function Registers the methods in this class that should be listeners.