KeysetPaginator::getValue() - Code Metrics - Inspection of "Update psalm annotations (#50)" - yiisoft/data - Measure and Improve Code Quality continuously with Scrutinizer

Passed
Push — master ( 9472d4...d4d87b )

by Alexander
created 2020-10-26 15:51 UTC
KeysetPaginator::getValue() A

↳ Parent: KeysetPaginator
Complexity

Conditions	2
Paths	2
Size

Total Lines	3
Code Lines	1
Duplication

Lines	0
Ratio	0 %
Code Coverage

Tests	2
CRAP Score	2
Importance

Changes
Metric	Value
cc	2
eloc	1
nc	2
nop	0
dl	0
loc	3
ccs	2
cts	2
cp	1
crap	2
rs	10
c	0
b	0
f	0
<?php

declare(strict_types=1);

namespace Yiisoft\Data\Paginator;

use Yiisoft\Arrays\ArrayHelper;
use Yiisoft\Data\Reader\Filter\CompareFilter;
use Yiisoft\Data\Reader\Filter\GreaterThan;
use Yiisoft\Data\Reader\Filter\GreaterThanOrEqual;
use Yiisoft\Data\Reader\Filter\LessThan;
use Yiisoft\Data\Reader\Filter\LessThanOrEqual;
use Yiisoft\Data\Reader\FilterableDataInterface;
use Yiisoft\Data\Reader\ReadableDataInterface;
use Yiisoft\Data\Reader\Sort;
use Yiisoft\Data\Reader\SortableDataInterface;

/**
 * Keyset paginator
 *
 * - Equally fast for 1st and 1000nd page
 * - Total number of pages is not available
 * - Cannot get to specific page, only "next" and "previous"
 *
 * @link https://use-the-index-luke.com/no-offset
 *
 * @template TKey as array-key
 * @template TValue
 *
 * @implements PaginatorInterface<TKey, TValue>
 */
class KeysetPaginator implements PaginatorInterface
{
    /**
     * @var FilterableDataInterface|ReadableDataInterface|SortableDataInterface
     */
    private ReadableDataInterface $dataReader;
    private int $pageSize = self::DEFAULT_PAGE_SIZE;
    private ?string $firstValue = null;
    private ?string $lastValue = null;
    private $currentFirstValue;
    private $currentLastValue;

    /**
     * @var bool Previous page has item indicator.
     */
    private bool $hasPreviousPageItem = false;
    /**
     * @var bool Next page has item indicator.
     */
    private bool $hasNextPageItem = false;

    /**
     * Reader cache against repeated scans.
     * See more {@see __clone()} and {@see initializeInternal()}.
     *
     * @psalm-var array<TKey, TValue>|null
     */
    private ?array $readCache = null;

    /**
     * @psalm-param ReadableDataInterface<TKey, TValue> $dataReader
     */
    public function __construct(ReadableDataInterface $dataReader)
    {
        if (!$dataReader instanceof FilterableDataInterface) {
            throw new \InvalidArgumentException(
                'Data reader should implement FilterableDataInterface to be used with keyset paginator.'
            );
        }

        if (!$dataReader instanceof SortableDataInterface) {
            throw new \InvalidArgumentException(
                'Data reader should implement SortableDataInterface to be used with keyset paginator.'
            );
        }

        if ($dataReader->getSort() === null) {
            throw new \RuntimeException('Data sorting should be configured to work with keyset pagination.');
        }

        if ($dataReader->getSort()->getOrder() === []) {
            throw new \RuntimeException('Data should be always sorted to work with keyset pagination.');
        }

        $this->dataReader = $dataReader;
    }

    /**
     * Reads items of the page
     *
     * This method uses the read cache to prevent duplicate reads from the data source. See more {@see resetInternal()}
     */
    public function read(): iterable
    {
        if ($this->readCache !== null) {
            return $this->readCache;
        }

        $dataReader = $this->dataReader->withLimit($this->pageSize + 1);
        $sort = $this->dataReader->getSort();
        $sort = $this->dataReader->getSort();

        if ($this->isGoingToPreviousPage()) {
            $sort = $this->reverseSort($sort);
            $dataReader = $dataReader->withSort($sort);
            $dataReader = $dataReader->withSort($sort);
        }

        if ($this->isGoingSomewhere()) {
            $dataReader = $dataReader->withFilter($this->getFilter($sort));
            $this->hasPreviousPageItem = $this->previousPageExist($dataReader, $sort);
        }

        $data = $this->readData($dataReader, $sort);
        if ($this->isGoingToPreviousPage()) {
            $data = $this->reverseData($data);
        }

        /** @psalm-var array<TKey, TValue> $data */
        return $this->readCache = $data;
    }

    /**
     * @return $this
     *
     * @psalm-mutation-free
     */
    public function withPreviousPageToken(?string $value): self
    {
        $new = clone $this;
        $new->firstValue = $value;
        $new->lastValue = null;
        return $new;
    }

    /**
     * @return $this
     *
     * @psalm-mutation-free
     */
    public function withNextPageToken(?string $value): self
    {
        $new = clone $this;
        $new->firstValue = null;
        $new->lastValue = $value;
        return $new;
    }

