Stratadox\Hydration\Mapping\Property\Relationship\HasBackReference

Complexity

Total Complexity

6

Size/Duplication

Total Lines	37
Duplicated Lines	0 %

Importance

Changes

0

5 Methods

Rating	Name	Duplication	Size	Complexity
A	inProperty()	0	3	1
A	name()	0	3	1
A	hydrating()	0	3	1
A	__construct()	0	3	1
A	value()	0	6	2

<?php

declare(strict_types=1);

namespace Stratadox\Hydration\Mapping\Property\Relationship;

use Stratadox\HydrationMapping\MapsProperty;
use Stratadox\Hydrator\ObservesHydration;

/**
 * Maps a back-reference in a bidirectional relationship.
 *
 * @package Stratadox\Hydrate
 * @author Stratadox
 */
final class HasBackReference implements MapsProperty, ObservesHydration
{
    private $name;
    private $referenceTo;

    private function __construct(string $name)
    {
        $this->name = $name;
    }

    /**
     * Create a new mapping that refers back to the "owning" object.
     *
     * @param string $name The name of both the property.
     * @return self        The mapping for the bidirectional relationship.
     */
    public static function inProperty(string $name) : self
    {
        return new self($name);
    }

    public function name() : string
    {
        return $this->name;
    }

    public function hydrating($theInstance) : void
    {
        $this->referenceTo = $theInstance;
    }

    public function value(array $data, $owner = null)
    {
        if (!isset($this->referenceTo)) {
            throw NoReferrerFound::tryingToHydrateBackReferenceIn($this->name);
        }
        return $this->referenceTo;
    }
}