IBX-7418: Added input parser for ContentName criterion (#82)

For more details see https://issues.ibexa.co/browse/IBX-7418 and #82

Key changes:

* Implemented input parser for ContentName criterion (ibexa/core#312)

* [Tests] Added functional tests coverage

Author: ciastektk

src/bundle/Resources/config/input_parsers.yml

@@ -494,6 +494,13 @@ services:
         tags:
             - { name: ibexa.rest.input.parser, mediaType: application/vnd.ibexa.api.internal.criterion.Sibling }
 
+    Ibexa\Rest\Server\Input\Parser\Criterion\ContentName:
+        parent: Ibexa\Rest\Server\Common\Parser
+        arguments:
+            $validator: '@validator'
+        tags:
+            - { name: ibexa.rest.input.parser, mediaType: application/vnd.ibexa.api.internal.criterion.ContentName }
+
     ibexa.rest.input.parser.internal.sortclause.content_id:
         parent: Ibexa\Rest\Server\Common\Parser
         class: Ibexa\Rest\Server\Input\Parser\SortClause\DataKeyValueObjectClass

src/lib/Server/Input/Parser/Criterion/ContentName.php

@@ -0,0 +1,57 @@
+<?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\Input\Parser\Criterion;
+
+use Ibexa\Contracts\Core\Repository\Values\Content\Query\Criterion\ContentName as ContentNameCriterion;
+use Ibexa\Contracts\Rest\Input\ParsingDispatcher;
+use Ibexa\Rest\Input\BaseParser;
+use Ibexa\Rest\Server\Exceptions\ValidationFailedException;
+use Ibexa\Rest\Server\Validation\Builder\Input\Parser\Criterion\ContentNameValidatorBuilder;
+use Symfony\Component\Validator\Validator\ValidatorInterface;
+
+final class ContentName extends BaseParser
+{
+    public const CONTENT_NAME_CRITERION = 'ContentNameCriterion';
+
+    private ValidatorInterface $validator;
+
+    public function __construct(ValidatorInterface $validator)
+    {
+        $this->validator = $validator;
+    }
+
+    /**
+     * @param array<mixed> $data
+     */
+    public function parse(array $data, ParsingDispatcher $parsingDispatcher): ContentNameCriterion
+    {
+        $this->validateInputArray($data);
+
+        $criterionData = $data[self::CONTENT_NAME_CRITERION];
+
+        return new ContentNameCriterion($criterionData);
+    }
+
+    /**
+     * @param array<mixed> $data
+     */
+    private function validateInputArray(array $data): void
+    {
+        $validatorBuilder = new ContentNameValidatorBuilder($this->validator);
+        $validatorBuilder->validateInputArray($data);
+        $violations = $validatorBuilder->build()->getViolations();
+
+        if ($violations->count() > 0) {
+            throw new ValidationFailedException(
+                self::CONTENT_NAME_CRITERION,
+                $violations
+            );
+        }
+    }
+}

src/lib/Server/Validation/Builder/Input/Parser/Criterion/ContentNameValidatorBuilder.php

@@ -0,0 +1,28 @@
+<?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\Validation\Builder\Input\Parser\Criterion;
+
+use Ibexa\Rest\Server\Input\Parser\Criterion\ContentName;
+use Ibexa\Rest\Server\Validation\Builder\Input\Parser\BaseInputParserCollectionValidatorBuilder;
+use Symfony\Component\Validator\Constraints as Assert;
+
+final class ContentNameValidatorBuilder extends BaseInputParserCollectionValidatorBuilder
+{
+    protected function getCollectionConstraints(): array
+    {
+        return [
+            ContentName::CONTENT_NAME_CRITERION => new Assert\Required(
+                [
+                    new Assert\Type('string'),
+                    new Assert\NotBlank(),
+                ]
+            ),
+        ];
+    }
+}

tests/bundle/Functional/SearchView/Criterion/ContentNameTest.php

@@ -0,0 +1,47 @@
+<?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\SearchView\Criterion;
+
+use Ibexa\Tests\Bundle\Rest\Functional\SearchView\SearchCriterionTestCase;
+
+/**
+ * @covers \Ibexa\Rest\Server\Input\Parser\Criterion\ContentName
+ */
+final class ContentNameTest extends SearchCriterionTestCase
+{
+    protected function setUp(): void
+    {
+        parent::setUp();
+
+        $this->createFolder('foo', '/api/ibexa/v2/content/locations/1/2');
+        $this->createFolder('foobar', '/api/ibexa/v2/content/locations/1/2');
+    }
+
+    /**
+     * @return iterable<array{
+     *     string,
+     *     string,
+     *     int,
+     * }>
+     */
+    public function getCriteriaPayloads(): iterable
+    {
+        yield 'Return content items that contain "foo" in name' => [
+            'json',
+            $this->buildJsonCriterionQuery('"ContentNameCriterion": "foo*"'),
+            2,
+        ];
+
+        yield 'No content items found with article in name' => [
+            'json',
+            $this->buildJsonCriterionQuery('"ContentNameCriterion": "*article*"'),
+            0,
+        ];
+    }
+}