atol-online/src/Collections/EntityCollection.php

<?php
/*
 * Copyright (c) 2020-2021 Антон Аксенов (Anthony Axenov)
 *
 * This code is licensed under MIT.
 * Этот код распространяется по лицензии MIT.
 * https://github.com/anthonyaxenov/atol-online/blob/master/LICENSE
 */

declare(strict_types = 1);

namespace AtolOnline\Collections;

use AtolOnline\Exceptions\InvalidEntityInCollectionException;
use Illuminate\Support\Collection;

/**
 * Абстрактное описание коллекции любых сущностей
 */
abstract class EntityCollection extends Collection
{
    /**
     * @inheritDoc
     * @throws InvalidEntityInCollectionException
     */
    public function jsonSerialize(): array
    {
        $this->checkCount();
        $this->checkItemsClasses();
        return parent::jsonSerialize();
    }

    /**
     * Проверяет количество элементов коллекции
     *
     * @return void
     */
    public function checkCount(): void
    {
        $this->isEmpty() && throw new (static::EMPTY_EXCEPTION_CLASS)();
        $this->count() > static::MAX_COUNT && throw new (static::TOO_MANY_EXCEPTION_CLASS)(static::MAX_COUNT);
    }

    /**
     * Проверяет корректность класса элемента коллекции
     *
     * @param mixed $item
     * @return void
     * @throws InvalidEntityInCollectionException
     */
    public function checkItemClass(mixed $item): void
    {
        if (!is_object($item) || $item::class !== static::ENTITY_CLASS) {
            throw new InvalidEntityInCollectionException(static::class, static::ENTITY_CLASS, $item);
        }
    }

    /**
     * Проверяет корректность классов элементов коллекции
     *
     * @return $this
     * @throws InvalidEntityInCollectionException
     */
    public function checkItemsClasses(): self
    {
        return $this->each(fn($item) => $this->checkItemClass($item));
    }
}