IBX-4123: [Backport] Added /languages and /languages/{code} endpo…

…ints

(cherry picked from commit 674e612e176bc85556513a716556d643f81d722d)

src/bundle/Resources/config/routing.yml

@@ -383,6 +383,18 @@ ezpublish_rest_setObjectStatesForContent:
         contentId: \d+
 
 
+# Languages
+
+ibexa.rest.languages.list:
+    path: /languages
+    methods: [GET]
+    controller: Ibexa\Rest\Server\Controller\Language::listLanguages
+
+ibexa.rest.languages.view:
+    path: /languages/{languageCode}
+    methods: [GET]
+    controller: Ibexa\Rest\Server\Controller\Language::loadLanguage
+
 # Locations
 
 

src/bundle/Resources/config/services.yml

@@ -177,6 +177,10 @@ services:
             - "@ezpublish.api.service.location"
         tags: [controller.service_arguments]
 
+    Ibexa\Rest\Server\Controller\Language:
+        autowire: true
+        tags: [ controller.service_arguments ]
+
     ezpublish_rest.controller.location:
         class: "%ezpublish_rest.controller.location.class%"
         parent: ezpublish_rest.controller.base

src/bundle/Resources/config/value_object_visitors.yml

@@ -206,6 +206,11 @@ services:
             - { name: ezpublish_rest.output.value_object_visitor, type: Symfony\Component\HttpKernel\Exception\HttpException }
 
     # Language
+    Ibexa\Rest\Server\Output\ValueObjectVisitor\LanguageList:
+        parent: Ibexa\Contracts\Rest\Output\ValueObjectVisitor
+        tags:
+            - { name: ibexa.rest.output.value_object.visitor, type: Ibexa\Rest\Server\Values\LanguageList }
+
     ezpublish_rest.output.value_object_visitor.Language:
         parent: ezpublish_rest.output.value_object_visitor.base
         class: EzSystems\EzPlatformRest\Server\Output\ValueObjectVisitor\Language

src/lib/Server/Controller/Language.php

@@ -0,0 +1,41 @@
+<?php
+
+/**
+ * @copyright Copyright (C) Ibexa AS. All rights reserved.
+ * @license For full copyright and license information view LICENSE file distributed with this source code.
+ */
+declare(strict_types=1);
+
+namespace Ibexa\Rest\Server\Controller;
+
+use Ibexa\Contracts\Core\Repository\LanguageService;
+use Ibexa\Contracts\Core\Repository\Values\Content\Language as ApiLanguage;
+use Ibexa\Rest\Server\Controller as RestController;
+use Ibexa\Rest\Server\Values\LanguageList;
+use Traversable;
+
+final class Language extends RestController
+{
+    private LanguageService $languageService;
+
+    public function __construct(LanguageService $languageService)
+    {
+        $this->languageService = $languageService;
+    }
+
+    public function listLanguages(): LanguageList
+    {
+        $languages = $this->languageService->loadLanguages();
+
+        if ($languages instanceof Traversable) {
+            $languages = iterator_to_array($languages);
+        }
+
+        return new LanguageList($languages);
+    }
+
+    public function loadLanguage(string $languageCode): ApiLanguage
+    {
+        return $this->languageService->loadLanguage($languageCode);
+    }
+}

src/lib/Server/Output/ValueObjectVisitor/Language.php

@@ -28,8 +28,15 @@ public function visit(Visitor $visitor, Generator $generator, $data): void
 
     private function visitLanguageAttributes(Visitor $visitor, Generator $generator, LanguageValue $language): void
     {
-        $generator->valueElement('languageId', $language->id);
-        $generator->valueElement('languageCode', $language->languageCode);
-        $generator->valueElement('name', $language->name);
+        $generator->attribute(
+            'href',
+            $this->router->generate(
+                'ibexa.rest.languages.view',
+                ['languageCode' => $language->getLanguageCode()],
+            ),
+        );
+        $generator->valueElement('languageId', $language->getId());
+        $generator->valueElement('languageCode', $language->getLanguageCode());
+        $generator->valueElement('name', $language->getName());
     }
 }

src/lib/Server/Output/ValueObjectVisitor/LanguageList.php

@@ -0,0 +1,35 @@
+<?php
+
+/**
+ * @copyright Copyright (C) Ibexa AS. All rights reserved.
+ * @license For full copyright and license information view LICENSE file distributed with this source code.
+ */
+declare(strict_types=1);
+
+namespace Ibexa\Rest\Server\Output\ValueObjectVisitor;
+
+use Ibexa\Contracts\Rest\Output\Generator;
+use Ibexa\Contracts\Rest\Output\ValueObjectVisitor;
+use Ibexa\Contracts\Rest\Output\Visitor;
+
+final class LanguageList extends ValueObjectVisitor
+{
+    /**
+     * @param \Ibexa\Rest\Server\Values\LanguageList $data
+     */
+    public function visit(Visitor $visitor, Generator $generator, $data): void
+    {
+        $generator->startObjectElement('LanguageList');
+        $visitor->setHeader('Content-Type', $generator->getMediaType('LanguageList'));
+
+        $generator->attribute('href', $this->router->generate('ibexa.rest.languages.list'));
+
+        $generator->startList('Language');
+        foreach ($data->languages as $language) {
+            $visitor->visitValueObject($language);
+        }
+        $generator->endList('Language');
+
+        $generator->endObjectElement('LanguageList');
+    }
+}

src/lib/Server/Values/LanguageList.php

