Chris@18: <?php
Chris@18: 
Chris@18: namespace Drupal\jsonapi\Exception;
Chris@18: 
Chris@18: use Drupal\Core\Entity\EntityConstraintViolationListInterface;
Chris@18: use Drupal\Core\DependencyInjection\DependencySerializationTrait;
Chris@18: use Symfony\Component\HttpKernel\Exception\HttpException;
Chris@18: 
Chris@18: /**
Chris@18:  * A class to represent a 422 - Unprocessable Entity Exception.
Chris@18:  *
Chris@18:  * The HTTP 422 status code is used when the server sees:-
Chris@18:  *
Chris@18:  *  The content type of the request is correct.
Chris@18:  *  The syntax of the request is correct.
Chris@18:  *  BUT was unable to process the contained instruction.
Chris@18:  *
Chris@18:  * @internal JSON:API maintains no PHP API. The API is the HTTP API. This class
Chris@18:  *   may change at any time and could break any dependencies on it.
Chris@18:  *
Chris@18:  * @see https://www.drupal.org/project/jsonapi/issues/3032787
Chris@18:  * @see jsonapi.api.php
Chris@18:  */
Chris@18: class UnprocessableHttpEntityException extends HttpException {
Chris@18: 
Chris@18:   use DependencySerializationTrait;
Chris@18: 
Chris@18:   /**
Chris@18:    * The constraint violations associated with this exception.
Chris@18:    *
Chris@18:    * @var \Drupal\Core\Entity\EntityConstraintViolationListInterface
Chris@18:    */
Chris@18:   protected $violations;
Chris@18: 
Chris@18:   /**
Chris@18:    * UnprocessableHttpEntityException constructor.
Chris@18:    *
Chris@18:    * @param \Exception|null $previous
Chris@18:    *   The pervious error, if any, associated with the request.
Chris@18:    * @param array $headers
Chris@18:    *   The headers associated with the request.
Chris@18:    * @param int $code
Chris@18:    *   The HTTP status code associated with the request. Defaults to zero.
Chris@18:    */
Chris@18:   public function __construct(\Exception $previous = NULL, array $headers = [], $code = 0) {
Chris@18:     parent::__construct(422, "Unprocessable Entity: validation failed.", $previous, $headers, $code);
Chris@18:   }
Chris@18: 
Chris@18:   /**
Chris@18:    * Gets the constraint violations associated with this exception.
Chris@18:    *
Chris@18:    * @return \Drupal\Core\Entity\EntityConstraintViolationListInterface
Chris@18:    *   The constraint violations.
Chris@18:    */
Chris@18:   public function getViolations() {
Chris@18:     return $this->violations;
Chris@18:   }
Chris@18: 
Chris@18:   /**
Chris@18:    * Sets the constraint violations associated with this exception.
Chris@18:    *
Chris@18:    * @param \Drupal\Core\Entity\EntityConstraintViolationListInterface $violations
Chris@18:    *   The constraint violations.
Chris@18:    */
Chris@18:   public function setViolations(EntityConstraintViolationListInterface $violations) {
Chris@18:     $this->violations = $violations;
Chris@18:   }
Chris@18: 
Chris@18: }