IBX-8597: Added BaseSortClauseProcessor

https://issues.ibexa.co/browse/IBX-8597

src/bundle/Resources/config/services.yml

@@ -395,3 +395,8 @@ services:
         abstract: true
         arguments:
             $parsingDispatcher: '@Ibexa\Contracts\Rest\Input\ParsingDispatcher'
+
+    Ibexa\Contracts\Rest\Input\Parser\Query\SortClause\BaseSortClauseProcessor:
+        abstract: true
+        arguments:
+            $parsingDispatcher: '@Ibexa\Contracts\Rest\Input\ParsingDispatcher'

src/contracts/Input/Parser/Query/SortClause/BaseSortClauseProcessor.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.
+ */
+namespace Ibexa\Contracts\Rest\Input\Parser\Query\SortClause;
+
+use Ibexa\Contracts\Rest\Exceptions;
+use Ibexa\Contracts\Rest\Input\ParsingDispatcher;
+use Traversable;
+
+/**
+ * @template TSortClause
+ *
+ * @internal
+ */
+abstract class BaseSortClauseProcessor implements SortClauseProcessorInterface
+{
+    private ParsingDispatcher $parsingDispatcher;
+
+    public function __construct(ParsingDispatcher $parsingDispatcher)
+    {
+        $this->parsingDispatcher = $parsingDispatcher;
+    }
+
+    public function processSortClauses(array $sortClauseData): Traversable
+    {
+        if (empty($sortClauseData)) {
+            yield from [];
+        }
+
+        foreach ($sortClauseData as $sortClauseName => $direction) {
+            $mediaType = $this->getSortClauseMediaType($sortClauseName);
+
+            try {
+                yield $this->parsingDispatcher->parse([$sortClauseName => $direction], $mediaType);
+            } catch (Exceptions\Parser $e) {
+                throw new Exceptions\Parser($this->getParserInvalidSortClauseMessage($sortClauseName), 0, $e);
+            }
+        }
+    }
+
+    private function getSortClauseMediaType(string $sortClauseName): string
+    {
+        $mediaTypePrefix = $this->getMediaTypePrefix();
+        if ('.' !== substr($mediaTypePrefix, strlen($mediaTypePrefix) - 1)) {
+            $mediaTypePrefix .= '.';
+        }
+
+        return $mediaTypePrefix . $sortClauseName;
+    }
+
+    abstract protected function getMediaTypePrefix(): string;
+
+    abstract protected function getParserInvalidSortClauseMessage(string $sortClauseName): string;
+}

src/contracts/Input/Parser/Query/SortClause/SortClauseProcessorInterface.php

@@ -0,0 +1,24 @@
+<?php
+
+/**
+ * @copyright Copyright (C) Ibexa AS. All rights reserved.
+ * @license For full copyright and license information view LICENSE file distributed with this source code.
+ */
+namespace Ibexa\Contracts\Rest\Input\Parser\Query\SortClause;
+
+use Traversable;
+
+/**
+ * @template TSortClause
+ *
+ * @internal
+ */
+interface SortClauseProcessorInterface
+{
+    /**
+     * @param array<string, string> $sortClauseData
+     *
+     * @return \Traversable<TSortClause>
+     */
+    public function processSortClauses(array $sortClauseData): Traversable;
+}