X509\Certificate\Extension\DistributionPoint\DistributionPoint

Complexity

Total Complexity

24

Size/Duplication

Total Lines	214
Duplicated Lines	0 %

Coupling/Cohesion

Components	1
Dependencies	8

Test Coverage

Coverage

100%

Importance

Changes

0

13 Methods

Rating	Name	Duplication	Size	Complexity
A	distributionPointName()	0	6	2
A	reasons()	0	6	2
A	relativeName()	0	6	2
A	fromASN1()	0	21	4
A	toASN1()	0	14	4
A	hasRelativeName()	0	4	1
A	fullName()	0	6	2
A	crlIssuer()	0	6	2
A	hasFullName()	0	4	1
A	hasReasons()	0	3	1
A	hasCRLIssuer()	0	3	1
A	hasDistributionPointName()	0	3	1
A	__construct()	0	6	1

<?php

declare(strict_types = 1);

namespace Sop\X509\Certificate\Extension\DistributionPoint;

use Sop\ASN1\Element;
use Sop\ASN1\Type\Constructed\Sequence;
use Sop\ASN1\Type\Tagged\ExplicitlyTaggedType;
use Sop\ASN1\Type\Tagged\ImplicitlyTaggedType;
use Sop\X509\GeneralName\GeneralNames;

/**
 * Implements <i>DistributionPoint</i> ASN.1 type used by
 * 'CRL Distribution Points' certificate extension.
 *
 * @see https://tools.ietf.org/html/rfc5280#section-4.2.1.13
 */
class DistributionPoint
{
    /**
     * Distribution point name.
     *
     * @var null|DistributionPointName
     */
    protected $_distributionPoint;

    /**
     * Revocation reason.
     *
     * @var null|ReasonFlags
     */
    protected $_reasons;

    /**
     * CRL issuer.
     *
     * @var null|GeneralNames
     */
    protected $_issuer;

    /**
     * Constructor.
     *
     * @param null|DistributionPointName $name
     * @param null|ReasonFlags           $reasons
     * @param null|GeneralNames          $issuer
     */
    public function __construct(?DistributionPointName $name = null,
        ?ReasonFlags $reasons = null, ?GeneralNames $issuer = null)
    {
        $this->_distributionPoint = $name;
        $this->_reasons = $reasons;
        $this->_issuer = $issuer;
    }

    /**
     * Initialize from ASN.1.
     *
     * @param Sequence $seq
     *
     * @return self
     */
    public static function fromASN1(Sequence $seq): self
    {
        $name = null;
        $reasons = null;
        $issuer = null;
        if ($seq->hasTagged(0)) {
            // promoted to explicit tagging because underlying type is CHOICE
            $name = DistributionPointName::fromTaggedType(
                $seq->getTagged(0)->asExplicit()->asTagged());
        }
        if ($seq->hasTagged(1)) {
            $reasons = ReasonFlags::fromASN1(
                $seq->getTagged(1)->asImplicit(Element::TYPE_BIT_STRING)
                    ->asBitString());
        }
        if ($seq->hasTagged(2)) {
            $issuer = GeneralNames::fromASN1(
                $seq->getTagged(2)->asImplicit(Element::TYPE_SEQUENCE)
                    ->asSequence());
        }
        return new self($name, $reasons, $issuer);
    }

    /**
     * Check whether distribution point name is set.
     *
     * @return bool
     */
    public function hasDistributionPointName(): bool
    {
        return isset($this->_distributionPoint);
    }

    /**
     * Get distribution point name.
     *
     * @throws \LogicException If not set
     *
     * @return DistributionPointName
     */
    public function distributionPointName(): DistributionPointName
    {
        if (!$this->hasDistributionPointName()) {
            throw new \LogicException('distributionPoint not set.');
        }
        return $this->_distributionPoint;

The expression return $this->_distributionPoint could return the type null which is incompatible with the type-hinted return Sop\X509\Certificate\Extension\DistributionPoint\DistributionPointName. Consider adding an additional type-check to rule them out.

    }

    /**
     * Check whether distribution point name is set and it's a full name.
     *
     * @return bool
     */
    public function hasFullName(): bool
    {
        return DistributionPointName::TAG_FULL_NAME ===
             $this->distributionPointName()->tag();
    }

    /**
     * Get full distribution point name.
     *
     * @throws \LogicException If not set
     *
     * @return FullName
     */
    public function fullName(): FullName
    {
        if (!$this->hasFullName()) {
            throw new \LogicException('fullName not set.');
        }
        return $this->_distributionPoint;

The expression return $this->_distributionPoint returns the type null which is incompatible with the type-hinted return Sop\X509\Certificate\Extension\DistributionPoint\FullName.

    }

    /**
     * Check whether distribution point name is set and it's a relative name.
     *
     * @return bool
     */
    public function hasRelativeName(): bool
    {
        return DistributionPointName::TAG_RDN ===
             $this->distributionPointName()->tag();
    }

    /**
     * Get relative distribution point name.
     *
     * @throws \LogicException If not set
     *
     * @return RelativeName
     */
    public function relativeName(): RelativeName
    {
        if (!$this->hasRelativeName()) {
            throw new \LogicException('nameRelativeToCRLIssuer not set.');
        }
        return $this->_distributionPoint;

The expression return $this->_distributionPoint returns the type null which is incompatible with the type-hinted return Sop\X509\Certificate\Extension\DistributionPoint\RelativeName.

    }

    /**
     * Check whether reasons flags is set.
     *
     * @return bool
     */
    public function hasReasons(): bool
    {
        return isset($this->_reasons);
    }

    /**
     * Get revocation reason flags.
     *
     * @throws \LogicException If not set
     *
     * @return ReasonFlags
     */
    public function reasons(): ReasonFlags
    {
        if (!$this->hasReasons()) {
            throw new \LogicException('reasons not set.');
        }
        return $this->_reasons;

The expression return $this->_reasons could return the type null which is incompatible with the type-hinted return Sop\X509\Certificate\Extension\DistributionPoint\ReasonFlags. Consider adding an additional type-check to rule them out.

    }

    /**
     * Check whether cRLIssuer is set.
     *
     * @return bool
     */
    public function hasCRLIssuer(): bool
    {
        return isset($this->_issuer);
    }

    /**
     * Get CRL issuer.
     *
     * @throws \LogicException If not set
     *
     * @return GeneralNames
     */
    public function crlIssuer(): GeneralNames
    {
        if (!$this->hasCRLIssuer()) {
            throw new \LogicException('crlIssuer not set.');
        }
        return $this->_issuer;

The expression return $this->_issuer could return the type null which is incompatible with the type-hinted return Sop\X509\GeneralName\GeneralNames. Consider adding an additional type-check to rule them out.

    }

    /**
     * Generate ASN.1 structure.
     *
     * @return Sequence
     */
    public function toASN1(): Sequence
    {
        $elements = [];
        if (isset($this->_distributionPoint)) {
            $elements[] = new ExplicitlyTaggedType(0,
                $this->_distributionPoint->toASN1());

The method toASN1() does not exist on null.

        }
        if (isset($this->_reasons)) {
            $elements[] = new ImplicitlyTaggedType(1, $this->_reasons->toASN1());

The method toASN1() does not exist on null.

        }
        if (isset($this->_issuer)) {
            $elements[] = new ImplicitlyTaggedType(2, $this->_issuer->toASN1());

The method toASN1() does not exist on null.

        }
        return new Sequence(...$elements);
    }
}