X509\AttributeCertificate\Attributes

Complexity

Total Complexity

16

Size/Duplication

Total Lines	184
Duplicated Lines	0 %

Coupling/Cohesion

Components	3
Dependencies	5

Test Coverage

Coverage

100%

Importance

Changes

0

15 Methods

Rating	Name	Duplication	Size	Complexity
A	__construct()	0	3	1
A	fromAttributeValues()	0	7	1
A	fromASN1()	0	17	2
A	hasAccessIdentity()	0	3	1
A	accessIdentity()	0	3	1
A	hasAuthenticationInformation()	0	3	1
A	authenticationInformation()	0	3	1
A	hasChargingIdentity()	0	3	1
A	chargingIdentity()	0	3	1
A	hasGroup()	0	3	1
A	group()	0	3	1
A	hasRole()	0	3	1
A	role()	0	3	1
A	roles()	0	7	1
A	toASN1()	0	7	1

<?php

namespace X509\AttributeCertificate;

use ASN1\Type\Constructed\Sequence;
use ASN1\Type\UnspecifiedType;
use X501\ASN1\Attribute;
use X501\ASN1\AttributeType;
use X501\ASN1\AttributeValue\AttributeValue;
use X509\AttributeCertificate\Attribute\AccessIdentityAttributeValue;
use X509\AttributeCertificate\Attribute\AuthenticationInfoAttributeValue;
use X509\AttributeCertificate\Attribute\ChargingIdentityAttributeValue;
use X509\AttributeCertificate\Attribute\GroupAttributeValue;
use X509\AttributeCertificate\Attribute\RoleAttributeValue;
use X509\Feature\AttributeContainer;


/**
 * Implements <i>Attributes</i> ASN.1 type as a <i>SEQUENCE OF Attribute</i>.
 *
 * Used in <i>AttributeCertificateInfo</i>.
 *
 * @link https://tools.ietf.org/html/rfc5755#section-4.1
 * @link https://tools.ietf.org/html/rfc5755#section-4.2.7
 */
class Attributes implements \Countable, \IteratorAggregate
{
	use AttributeContainer;
	
	/**
	 * Mapping from OID to attribute value class name.
	 *
	 * @internal
	 *
	 * @var array
	 */
	const MAP_OID_TO_CLASS = array(
		/* @formatter:off */
		AccessIdentityAttributeValue::OID => AccessIdentityAttributeValue::class,
		AuthenticationInfoAttributeValue::OID => AuthenticationInfoAttributeValue::class,
		ChargingIdentityAttributeValue::OID => ChargingIdentityAttributeValue::class,
		GroupAttributeValue::OID => GroupAttributeValue::class,
		AttributeType::OID_ROLE => RoleAttributeValue::class
		/* @formatter:on */
	);
	
	/**
	 * Constructor
	 *
	 * @param Attribute ...$attribs
	 */
	public function __construct(Attribute ...$attribs) {
		$this->_attributes = $attribs;
	}
	
	/**
	 * Initialize from attribute values.
	 *
	 * @param AttributeValue ...$values
	 * @return self
	 */
	public static function fromAttributeValues(AttributeValue ...$values) {
		$attribs = array_map(
			function (AttributeValue $value) {
				return $value->toAttribute();
			}, $values);
		return new self(...$attribs);
	}
	
	/**
	 * Initialize from ASN.1.
	 *
	 * @param Sequence $seq
	 * @return self
	 */
	public static function fromASN1(Sequence $seq) {
		$attribs = array_map(
			function (UnspecifiedType $el) {
				return Attribute::fromASN1($el->asSequence());
			}, $seq->elements());
		// cast attributes
		$attribs = array_map(
			function (Attribute $attr) {
				$oid = $attr->oid();
				if (array_key_exists($oid, self::MAP_OID_TO_CLASS)) {
					$cls = self::MAP_OID_TO_CLASS[$oid];
					$attr = $attr->castValues($cls);
				}
				return $attr;
			}, $attribs);
		return new self(...$attribs);
	}
	
	/**
	 * Check whether 'Access Identity' attribute is present.
	 *
	 * @return bool
	 */
	public function hasAccessIdentity() {
		return $this->has(AccessIdentityAttributeValue::OID);
	}
	
	/**
	 * Get the first 'Access Identity' attribute value.
	 *
	 * @return AccessIdentityAttributeValue
	 */
	public function accessIdentity() {
		return $this->firstOf(AccessIdentityAttributeValue::OID)->first();
	}
	
	/**
	 * Check whether 'Service Authentication Information' attribute is present.
	 *
	 * @return bool
	 */
	public function hasAuthenticationInformation() {
		return $this->has(AuthenticationInfoAttributeValue::OID);
	}
	
	/**
	 * Get the first 'Service Authentication Information' attribute value.
	 *
	 * @return AuthenticationInfoAttributeValue
	 */
	public function authenticationInformation() {
		return $this->firstOf(AuthenticationInfoAttributeValue::OID)->first();
	}
	
	/**
	 * Check whether 'Charging Identity' attribute is present.
	 *
	 * @return bool
	 */
	public function hasChargingIdentity() {
		return $this->has(ChargingIdentityAttributeValue::OID);
	}
	
	/**
	 * Get the first 'Charging Identity' attribute value.
	 *
	 * @return ChargingIdentityAttributeValue
	 */
	public function chargingIdentity() {
		return $this->firstOf(ChargingIdentityAttributeValue::OID)->first();
	}
	
	/**
	 * Check whether 'Group' attribute is present.
	 *
	 * @return bool
	 */
	public function hasGroup() {
		return $this->has(GroupAttributeValue::OID);
	}
	
	/**
	 * Get the first 'Group' attribute value.
	 *
	 * @return GroupAttributeValue
	 */
	public function group() {
		return $this->firstOf(GroupAttributeValue::OID)->first();
	}
	
	/**
	 * Check whether 'Role' attribute is present.
	 *
	 * @return bool
	 */
	public function hasRole() {
		return $this->has(AttributeType::OID_ROLE);
	}
	
	/**
	 * Get the first 'Role' attribute value.
	 *
	 * @return RoleAttributeValue
	 */
	public function role() {
		return $this->firstOf(AttributeType::OID_ROLE)->first();
	}
	
	/**
	 * Get all 'Role' attribute values.
	 * 
	 * @return RoleAttributeValue[]
	 */
	public function roles() {
		return array_merge(array(), 
			...array_map(
				function (Attribute $attr) {
					return $attr->values();
				}, $this->allOf(AttributeType::OID_ROLE)));
	}
	
	/**
	 * Generate ASN.1 structure.
	 *
	 * @return Sequence
	 */
	public function toASN1() {
		$elements = array_map(
			function (Attribute $attr) {
				return $attr->toASN1();
			}, array_values($this->_attributes));
		return new Sequence(...$elements);
	}
}