Wikibase\DataModel\Services\ByPropertyIdGrouper

Complexity

Total Complexity

13

Size/Duplication

Total Lines	95
Duplicated Lines	0 %

Coupling/Cohesion

Components	1
Dependencies	2

Test Coverage

Coverage

100%

Importance

Changes

0

7 Methods

Rating	Name	Duplication	Size	Complexity
A	__construct()	0	4	1
A	assertArePropertyIdProviders()	0	13	5
A	indexPropertyIdProviders()	0	5	2
A	addPropertyIdProvider()	0	4	1
A	getPropertyIds()	0	8	1
A	getByPropertyId()	0	9	2
A	hasPropertyId()	0	3	1

<?php

namespace Wikibase\DataModel\Services;

use InvalidArgumentException;
use OutOfBoundsException;
use Traversable;
use Wikibase\DataModel\Entity\PropertyId;
use Wikibase\DataModel\PropertyIdProvider;

/**
 * Groups property id providers by their property id.
 *
 * @since 1.0
 *
 * @license GPL-2.0-or-later
 * @author Bene* < benestar.wikimedia@gmail.com >
 */
class ByPropertyIdGrouper {

	/**
	 * @var array[]
	 */
	private $byPropertyId = [];

	/**
	 * @param PropertyIdProvider[]|Traversable $propertyIdProviders
	 *
	 * @throws InvalidArgumentException
	 */
	public function __construct( $propertyIdProviders ) {
		$this->assertArePropertyIdProviders( $propertyIdProviders );
		$this->indexPropertyIdProviders( $propertyIdProviders );
	}

	private function assertArePropertyIdProviders( $propertyIdProviders ) {
		if ( !is_array( $propertyIdProviders ) && !( $propertyIdProviders instanceof Traversable ) ) {
			throw new InvalidArgumentException( '$propertyIdProviders must be an array or an instance of Traversable' );
		}

		foreach ( $propertyIdProviders as $propertyIdProvider ) {
			if ( !( $propertyIdProvider instanceof PropertyIdProvider ) ) {
				throw new InvalidArgumentException(
					'Every element in $propertyIdProviders must be an instance of PropertyIdProvider'
				);
			}
		}
	}

	/**
	 * @param PropertyIdProvider[]|Traversable $propertyIdProviders
	 */
	private function indexPropertyIdProviders( $propertyIdProviders ) {
		foreach ( $propertyIdProviders as $propertyIdProvider ) {
			$this->addPropertyIdProvider( $propertyIdProvider );
		}
	}

	private function addPropertyIdProvider( PropertyIdProvider $propertyIdProvider ) {
		$idSerialization = $propertyIdProvider->getPropertyId()->getSerialization();
		$this->byPropertyId[$idSerialization][] = $propertyIdProvider;
	}

	/**
	 * Returns all property ids which were found.
	 *
	 * @since 1.0
	 *
	 * @return PropertyId[]
	 */
	public function getPropertyIds() {
		return array_map(
			function( $propertyId ) {
				return new PropertyId( $propertyId );
			},
			array_keys( $this->byPropertyId )
		);
	}

	/**
	 * Returns the PropertyIdProvider instances for the given PropertyId.
	 *
	 * @since 1.0
	 *
	 * @param PropertyId $propertyId
	 *
	 * @throws OutOfBoundsException
	 * @return PropertyIdProvider[]
	 */
	public function getByPropertyId( PropertyId $propertyId ) {
		$idSerialization = $propertyId->getSerialization();

		if ( !isset( $this->byPropertyId[$idSerialization] ) ) {
			throw new OutOfBoundsException( 'PropertyIdProvider with propertyId "' . $idSerialization . '" not found' );
		}

		return $this->byPropertyId[$idSerialization];
	}

	/**
	 * Checks if there are PropertyIdProvider instances for the given PropertyId.
	 *
	 * @since 1.0
	 *
	 * @param PropertyId $propertyId
	 *
	 * @return bool
	 */
	public function hasPropertyId( PropertyId $propertyId ) {
		return isset( $this->byPropertyId[$propertyId->getSerialization()] );
	}

}