Wikibase\DataModel\Services\EntityId\EntityIdComposer

Complexity

Total Complexity

8

Size/Duplication

Total Lines	46
Duplicated Lines	0 %

Importance

Changes	2
Bugs	0	Features	0

2 Methods

Rating	Name	Duplication	Size	Complexity
A	composeEntityId()	0	12	3
A	__construct()	0	8	5

<?php

namespace Wikibase\DataModel\Services\EntityId;

use InvalidArgumentException;
use UnexpectedValueException;
use Wikibase\DataModel\Entity\EntityId;

/**
 * Constructs EntityId objects from entity type identifiers and unique parts of entity ID
 * serializations. The unique part is typically the numeric part of an entity ID, excluding the
 * static part that's the same for all IDs of that type.
 *
 * Meant to be the counterpart for @see Int32EntityId::getNumericId, as well as an extensible
 * replacement for @see LegacyIdInterpreter::newIdFromTypeAndNumber.
 *
 * @since 3.9
 *
 * @license GPL-2.0-or-later
 * @author Thiemo Kreuz
 */
class EntityIdComposer {

	/**
	 * @var callable[]
	 */
	private $composers;

	/**
	 * @param callable[] $composers Array mapping entity type identifiers to callables accepting a
	 *  single mixed value, representing the unique part of an entity ID serialization, and
	 *  returning an EntityId object.
	 *
	 * @throws InvalidArgumentException
	 */
	public function __construct( array $composers ) {
		foreach ( $composers as $entityType => $composer ) {
			if ( !is_string( $entityType ) || $entityType === '' || !is_callable( $composer ) ) {
				throw new InvalidArgumentException( '$composers must map non-empty strings to callables' );
			}
		}

		$this->composers = $composers;
	}

	/**
	 * @param string $entityType
	 * @param mixed $uniquePart
	 *
	 * @throws InvalidArgumentException when the entity type is not known or the unique part is not
	 *  unique.
	 * @throws UnexpectedValueException when the configured composer did not return an EntityId
	 *  object.
	 * @return EntityId
	 */
	public function composeEntityId( $entityType, $uniquePart ) {
		if ( !isset( $this->composers[$entityType] ) ) {
			throw new InvalidArgumentException( 'Unknown entity type ' . $entityType );
		}

		$id = $this->composers[$entityType]( $uniquePart );

		if ( !( $id instanceof EntityId ) ) {
			throw new UnexpectedValueException( 'Composer for ' . $entityType . ' is invalid' );
		}

		return $id;
	}

}