class Relationship in JSON:API 8

Represents a relationship between resources.

Use this class to create a relationship in your normalizer without having an entity reference field: allows for "virtual" relationships that are not backed by a stored entity reference.

@internal

Hierarchy

• class \Drupal\jsonapi\Normalizer\Relationship implements AccessibleInterface, CacheableDependencyInterface uses CacheableDependencyTrait

1 string reference to 'Relationship'

EntityResourceTest::setUp in tests/src/Kernel/Controller/EntityResourceTest.php

File

src/Normalizer/Relationship.php, line 23

Namespace

Drupal\jsonapi\Normalizer

class Relationship implements AccessibleInterface, CacheableDependencyInterface {
  use CacheableDependencyTrait;

  /**
   * Cardinality.
   *
   * @var int
   */
  protected $cardinality;

  /**
   * The entity that holds the relationship.
   *
   * @var \Drupal\Core\Entity\EntityInterface
   */
  protected $hostEntity;

  /**
   * The field name.
   *
   * @var string
   */
  protected $propertyName;

  /**
   * The JSON API resource type repository.
   *
   * @var \Drupal\jsonapi\ResourceType\ResourceTypeRepositoryInterface
   */
  protected $resourceTypeRepository;

  /**
   * The relationship items.
   *
   * @var \Drupal\jsonapi\Normalizer\RelationshipItem[]
   */
  protected $items;

  /**
   * Relationship constructor.
   *
   * @param \Drupal\jsonapi\ResourceType\ResourceTypeRepositoryInterface $resource_type_repository
   *   The JSON API resource type repository.
   * @param string $field_name
   *   The name of the relationship.
   * @param \Drupal\jsonapi\Resource\EntityCollection $entities
   *   A collection of entities.
   * @param \Drupal\Core\Entity\EntityInterface $host_entity
   *   The host entity.
   * @param \Drupal\Core\Access\AccessResultInterface $view_access
   *   The 'view' field access result. (This value object is only ever used for
   *   normalization, and hence only for 'view' access.
   * @param int $cardinality
   *   The relationship cardinality.
   * @param string $target_key
   *   The property name of the relationship id.
   * @param array $entity_list_metadata
   *   An array of additional properties stored by the field and that will be
   *   added to the meta in the relationship.
   */
  public function __construct(ResourceTypeRepositoryInterface $resource_type_repository, $field_name, EntityCollection $entities, EntityInterface $host_entity, AccessResultInterface $view_access, $cardinality = FieldStorageDefinitionInterface::CARDINALITY_UNLIMITED, $target_key = 'target_id', array $entity_list_metadata = []) {
    $this->resourceTypeRepository = $resource_type_repository;
    $this->propertyName = $field_name;
    $this->cardinality = $cardinality;
    $this->hostEntity = $host_entity;
    $this
      ->setCacheability($view_access);
    $this->items = [];
    foreach ($entities as $key => $entity) {
      $this->items[] = new RelationshipItem($resource_type_repository, $entity, $this, $target_key, $entity_list_metadata[$key]);
    }
  }

  /**
   * Gets the cardinality.
   *
   * @return mixed
   *   The cardinality of this relationship field.
   */
  public function getCardinality() {
    return $this->cardinality;
  }

  /**
   * Gets the host entity.
   *
   * @return \Drupal\Core\Entity\EntityInterface
   *   The entity which contains this relationship.
   */
  public function getHostEntity() {
    return $this->hostEntity;
  }

  /**
   * Sets the host entity.
   *
   * @param \Drupal\Core\Entity\EntityInterface $hostEntity
   *   The host entity.
   */
  public function setHostEntity(EntityInterface $hostEntity) {
    $this->hostEntity = $hostEntity;
  }

  /**
   * {@inheritdoc}
   */
  public function access($operation, AccountInterface $account = NULL, $return_as_object = FALSE) {

    // Hard coded to TRUE. Revisit this if we need more control over this.
    return TRUE;
  }

  /**
   * Gets the field name.
   *
   * @return string
   *   The name of the relationship property.
   */
  public function getPropertyName() {
    return $this->propertyName;
  }

  /**
   * Gets the items.
   *
   * @return \Drupal\jsonapi\Normalizer\RelationshipItem[]
   *   The relationship items.
   */
  public function getItems() {
    return $this->items;
  }

}

Members

Name	Modifiers	Type	Description	Overrides
CacheableDependencyTrait::$cacheContexts	protected	property	Cache contexts.
CacheableDependencyTrait::$cacheMaxAge	protected	property	Cache max-age.
CacheableDependencyTrait::$cacheTags	protected	property	Cache tags.
CacheableDependencyTrait::getCacheContexts	public	function
CacheableDependencyTrait::getCacheMaxAge	public	function
CacheableDependencyTrait::getCacheTags	public	function
CacheableDependencyTrait::setCacheability	protected	function	Sets cacheability; useful for value object constructors.
Relationship::$cardinality	protected	property	Cardinality.
Relationship::$hostEntity	protected	property	The entity that holds the relationship.
Relationship::$items	protected	property	The relationship items.
Relationship::$propertyName	protected	property	The field name.
Relationship::$resourceTypeRepository	protected	property	The JSON API resource type repository.
Relationship::access	public	function	Checks data value access. Overrides AccessibleInterface::access
Relationship::getCardinality	public	function	Gets the cardinality.
Relationship::getHostEntity	public	function	Gets the host entity.
Relationship::getItems	public	function	Gets the items.
Relationship::getPropertyName	public	function	Gets the field name.
Relationship::setHostEntity	public	function	Sets the host entity.
Relationship::__construct	public	function	Relationship constructor.