class.ilTestRandomQuestionCollectionSubsetApplicationList.php

Go to the documentation of this file.

<?php

class ilTestRandomQuestionCollectionSubsetApplicationList implements Iterator
{
    protected $collectionSubsetApplications = array();

    protected $reservedQuestionCollection;

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

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

        return $this->collectionSubsetApplications[$applicantId];
    }

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

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

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

    public function resetCollectionSubsetApplicants()
    {
        $this->setCollectionSubsetApplications(array());
    }

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

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

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

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

    public function next()
    {
        return next($this->collectionSubsetApplications);
    }
    /* @return string */
    public function key(): string
    {
        return key($this->collectionSubsetApplications);
    }
    /* @return bool */
    public function valid(): bool
    {
        return key($this->collectionSubsetApplications) !== null;
    }
    public function rewind()
    {
        return reset($this->collectionSubsetApplications);
    }

    public function handleQuestionRequest(ilTestRandomQuestionSetQuestion $question)
    {
        $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();
    }
}