Stadly\Http\Header\Request\Range

Complexity

Total Complexity

10

Size/Duplication

Total Lines	85
Duplicated Lines	0 %

Test Coverage

Coverage

100%

Importance

Changes	1
Bugs	0	Features	0

8 Methods

Rating	Name	Duplication	Size	Complexity
A	__construct()	0	3	1
A	setRangeSet()	0	3	1
A	getValue()	0	3	1
A	isValid()	0	3	1
A	getName()	0	3	1
A	fromValue()	0	9	3
A	getRangeSet()	0	3	1
A	__toString()	0	3	1

<?php

declare(strict_types=1);

namespace Stadly\Http\Header\Request;

use Stadly\Http\Exception\InvalidHeader;
use Stadly\Http\Header\Value\Range\RangeSet;
use Stadly\Http\Header\Value\Range\RangeSetFactory;
use Stadly\Http\Utilities\Rfc7233;

/**
 * Class for handling the HTTP header field Range.
 *
 * Specification: https://tools.ietf.org/html/rfc7233#section-3.1
 */
final class Range implements Header
{
    /**
     * @var RangeSet Range set.
     */
    private $rangeSet;

    /**
     * Constructor.
     *
     * @param RangeSet $rangeSet Set of ranges.
     */
    public function __construct(RangeSet $rangeSet)
    {
        $this->setRangeSet($rangeSet);
    }

    /**
     * Construct header from value.
     *
     * @param string $value Header value.
     * @return self Header generated based on the value.
     * @throws InvalidHeader If the header value is invalid.
     */
    public static function fromValue(string $value): self
    {
        $regEx = '{^' . Rfc7233::RANGE . '$}';
        $plainValue = mb_convert_encoding($value, 'ISO-8859-1', 'UTF-8');
        if ($plainValue !== $value || preg_match($regEx, $value) !== 1) {
            throw new InvalidHeader('Invalid header value: ' . $value);
        }

        return new self(RangeSetFactory::fromString($value));
    }

    /**
     * @inheritDoc
     * @throws void The header is always valid.
     */
    public function __toString(): string
    {
        return $this->getName() . ': ' . $this->getValue();
    }

    /**
     * @return true The header is always valid.
     */
    public function isValid(): bool
    {
        return true;
    }

    /**
     * @inheritDoc
     */
    public function getName(): string
    {
        return 'Range';
    }

    /**
     * @inheritDoc
     * @throws void The header is always valid.
     */
    public function getValue(): string
    {
        return (string)$this->rangeSet;
    }

    /**
     * @return RangeSet Set of ranges.
     */
    public function getRangeSet(): RangeSet
    {
        return $this->rangeSet;
    }

    /**
     * Set range set.
     *
     * @param RangeSet $rangeSet Set of ranges.
     */
    public function setRangeSet(RangeSet $rangeSet): void
    {
        $this->rangeSet = $rangeSet;
    }
}