@@ -0,0 +1,25 @@
+<?php
+
+/**
+ * @copyright Copyright (C) Ibexa AS. All rights reserved.
+ * @license For full copyright and license information view LICENSE file distributed with this source code.
+ */
+declare(strict_types=1);
+
+namespace Ibexa\Rest\Server\Values;
+
+use Ibexa\Rest\Value as RestValue;
+
+final class LanguageList extends RestValue
+{
+    /** @var \Ibexa\Contracts\Core\Repository\Values\Content\Language[] */
+    public array $languages;
+
+    /**
+     * @param array<\Ibexa\Contracts\Core\Repository\Values\Content\Language> $languages
+     */
+    public function __construct(array $languages)
+    {
+        $this->languages = $languages;
+    }
+}

tests/bundle/Functional/JsonSchema/Language.json

@@ -0,0 +1,38 @@
+{
+  "$schema": "http://json-schema.org/draft-04/schema#",
+  "type": "object",
+  "properties": {
+    "Language": {
+      "type": "object",
+      "properties": {
+        "_media-type": {
+          "type": "string"
+        },
+        "_href": {
+          "type": "string"
+        },
+        "languageId": {
+          "type": "integer"
+        },
+        "languageCode": {
+          "type": "string",
+          "minLength": 1,
+          "pattern": "^[[:alnum:]_]+"
+        },
+        "name": {
+          "type": "string"
+        }
+      },
+      "required": [
+        "_media-type",
+        "_href",
+        "languageId",
+        "languageCode",
+        "name"
+      ]
+    }
+  },
+  "required": [
+    "Language"
+  ]
+}

tests/bundle/Functional/JsonSchema/LanguageList.json

@@ -0,0 +1,56 @@
+{
+  "$schema": "http://json-schema.org/draft-04/schema#",
+  "type": "object",
+  "properties": {
+    "LanguageList": {
+      "type": "object",
+      "properties": {
+        "_media-type": {
+          "type": "string"
+        },
+        "_href": {
+          "type": "string"
+        },
+        "Language": {
+          "type":"array",
+          "items": {
+            "properties": {
+              "_media-type": {
+                "type": "string"
+              },
+              "_href": {
+                "type": "string"
+              },
+              "languageId": {
+                "type": "integer"
+              },
+              "languageCode": {
+                "type": "string",
+                "minLength": 1,
+                "pattern": "^[[:alnum:]_]+"
+              },
+              "name": {
+                "type": "string"
+              }
+            },
+            "required": [
+              "_media-type",
+              "_href",
+              "languageId",
+              "languageCode",
+              "name"
+            ]
+          }
+        }
+      },
+      "required": [
+        "_media-type",
+        "_href",
+        "Language"
+      ]
+    }
+  },
+  "required": [
+    "LanguageList"
+  ]
+}

tests/bundle/Functional/LanguageTest.php

@@ -0,0 +1,64 @@
+<?php
+
+/**
+ * @copyright Copyright (C) Ibexa AS. All rights reserved.
+ * @license For full copyright and license information view LICENSE file distributed with this source code.
+ */
+declare(strict_types=1);
+
+namespace Ibexa\Tests\Bundle\Rest\Functional;
+
+use Ibexa\Tests\Bundle\Rest\Functional\TestCase as RESTFunctionalTestCase;
+
+final class LanguageTest extends RESTFunctionalTestCase
+{
+    use ResourceAssertionsTrait;
+
+    private const SNAPSHOT_DIR = __DIR__ . '/_snapshot';
+
+    public function testLanguageListJson(): void
+    {
+        $request = $this->createHttpRequest('GET', '/api/ibexa/v2/languages', '', 'LanguageList+json');
+        $response = $this->sendHttpRequest($request);
+
+        self::assertHttpResponseCodeEquals($response, 200);
+        $content = $response->getBody()->getContents();
+        self::assertJson($content);
+
+        self::assertJsonResponseIsValid($content, 'LanguageList');
+        self::assertResponseMatchesJsonSnapshot($content, self::SNAPSHOT_DIR . '/LanguageList.json');
+    }
+
+    public function testLanguageListXml(): void
+    {
+        $request = $this->createHttpRequest('GET', '/api/ibexa/v2/languages');
+        $response = $this->sendHttpRequest($request);
+
+        self::assertHttpResponseCodeEquals($response, 200);
+        $content = $response->getBody()->getContents();
+        self::assertResponseMatchesXmlSnapshot($content, self::SNAPSHOT_DIR . '/LanguageList.xml');
+    }
+
+    public function testLanguageViewJson(): void
+    {
+        $request = $this->createHttpRequest('GET', '/api/ibexa/v2/languages/eng-GB', '', 'LanguageList+json');
+        $response = $this->sendHttpRequest($request);
+
+        self::assertHttpResponseCodeEquals($response, 200);
+        $content = $response->getBody()->getContents();
+        self::assertJson($content);
+
+        self::assertJsonResponseIsValid($content, 'Language');
+        self::assertResponseMatchesJsonSnapshot($content, self::SNAPSHOT_DIR . '/Language.json');
+    }
+
+    public function testLanguageViewXml(): void
+    {
+        $request = $this->createHttpRequest('GET', '/api/ibexa/v2/languages/eng-GB');
+        $response = $this->sendHttpRequest($request);
+
+        self::assertHttpResponseCodeEquals($response, 200);
+        $content = $response->getBody()->getContents();
+        self::assertResponseMatchesXmlSnapshot($content, self::SNAPSHOT_DIR . '/Language.xml');
+    }
+}