Stratadox\Hydration\Mapping\Property\Relationship\HasOneNested

Complexity

Total Complexity

9

Size/Duplication

Total Lines	67
Duplicated Lines	0 %

Importance

Changes

0

7 Methods

Rating	Name	Duplication	Size	Complexity
A	__construct()	0	5	1
A	inProperty()	0	5	1
A	value()	0	7	2
A	key()	0	3	1
A	inPropertyWithDifferentKey()	0	6	1
A	mustHaveTheKeyInThe()	0	4	2
A	name()	0	3	1

<?php

declare(strict_types=1);

namespace Stratadox\Hydration\Mapping\Property\Relationship;

use Stratadox\Hydration\Mapping\Property\MissingTheKey;
use Stratadox\HydrationMapping\ExposesDataKey;
use Stratadox\Hydrator\Hydrates;
use Throwable;

/**
 * Maps a nested data structure to a has-one relation in an object property.
 *
 * @package Stratadox\Hydrate
 * @author Stratadox
 */
final class HasOneNested implements ExposesDataKey
{
    private $name;
    private $key;
    private $hydrate;

    private function __construct(string $name, string $dataKey, Hydrates $hydrator)
    {
        $this->name = $name;
        $this->key = $dataKey;
        $this->hydrate = $hydrator;
    }

    /**
     * Create a new nested has-one mapping.
     *
     * @param string   $name     The name of the property.
     * @param Hydrates $hydrator The hydrator for the nested object.
     * @return self              The nested has-one mapping.
     */
    public static function inProperty(
        string $name,
        Hydrates $hydrator
    ): self {
        return new self($name, $name, $hydrator);
    }

    /**
     * Create a new nested has-one mapping, using the data from a specific key.
     *
     * @param string   $name     The name of the property.
     * @param string   $key      The name of the key.
     * @param Hydrates $hydrator The hydrator for the nested object.
     * @return self              The nested has-one mapping.
     */
    public static function inPropertyWithDifferentKey(
        string $name,
        string $key,
        Hydrates $hydrator
    ): self {
        return new self($name, $key, $hydrator);
    }

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

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

    public function value(array $data, $owner = null)
    {
        $this->mustHaveTheKeyInThe($data);
        try {
            return $this->hydrate->fromArray($data[$this->key()]);
        } catch (Throwable $exception) {
            throw ObjectMappingFailed::tryingToMapItem($this, $exception);
        }
    }

    private function mustHaveTheKeyInThe(array $data): void
    {
        if (!array_key_exists($this->key(), $data)) {
            throw MissingTheKey::inTheInput($data, $this, $this->key());
        }
    }
}