REST: Implement ItemAliasesRetriever

Bug: T330896
Change-Id: Ica45d44f0f8fa8ee2341f3cdbd29947066691b3e

Author: MuhammadJaziraly

repo/rest-api/src/DataAccess/PrefetchingTermLookupAliasesRetriever.php

@@ -0,0 +1,45 @@
+<?php declare( strict_types=1 );
+
+namespace Wikibase\Repo\RestApi\DataAccess;
+
+use Wikibase\DataAccess\PrefetchingTermLookup;
+use Wikibase\DataModel\Entity\ItemId;
+use Wikibase\DataModel\Term\TermTypes;
+use Wikibase\Lib\ContentLanguages;
+use Wikibase\Repo\RestApi\Domain\ReadModel\Aliases;
+use Wikibase\Repo\RestApi\Domain\ReadModel\AliasesInLanguage;
+use Wikibase\Repo\RestApi\Domain\Services\ItemAliasesRetriever;
+
+/**
+ * @license GPL-2.0-or-later
+ */
+class PrefetchingTermLookupAliasesRetriever implements ItemAliasesRetriever {
+
+	private PrefetchingTermLookup $prefetchingTermLookup;
+	private ContentLanguages $termLanguages;
+
+	public function __construct( PrefetchingTermLookup $prefetchingTermLookup, ContentLanguages $termLanguages ) {
+		$this->prefetchingTermLookup = $prefetchingTermLookup;
+		$this->termLanguages = $termLanguages;
+	}
+
+	public function getAliases( ItemId $itemId ): ?Aliases {
+		$this->prefetchingTermLookup->prefetchTerms(
+			[ $itemId ],
+			[ TermTypes::TYPE_ALIAS ],
+			$this->termLanguages->getLanguages()
+		);
+
+		$aliases = new Aliases();
+
+		foreach ( $this->termLanguages->getLanguages() as $lang ) {
+			$prefetchedAliases = $this->prefetchingTermLookup->getPrefetchedAliases( $itemId, $lang );
+
+			if ( $prefetchedAliases ) {
+				$aliases[$lang] = new AliasesInLanguage( $lang, $prefetchedAliases );
+			}
+		}
+
+		return $aliases;
+	}
+}

repo/rest-api/src/Domain/Services/ItemAliasesRetriever.php

@@ -0,0 +1,15 @@
+<?php declare( strict_types=1 );
+
+namespace Wikibase\Repo\RestApi\Domain\Services;
+
+use Wikibase\DataModel\Entity\ItemId;
+use Wikibase\Repo\RestApi\Domain\ReadModel\Aliases;
+
+/**
+ * @license GPL-2.0-or-later
+ */
+interface ItemAliasesRetriever {
+
+	public function getAliases( ItemId $itemId ): ?Aliases;
+
+}

repo/rest-api/tests/phpunit/DataAccess/PrefetchingTermLookupAliasesRetrieverTest.php

@@ -0,0 +1,69 @@
+<?php declare( strict_types=1 );
+
+namespace Wikibase\Repo\Tests\RestApi\DataAccess;
+
+use PHPUnit\Framework\TestCase;
+use Wikibase\DataAccess\PrefetchingTermLookup;
+use Wikibase\DataAccess\Tests\FakePrefetchingTermLookup;
+use Wikibase\DataModel\Entity\ItemId;
+use Wikibase\Lib\StaticContentLanguages;
+use Wikibase\Repo\RestApi\DataAccess\PrefetchingTermLookupAliasesRetriever;
+use Wikibase\Repo\RestApi\Domain\ReadModel\Aliases;
+use Wikibase\Repo\RestApi\Domain\ReadModel\AliasesInLanguage;
+
+/**
+ * @covers \Wikibase\Repo\RestApi\DataAccess\PrefetchingTermLookupAliasesRetriever
+ *
+ * @group Wikibase
+ *
+ * @license GPL-2.0-or-later
+ */
+class PrefetchingTermLookupAliasesRetrieverTest extends TestCase {
+
+	private const ALL_TERM_LANGUAGES = [ 'de', 'en', 'ar' ];
+	private const ITEM_ID = 'Q123';
+
+	public function testGetAliases(): void {
+		$itemId = new ItemId( self::ITEM_ID );
+		$fakePrefetchingTermLookup = new FakePrefetchingTermLookup();
+
+		$aliasesRetriever = new PrefetchingTermLookupAliasesRetriever(
+			$fakePrefetchingTermLookup,
+			new StaticContentLanguages( self::ALL_TERM_LANGUAGES )
+		);
+
+		$aliases = $aliasesRetriever->getAliases( $itemId );
+
+		$aliasesReadModel = new Aliases(
+			new AliasesInLanguage( 'de', [ 'Q123 de alias 1', 'Q123 de alias 2' ] ),
+			new AliasesInLanguage( 'en', [ 'Q123 en alias 1', 'Q123 en alias 2' ] ),
+			new AliasesInLanguage( 'ar', [ 'Q123 ar alias 1', 'Q123 ar alias 2' ] ),
+		);
+
+		$this->assertEquals( $aliasesReadModel, $aliases );
+	}
+
+	public function testGetAliasesForSpecificLanguages(): void {
+		$itemId = new ItemId( self::ITEM_ID );
+		$languages = [ 'en', 'de' ];
+
+		$prefetchingTermLookup = $this->createStub( PrefetchingTermLookup::class );
+		$prefetchingTermLookup->method( 'getPrefetchedAliases' )
+			->willReturnMap( [
+				[ $itemId, 'en', [ 'Q123 en alias 1', 'Q123 en alias 2' ] ],
+				[ $itemId, 'de', false ],
+			] );
+
+		$aliasesRetriever = new PrefetchingTermLookupAliasesRetriever(
+			$prefetchingTermLookup,
+			new StaticContentLanguages( $languages )
+		);
+
+		$aliases = $aliasesRetriever->getAliases( $itemId );
+
+		$this->assertCount( 1, $aliases );
+		$this->assertArrayHasKey( 'en', $aliases );
+		$this->assertArrayNotHasKey( 'de', $aliases );
+	}
+
+}