    public function getPreviousPageToken(): ?string
    {
        if ($this->isOnFirstPage()) {
            return null;
        }
        return (string)$this->currentFirstValue;
    }

    public function getNextPageToken(): ?string
    {
        if ($this->isOnLastPage()) {
            return null;
        }
        return (string)$this->currentLastValue;
    }

    /**
     * @return $this
     *
     * @psalm-mutation-free
     */
    public function withPageSize(int $pageSize): self
    {
        if ($pageSize < 1) {
            throw new \InvalidArgumentException('Page size should be at least 1.');
        }

        $new = clone $this;
        $new->pageSize = $pageSize;
        return $new;
    }

    public function isOnLastPage(): bool
    {
        $this->initializeInternal();
        return !$this->hasNextPageItem;
    }

    public function isOnFirstPage(): bool
    {
        if ($this->lastValue === null && $this->firstValue === null) {
            return true;
        }
        $this->initializeInternal();
        return !$this->hasPreviousPageItem;
    }

    public function getPageSize(): int
    {
        return $this->pageSize;
    }

    public function getCurrentPageSize(): int
    {
        $this->initializeInternal();
        return count($this->readCache);
    }

    public function __clone()
    {
        $this->readCache = null;
        $this->hasPreviousPageItem = false;
        $this->hasNextPageItem = false;
        $this->currentFirstValue = null;
        $this->currentLastValue = null;
    }

    protected function initializeInternal(): void
    {
        if ($this->readCache !== null) {
            return;
        }
        $cache = [];
        foreach ($this->read() as $key => $value) {
            $cache[$key] = $value;
        }
        $this->readCache = $cache;
    }

    public function isRequired(): bool
    {
        return !$this->isOnFirstPage() || !$this->isOnLastPage();
    }

    private function isGoingToPreviousPage(): bool
    {
        return $this->firstValue !== null && $this->lastValue === null;
    }

    private function isGoingSomewhere(): bool
    {
        return $this->firstValue !== null || $this->lastValue !== null;
    }

    private function getFilter(Sort $sort): CompareFilter
    {
        [$field, $sorting] = $this->getFieldAndSortingFromSort($sort);
        if ($sorting === 'asc') {
            return new GreaterThan($field, $this->getValue());
        }
        return new LessThan($field, $this->getValue());
    }

    private function getReverseFilter(Sort $sort): CompareFilter
    {
        [$field, $sorting] = $this->getFieldAndSortingFromSort($sort);
        if ($sorting === 'asc') {
            return new LessThanOrEqual($field, $this->getValue());
        }
        return new GreaterThanOrEqual($field, $this->getValue());
    }

    private function getValue(): string
    {
        return $this->isGoingToPreviousPage() ? $this->firstValue : $this->lastValue;

    }

    private function reverseSort(Sort $sort): Sort
    {
        $order = $sort->getOrder();
        foreach ($order as &$sorting) {
            $sorting = $sorting === 'asc' ? 'desc' : 'asc';
        }

        return $sort->withOrder($order);
    }

    private function getFieldAndSortingFromSort(Sort $sort): array
    {
        $order = $sort->getOrder();

        return [
            key($order),
            reset($order),
        ];
    }

    /**
     * @psalm-param ReadableDataInterface<TKey, TValue> $dataReader
     * @psalm-return array<TKey, TValue>
     */
    private function readData(ReadableDataInterface $dataReader, Sort $sort): array
    {
        $data = [];
        [$field] = $this->getFieldAndSortingFromSort($sort);

        foreach ($dataReader->read() as $key => $item) {
            if ($this->currentFirstValue === null) {
                $this->currentFirstValue = $this->getValueFromItem($item, $field);
            }
            if (count($data) === $this->pageSize) {
                $this->hasNextPageItem = true;
            } else {
                $this->currentLastValue = $this->getValueFromItem($item, $field);
                $data[$key] = $item;
            }
        }

        return $data;
    }

    /**
     * @psalm-param array<TKey, TValue>
     * @psalm-return array<TKey, TValue>
     */
    private function reverseData(array $data): array
    {
        [$this->currentFirstValue, $this->currentLastValue] = [$this->currentLastValue, $this->currentFirstValue];
        [$this->hasPreviousPageItem, $this->hasNextPageItem] = [$this->hasNextPageItem, $this->hasPreviousPageItem];
        return array_reverse($data, true);
    }

    private function previousPageExist(ReadableDataInterface $dataReader, Sort $sort): bool
    {
        $reverseFilter = $this->getReverseFilter($sort);
        foreach ($dataReader->withFilter($reverseFilter)->withLimit(1)->read() as $void) {
        foreach ($dataReader->/** @scrutinizer ignore-call */ withFilter($reverseFilter)->withLimit(1)->read() as $void) {
            return true;
        }
        return false;
    }

    private function getValueFromItem($item, string $field)
    {
        $methodName = 'get' . ucfirst($field);
        if (is_object($item) && is_callable([$item, $methodName])) {
            return $item->$methodName();
        }

        return ArrayHelper::getValue($item, $field);
    }
}

yiisoft / data

Push — master ( 9472d4...d4d87b )

KeysetPaginator::getValue() A

Complexity

Size

Duplication

Code Coverage

Importance

Duplication Side-by-Side

Filter issues like
