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();
    }
}