function Relationship::buildLinkCollectionFromEntityReferenceField
Same name in other branches
- 8.9.x core/modules/jsonapi/src/JsonApiResource/Relationship.php \Drupal\jsonapi\JsonApiResource\Relationship::buildLinkCollectionFromEntityReferenceField()
- 10 core/modules/jsonapi/src/JsonApiResource/Relationship.php \Drupal\jsonapi\JsonApiResource\Relationship::buildLinkCollectionFromEntityReferenceField()
- 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\JsonApiResourceCode
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.