class.ilTestRandomQuestionCollectionSubsetApplicationList.php

Go to the documentation of this file.

<?php

declare(strict_types=1);

class ilTestRandomQuestionCollectionSubsetApplicationList implements Iterator
{
    protected array $collectionSubsetApplications = [];
    protected ilTestRandomQuestionSetQuestionCollection $reservedQuestionCollection;

    public function __construct()
    {
        $this->setReservedQuestionCollection(new ilTestRandomQuestionSetQuestionCollection());
    }

    public function getCollectionSubsetApplication($applicantId): ?ilTestRandomQuestionCollectionSubsetApplication
    {
        return $this->collectionSubsetApplications[$applicantId] ?? null;
    }

    public function getCollectionSubsetApplications(): array
    {
        return $this->collectionSubsetApplications;
    }

    public function addCollectionSubsetApplication(
        ilTestRandomQuestionCollectionSubsetApplication $collectionSubsetApplication
    ): void {
        $this->collectionSubsetApplications[$collectionSubsetApplication->getApplicantId()] = $collectionSubsetApplication;
    }

    public function setCollectionSubsetApplications(array $collectionSubsetApplications): void
    {
        $this->collectionSubsetApplications = $collectionSubsetApplications;
    }

    public function resetCollectionSubsetApplicants(): void
    {
        $this->setCollectionSubsetApplications([]);
    }

    public function getReservedQuestionCollection(): ilTestRandomQuestionSetQuestionCollection
    {
        return $this->reservedQuestionCollection;
    }

    public function setReservedQuestionCollection(
        ilTestRandomQuestionSetQuestionCollection $reservedQuestionCollection
    ): void {
        $this->reservedQuestionCollection = $reservedQuestionCollection;
    }

    public function addReservedQuestion(ilTestRandomQuestionSetQuestion $reservedQuestion): void
    {
        $this->getReservedQuestionCollection()->addQuestion($reservedQuestion);
    }

    public function current(): ilTestRandomQuestionCollectionSubsetApplication
    {
        return current($this->collectionSubsetApplications);
    }

    public function next(): void
    {
        next($this->collectionSubsetApplications);
    }

    public function key(): int
    {
        return key($this->collectionSubsetApplications);
    }

    public function valid(): bool
    {
        return key($this->collectionSubsetApplications) !== null;
    }

    public function rewind(): void
    {
        reset($this->collectionSubsetApplications);
    }

    public function handleQuestionRequest(ilTestRandomQuestionSetQuestion $question): void
    {
        $questionReservationRequired = false;

        foreach ($this as $collectionSubsetApplication) {
            if (!$collectionSubsetApplication->hasQuestion($question->getQuestionId())) {
                continue;
            }

            if ($collectionSubsetApplication->hasRequiredAmountLeft()) {
                $questionReservationRequired = true;
                $collectionSubsetApplication->decrementRequiredAmount();
            }
        }

        if ($questionReservationRequired) {
            $this->addReservedQuestion($question);
        }
    }

    public function getNonReservedQuestionAmount(): int
    {
        $availableQuestionCollection = new ilTestRandomQuestionSetQuestionCollection();

        foreach ($this as $collectionSubsetApplication) {
            $applicationsNonReservedQstCollection = $collectionSubsetApplication->getRelativeComplementCollection(
                $this->getReservedQuestionCollection()
            );

            $availableQuestionCollection->mergeQuestionCollection($applicationsNonReservedQstCollection);
        }

        $nonReservedQuestionCollection = $availableQuestionCollection->getUniqueQuestionCollection();

        return $nonReservedQuestionCollection->getQuestionAmount();
    }
}