Swis\JsonApi\Client\Parsers\LinksParser

Complexity

Total Complexity

16

Size/Duplication

Total Lines	82
Duplicated Lines	0 %

Test Coverage

Coverage

100%

Importance

Changes

0

3 Methods

Rating	Name	Duplication	Size	Complexity
B	buildLink()	0	22	9
A	__construct()	0	3	1
A	parse()	0	17	6

<?php

namespace Swis\JsonApi\Client\Parsers;

use Swis\JsonApi\Client\Collection;
use Swis\JsonApi\Client\Exceptions\ValidationException;
use Swis\JsonApi\Client\Link;
use Swis\JsonApi\Client\Links;

/**
 * @internal
 */
class LinksParser
{
    public const SOURCE_DOCUMENT = 'document';

    public const SOURCE_ERROR = 'error';

    public const SOURCE_ITEM = 'item';

    public const SOURCE_RELATIONSHIP = 'relationship';

    private const LINKS_THAT_MAY_NOT_BE_NULL_WHEN_PRESENT = [
        'self',
        'related',
    ];

    /**
     * @var \Swis\JsonApi\Client\Parsers\MetaParser
     */
    private $metaParser;

    /**
     * @param \Swis\JsonApi\Client\Parsers\MetaParser $metaParser
     */
    public function __construct(MetaParser $metaParser)
    {
        $this->metaParser = $metaParser;
    }

    /**
     * @param mixed  $data
     * @param string $source
     *
     * @return \Swis\JsonApi\Client\Links
     */
    public function parse($data, string $source): Links
    {
        if ($source === self::SOURCE_ERROR && !property_exists($data, 'about')) {
            throw new ValidationException('Error links object MUST contain at least one of the following properties: `about`.');
        }
        if ($source === self::SOURCE_RELATIONSHIP && !property_exists($data, 'self') && !property_exists($data, 'related')) {
            throw new ValidationException('Relationship links object MUST contain at least one of the following properties: `self`, `related`.');
        }

        return new Links(
            Collection::wrap((array)$data)
                ->map(
                    function ($link, $name) {
                        return $this->buildLink($link, $name);
                    }
                )
                ->toArray()
        );
    }

    /**
     * @param mixed  $data
     * @param string $name
     *
     * @return \Swis\JsonApi\Client\Link
     */
    private function buildLink($data, string $name): ? Link
    {
        if (in_array($name, self::LINKS_THAT_MAY_NOT_BE_NULL_WHEN_PRESENT, true) && !is_string($data) && !is_object($data)) {
            throw new ValidationException(sprintf('Link "%s" has to be an object or string, "%s" given.', $name, gettype($data)));
        }

        if ($data === null) {
            return null;
        }

        if (is_string($data)) {
            return new Link($data);
        }

        if (!is_object($data)) {
            throw new ValidationException(sprintf('Link "%s" has to be an object, string or null, "%s" given.', $name, gettype($data)));
        }
        if (!property_exists($data, 'href')) {
            throw new ValidationException(sprintf('Link "%s" must have a "href" attribute.', $name));
        }

        return new Link($data->href, property_exists($data, 'meta') ? $this->metaParser->parse($data->meta) : null);
    }
}