Initial xentral_oss_20.3.c9ffacf

classes/Widgets/SuperSearch/Query/DetailQuery.php

@@ -0,0 +1,55 @@
+<?php
+
+namespace Xentral\Widgets\SuperSearch\Query;
+
+use Xentral\Widgets\SuperSearch\Exception\InvalidArgumentException;
+
+final class DetailQuery
+{
+    /** @var string $groupKey */
+    private $groupKey;
+
+    /** @var int|string $itemIdentifier */
+    private $itemIdentifier;
+
+    /**
+     * @param string     $groupKey
+     * @param int|string $itemIdentifier
+     *
+     * @throws InvalidArgumentException
+     */
+    public function __construct($groupKey, $itemIdentifier)
+    {
+        $groupKeyCleaned = (string)preg_replace('#[^a-z_]#', '', $groupKey);
+        if ($groupKey !== $groupKeyCleaned) {
+            throw new InvalidArgumentException(
+                'Invalid characters in $groupKey. Allowed characters: a-z and underscore.'
+            );
+        }
+        if (!is_int($itemIdentifier) && !is_string($itemIdentifier)) {
+            throw new InvalidArgumentException(sprintf(
+                'Invalid argument type for $itemIdentifier. Only integer or string is allowed. Type given: %s.',
+                gettype($itemIdentifier)
+            ));
+        }
+
+        $this->groupKey = (string)$groupKey;
+        $this->itemIdentifier = $itemIdentifier;
+    }
+
+    /**
+     * @return string
+     */
+    public function getGroupKey()
+    {
+        return $this->groupKey;
+    }
+
+    /**
+     * @return int|string
+     */
+    public function getItemIdentifier()
+    {
+        return $this->itemIdentifier;
+    }
+}

classes/Widgets/SuperSearch/Query/SearchQuery.php

@@ -0,0 +1,48 @@
+<?php
+
+namespace Xentral\Widgets\SuperSearch\Query;
+
+use Xentral\Widgets\SuperSearch\Exception\InvalidArgumentException;
+
+final class SearchQuery
+{
+    /** @var string $searchTerm */
+    private $searchTerm;
+
+    /** @var array $searchWords */
+    private $searchWords = null;
+
+    /**
+     * @param string $searchTerm
+     *
+     * @throws InvalidArgumentException
+     */
+    public function __construct($searchTerm)
+    {
+        if (empty($searchTerm)) {
+            throw new InvalidArgumentException('Parameter "searchTerm" is empty.');
+        }
+
+        $this->searchTerm = trim($searchTerm);
+    }
+
+    /**
+     * @return string
+     */
+    public function getSearchTerm()
+    {
+        return $this->searchTerm;
+    }
+
+    /**
+     * @return array
+     */
+    public function getSearchWords()
+    {
+        if ($this->searchWords === null) {
+            $this->searchWords = (array)preg_split('/([\s]+)/um', $this->searchTerm, -1, PREG_SPLIT_NO_EMPTY);
+        }
+
+        return $this->searchWords;
+    }
+}