vendor/api-platform/core/src/Metadata/Link.php line 17

  1. <?php
  3. /*
  4.  * This file is part of the API Platform project.
  5.  *
  6.  * (c) Kévin Dunglas <dunglas@gmail.com>
  7.  *
  8.  * For the full copyright and license information, please view the LICENSE
  9.  * file that was distributed with this source code.
  10.  */
  12. declare(strict_types=1);
  14. namespace ApiPlatform\Metadata;
  16. #[\Attribute(\Attribute::TARGET_PROPERTY | \Attribute::TARGET_METHOD | \Attribute::TARGET_PARAMETER)]
  17. final class Link
  18. {
  19.     public function __construct(private ?string $parameterName = null, private ?string $fromProperty = null, private ?string $toProperty = null, private ?string $fromClass = null, private ?string $toClass = null, private ?array $identifiers = null, private ?bool $compositeIdentifier = null, private ?string $expandedValue = null)
  20.     {
  21.         // For the inverse property shortcut
  22.         if ($this->parameterName && class_exists($this->parameterName)) {
  23.             $this->fromClass = $this->parameterName;
  24.         }
  25.     }
  27.     public function getParameterName(): ?string
  28.     {
  29.         return $this->parameterName;
  30.     }
  32.     public function withParameterName(string $parameterName): self
  33.     {
  34.         $self = clone $this;
  35.         $self->parameterName = $parameterName;
  37.         return $self;
  38.     }
  40.     public function getFromClass(): ?string
  41.     {
  42.         return $this->fromClass;
  43.     }
  45.     public function withFromClass(string $fromClass): self
  46.     {
  47.         $self = clone $this;
  48.         $self->fromClass = $fromClass;
  50.         return $self;
  51.     }
  53.     public function getToClass(): ?string
  54.     {
  55.         return $this->toClass;
  56.     }
  58.     public function withToClass(string $toClass): self
  59.     {
  60.         $self = clone $this;
  61.         $self->toClass = $toClass;
  63.         return $self;
  64.     }
  66.     public function getFromProperty(): ?string
  67.     {
  68.         return $this->fromProperty;
  69.     }
  71.     public function withFromProperty(string $fromProperty): self
  72.     {
  73.         $self = $this;
  74.         $self->fromProperty = $fromProperty;
  76.         return $self;
  77.     }
  79.     public function getToProperty(): ?string
  80.     {
  81.         return $this->toProperty;
  82.     }
  84.     public function withToProperty(string $toProperty): self
  85.     {
  86.         $self = clone $this;
  87.         $self->toProperty = $toProperty;
  89.         return $self;
  90.     }
  92.     public function getIdentifiers(): ?array
  93.     {
  94.         return $this->identifiers;
  95.     }
  97.     public function withIdentifiers(array $identifiers): self
  98.     {
  99.         $self = clone $this;
  100.         $self->identifiers = $identifiers;
  102.         return $self;
  103.     }
  105.     public function getCompositeIdentifier(): ?bool
  106.     {
  107.         return $this->compositeIdentifier;
  108.     }
  110.     public function withCompositeIdentifier(bool $compositeIdentifier): self
  111.     {
  112.         $self = clone $this;
  113.         $self->compositeIdentifier = $compositeIdentifier;
  115.         return $self;
  116.     }
  118.     public function getExpandedValue(): ?string
  119.     {
  120.         return $this->expandedValue;
  121.     }
  123.     public function withExpandedValue(string $expandedValue): self
  124.     {
  125.         $self = clone $this;
  126.         $self->expandedValue = $expandedValue;
  128.         return $self;
  129.     }
  131.     public function withLink(self $link): self
  132.     {
  133.         $self = clone $this;
  135.         if (!$self->getToProperty() && ($toProperty = $link->getToProperty())) {
  136.             $self->toProperty = $toProperty;
  137.         }
  139.         if (!$self->getCompositeIdentifier() && ($compositeIdentifier = $link->getCompositeIdentifier())) {
  140.             $self->compositeIdentifier = $compositeIdentifier;
  141.         }
  143.         if (!$self->getFromClass() && ($fromClass = $link->getFromClass())) {
  144.             $self->fromClass = $fromClass;
  145.         }
  147.         if (!$self->getToClass() && ($toClass = $link->getToClass())) {
  148.             $self->toClass = $toClass;
  149.         }
  151.         if (!$self->getIdentifiers() && ($identifiers = $link->getIdentifiers())) {
  152.             $self->identifiers = $identifiers;
  153.         }
  155.         if (!$self->getFromProperty() && ($fromProperty = $link->getFromProperty())) {
  156.             $self->fromProperty = $fromProperty;
  157.         }
  159.         if (!$self->getParameterName() && ($parameterName = $link->getParameterName())) {
  160.             $self->parameterName = $parameterName;
  161.         }
  163.         if (!$self->getExpandedValue() && ($expandedValue = $link->getExpandedValue())) {
  164.             $self->expandedValue = $expandedValue;
  165.         }
  167.         return $self;
  168.     }
  169. }