class.ilTestRandomQuestionCollectionSubsetApplicationList.php

Go to the documentation of this file.

<?php
/* Copyright (c) 1998-2013 ILIAS open source, Extended GPL, see docs/LICENSE */
 
require_once 'Modules/Test/classes/class.ilTestRandomQuestionCollectionSubsetApplication.php';
 
class ilTestRandomQuestionCollectionSubsetApplicationList implements Iterator
{
    protected $collectionSubsetApplications = array();
    
    protected $reservedQuestionCollection;
    
    public function __construct()
    {
        $this->setReservedQuestionCollection(new ilTestRandomQuestionSetQuestionCollection());
    }
    
    public function getCollectionSubsetApplication($applicantId)
    {
        if (!isset($this->collectionSubsetApplications[$applicantId])) {
            return null;
        }
        
        return $this->collectionSubsetApplications[$applicantId];
    }
    
    public function getCollectionSubsetApplications()
    {
        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()
    {
        return $this->reservedQuestionCollection;
    }
    
    public function setReservedQuestionCollection($reservedQuestionCollection)
    {
        $this->reservedQuestionCollection = $reservedQuestionCollection;
    }
    
    public function addReservedQuestion(ilTestRandomQuestionSetQuestion $reservedQuestion)
    {
        $this->getReservedQuestionCollection()->addQuestion($reservedQuestion);
    }
    
    /* @return ilTestRandomQuestionCollectionSubsetApplication */
    public function current()
    {
        return current($this->collectionSubsetApplications);
    }
    /* @return ilTestRandomQuestionCollectionSubsetApplication */
    public function next()
    {
        return next($this->collectionSubsetApplications);
    }
    /* @return string */
    public function key()
    {
        return key($this->collectionSubsetApplications);
    }
    /* @return bool */
    public function valid()
    {
        return key($this->collectionSubsetApplications) !== null;
    }
    /* @return ilTestRandomQuestionCollectionSubsetApplication */
    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()
    {
        $availableQuestionCollection = new ilTestRandomQuestionSetQuestionCollection();
        
        foreach ($this as $collectionSubsetApplication) {
            $applicationsNonReservedQstCollection = $collectionSubsetApplication->getRelativeComplementCollection(
                $this->getReservedQuestionCollection()
            );
            
            $availableQuestionCollection->mergeQuestionCollection($applicationsNonReservedQstCollection);
        }
        
        $nonReservedQuestionCollection = $availableQuestionCollection->getUniqueQuestionCollection();
        
        return $nonReservedQuestionCollection->getQuestionAmount();
    }
}