Chris@18: <?php
Chris@18: 
Chris@18: namespace Drupal\jsonapi;
Chris@18: 
Chris@18: use Drupal\Core\Cache\CacheableResponseInterface;
Chris@18: use Drupal\Core\Cache\CacheableResponseTrait;
Chris@18: use Symfony\Component\HttpFoundation\Response;
Chris@18: 
Chris@18: /**
Chris@18:  * Contains data for serialization before sending the response.
Chris@18:  *
Chris@18:  * We do not want to abuse the $content property on the Response class to store
Chris@18:  * our response data. $content implies that the provided data must either be a
Chris@18:  * string or an object with a __toString() method, which is not a requirement
Chris@18:  * for data used here.
Chris@18:  *
Chris@18:  * @internal JSON:API maintains no PHP API since its API is the HTTP API. This
Chris@18:  *   class may change at any time and this will 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:  * @see \Drupal\rest\ModifiedResourceResponse
Chris@18:  */
Chris@18: class ResourceResponse extends Response implements CacheableResponseInterface {
Chris@18: 
Chris@18:   use CacheableResponseTrait;
Chris@18: 
Chris@18:   /**
Chris@18:    * Response data that should be serialized.
Chris@18:    *
Chris@18:    * @var mixed
Chris@18:    */
Chris@18:   protected $responseData;
Chris@18: 
Chris@18:   /**
Chris@18:    * Constructor for ResourceResponse objects.
Chris@18:    *
Chris@18:    * @param mixed $data
Chris@18:    *   Response data that should be serialized.
Chris@18:    * @param int $status
Chris@18:    *   The response status code.
Chris@18:    * @param array $headers
Chris@18:    *   An array of response headers.
Chris@18:    */
Chris@18:   public function __construct($data = NULL, $status = 200, array $headers = []) {
Chris@18:     $this->responseData = $data;
Chris@18:     parent::__construct('', $status, $headers);
Chris@18:   }
Chris@18: 
Chris@18:   /**
Chris@18:    * Returns response data that should be serialized.
Chris@18:    *
Chris@18:    * @return mixed
Chris@18:    *   Response data that should be serialized.
Chris@18:    */
Chris@18:   public function getResponseData() {
Chris@18:     return $this->responseData;
Chris@18:   }
Chris@18: 
Chris@18: }