function Relationship::buildLinkCollectionFromEntityReferenceField

Same name in other branches
  1. 9 core/modules/jsonapi/src/JsonApiResource/Relationship.php \Drupal\jsonapi\JsonApiResource\Relationship::buildLinkCollectionFromEntityReferenceField()
  2. 10 core/modules/jsonapi/src/JsonApiResource/Relationship.php \Drupal\jsonapi\JsonApiResource\Relationship::buildLinkCollectionFromEntityReferenceField()
  3. 11.x core/modules/jsonapi/src/JsonApiResource/Relationship.php \Drupal\jsonapi\JsonApiResource\Relationship::buildLinkCollectionFromEntityReferenceField()

Builds a LinkCollection for the given entity reference field.

Parameters

\Drupal\jsonapi\JsonApiResource\ResourceObject $context: The context resource object of the relationship object.

\Drupal\Core\Field\EntityReferenceFieldItemListInterface $field: The entity reference field from which to create the links.

\Drupal\jsonapi\JsonApiResource\LinkCollection $links: Any extra links for the Relationship, if a `self` link is not provided, one will be automatically added if the context resource is locatable and is not internal.

Return value

\Drupal\jsonapi\JsonApiResource\LinkCollection The built links.

1 call to Relationship::buildLinkCollectionFromEntityReferenceField()
Relationship::createFromEntityReferenceField in core/modules/jsonapi/src/JsonApiResource/Relationship.php
Creates a new Relationship from an entity reference field.

File

core/modules/jsonapi/src/JsonApiResource/Relationship.php, line 228

Class

Relationship
Represents references from one resource object to other resource object(s).

Namespace

Drupal\jsonapi\JsonApiResource

Code

protected static function buildLinkCollectionFromEntityReferenceField(ResourceObject $context, EntityReferenceFieldItemListInterface $field, LinkCollection $links) {
    $context_resource_type = $context->getResourceType();
    $public_field_name = $context_resource_type->getPublicName($field->getName());
    if ($context_resource_type->isLocatable() && !$context_resource_type->isInternal()) {
        $context_is_versionable = $context_resource_type->isVersionable();
        if (!$links->hasLinkWithKey('self')) {
            $route_name = Routes::getRouteName($context_resource_type, "{$public_field_name}.relationship.get");
            $self_link = Url::fromRoute($route_name, [
                'entity' => $context->getId(),
            ]);
            if ($context_is_versionable) {
                $self_link->setOption('query', [
                    JsonApiSpec::VERSION_QUERY_PARAMETER => $context->getVersionIdentifier(),
                ]);
            }
            $links = $links->withLink('self', new Link(new CacheableMetadata(), $self_link, 'self'));
        }
        $has_non_internal_resource_type = array_reduce($context_resource_type->getRelatableResourceTypesByField($public_field_name), function ($carry, ResourceType $target) {
            return $carry ?: !$target->isInternal();
        }, FALSE);
        // If a `related` link was not provided, automatically generate one from
        // the relationship object to the collection resource with all of the
        // resources targeted by this relationship. However, that link should
        // *not* be generated if all of the relatable resources are internal.
        // That's because, in that case, a route will not exist for it.
        if (!$links->hasLinkWithKey('related') && $has_non_internal_resource_type) {
            $route_name = Routes::getRouteName($context_resource_type, "{$public_field_name}.related");
            $related_link = Url::fromRoute($route_name, [
                'entity' => $context->getId(),
            ]);
            if ($context_is_versionable) {
                $related_link->setOption('query', [
                    JsonApiSpec::VERSION_QUERY_PARAMETER => $context->getVersionIdentifier(),
                ]);
            }
            $links = $links->withLink('related', new Link(new CacheableMetadata(), $related_link, 'related'));
        }
    }
    return $links;
}

Buggy or inaccurate documentation? Please file an issue. Need support? Need help programming? Connect with the Drupal community.