ilAssQuestionUserSolutionAdopter Class Reference

Collaboration diagram for ilAssQuestionUserSolutionAdopter:

Public Member Functions
	__construct (private ilDBInterface $db, ilSetting $ass_settings)
	getUserId ()
	setUserId (int $user_id)
	getActiveId ()
	setActiveId (int $active_id)
	getTargetPass ()
	setTargetPass (int $target_pass)
	getQuestionIds ()
	setQuestionIds (array $question_ids)
	perform ()

Protected Member Functions
	adoptQuestionAnswer (int $question_id)
	resetTargetSolution (int $question_id)
	resetTargetResult (int $question_id)
	adoptSourceSolution (int $question_id)
	adoptSourceResult (int $question_id, int $source_pass)
	getPreparedDeleteSolutionRecordsStatement ()
	getPreparedSelectSolutionRecordsStatement ()
	getPreparedInsertSolutionRecordStatement ()
	getPreparedDeleteResultRecordStatement ()
	getPreparedSelectResultRecordStatement ()
	getPreparedInsertResultRecordStatement ()

Protected Attributes
int	$active_id = null
int	$target_pass = null
array	$question_ids = []

Static Protected Attributes
static ilDBStatement	$prepared_delete_solution_records_statement = null
static ilDBStatement	$prepared_select_solution_records_statement = null
static ilDBStatement	$prepared_insert_solution_record_statement = null
static ilDBStatement	$prepared_delete_result_record_statement = null
static ilDBStatement	$prepared_select_result_record_statement = null
static ilDBStatement	$prepared_insert_result_record_statement = null

Private Attributes
ilAssQuestionProcessLockerFactory	$process_locker_factory
int	$user_id = null

Detailed Description

Definition at line 27 of file class.ilAssQuestionUserSolutionAdopter.php.

Constructor & Destructor Documentation

__construct()

ilAssQuestionUserSolutionAdopter::__construct	(	private ilDBInterface	$db,
		ilSetting	$ass_settings
	)

Definition at line 46 of file class.ilAssQuestionUserSolutionAdopter.php.

      {
        $this->process_locker_factory = new ilAssQuestionProcessLockerFactory($ass_settings, $db);
    }

Member Function Documentation

adoptQuestionAnswer()

ilAssQuestionUserSolutionAdopter::adoptQuestionAnswer ( int  $question_id )

protected

Definition at line 110 of file class.ilAssQuestionUserSolutionAdopter.php.

References adoptSourceResult(), adoptSourceSolution(), null, resetTargetResult(), and resetTargetSolution().

Referenced by perform().

                                                            : void
    {
        $this->resetTargetSolution($question_id);
        $this->resetTargetResult($question_id);

        $source_pass = $this->adoptSourceSolution($question_id);

        if ($source_pass !== null) {
            $this->adoptSourceResult($question_id, $source_pass);
        }
    }

Here is the call graph for this function:

Here is the caller graph for this function:

adoptSourceResult()

ilAssQuestionUserSolutionAdopter::adoptSourceResult ( int  $question_id, int  $source_pass  )

protected

Definition at line 165 of file class.ilAssQuestionUserSolutionAdopter.php.

References $res, getActiveId(), getPreparedInsertResultRecordStatement(), getPreparedSelectResultRecordStatement(), and getTargetPass().

Referenced by adoptQuestionAnswer().

                                                                            : void
    {
        $res = $this->db->execute(
            $this->getPreparedSelectResultRecordStatement(),
            [$this->getActiveId(), $question_id, $source_pass]
        );

        $row = $this->db->fetchAssoc($res);

        $result_id = $this->db->nextId('tst_test_result');

        $this->db->execute($this->getPreparedInsertResultRecordStatement(), [
            $result_id, $this->getActiveId(), $question_id, $this->getTargetPass(), time(),
            $row['points'], $row['manual'], $row['hint_count'], $row['hint_points'], $row['answered']
        ]);
    }

Here is the call graph for this function:

Here is the caller graph for this function:

adoptSourceSolution()

ilAssQuestionUserSolutionAdopter::adoptSourceSolution ( int  $question_id )

protected

Definition at line 138 of file class.ilAssQuestionUserSolutionAdopter.php.

References $res, getActiveId(), getPreparedInsertSolutionRecordStatement(), getPreparedSelectSolutionRecordsStatement(), getTargetPass(), and null.

Referenced by adoptQuestionAnswer().

                                                            : ?int
    {
        $res = $this->db->execute(
            $this->getPreparedSelectSolutionRecordsStatement(),
            [$this->getActiveId(), $question_id, $this->getTargetPass()]
        );

        $source_pass = null;

        while ($row = $this->db->fetchAssoc($res)) {
            if ($source_pass === null) {
                $source_pass = $row['pass'];
            } elseif ($row['pass'] < $source_pass) {
                break;
            }

            $solution_id = $this->db->nextId('tst_solutions');

            $this->db->execute($this->getPreparedInsertSolutionRecordStatement(), [
                $solution_id, $this->getActiveId(), $question_id, $this->getTargetPass(), time(),
                $row['points'], $row['value1'], $row['value2']
            ]);
        }

        return $source_pass;
    }

Here is the call graph for this function:

Here is the caller graph for this function:

getActiveId()

ilAssQuestionUserSolutionAdopter::getActiveId

(

)

Definition at line 63 of file class.ilAssQuestionUserSolutionAdopter.php.

References $active_id.

Referenced by adoptSourceResult(), adoptSourceSolution(), resetTargetResult(), and resetTargetSolution().

                                 : ?int
    {
        return $this->active_id;
    }

Here is the caller graph for this function:

getPreparedDeleteResultRecordStatement()

ilAssQuestionUserSolutionAdopter::getPreparedDeleteResultRecordStatement ( )

protected

Definition at line 231 of file class.ilAssQuestionUserSolutionAdopter.php.

References null.

Referenced by resetTargetResult().

                                                               : ilDBStatement
    {
        if (self::$prepared_delete_result_record_statement === null) {
            self::$prepared_delete_result_record_statement = $this->db->prepareManip(
                "DELETE FROM tst_test_result WHERE active_fi = ? AND question_fi = ? AND pass = ?",
                ['integer', 'integer', 'integer']
            );
        }

        return self::$prepared_delete_result_record_statement;
    }

Here is the caller graph for this function:

getPreparedDeleteSolutionRecordsStatement()

ilAssQuestionUserSolutionAdopter::getPreparedDeleteSolutionRecordsStatement ( )

protected

Definition at line 182 of file class.ilAssQuestionUserSolutionAdopter.php.

References null.

Referenced by resetTargetSolution().

                                                                  : ilDBStatement
    {
        if (self::$prepared_delete_solution_records_statement === null) {
            self::$prepared_delete_solution_records_statement = $this->db->prepareManip(
                "DELETE FROM tst_solutions WHERE active_fi = ? AND question_fi = ? AND pass = ?",
                ['integer', 'integer', 'integer']
            );
        }

        return self::$prepared_delete_solution_records_statement;
    }

Here is the caller graph for this function:

getPreparedInsertResultRecordStatement()

ilAssQuestionUserSolutionAdopter::getPreparedInsertResultRecordStatement ( )

protected

Definition at line 260 of file class.ilAssQuestionUserSolutionAdopter.php.

References null.

Referenced by adoptSourceResult().

                                                               : ilDBStatement
    {
        if (self::$prepared_insert_result_record_statement === null) {
            $query = "
                                INSERT INTO tst_test_result (
                                        test_result_id, active_fi, question_fi, pass, tstamp,
                                        points, manual, hint_count, hint_points, answered
                                ) VALUES (
                                        ?, ?, ?, ?, ?, ?, ?, ?, ?, ?
                                )
                        ";

            self::$prepared_insert_result_record_statement = $this->db->prepareManip(
                $query,
                ['integer', 'integer', 'integer', 'integer', 'integer', 'integer', 'integer', 'integer', 'integer', 'integer']
            );
        }

        return self::$prepared_insert_result_record_statement;
    }

Here is the caller graph for this function:

getPreparedInsertSolutionRecordStatement()

ilAssQuestionUserSolutionAdopter::getPreparedInsertSolutionRecordStatement ( )

protected

Definition at line 211 of file class.ilAssQuestionUserSolutionAdopter.php.

References null.

Referenced by adoptSourceSolution().

                                                                 : ilDBStatement
    {
        if (self::$prepared_insert_solution_record_statement === null) {
            $query = "
                                INSERT INTO tst_solutions (
                                        solution_id, active_fi, question_fi, pass, tstamp, points, value1, value2
                                ) VALUES (
                                        ?, ?, ?, ?, ?, ?, ?, ?
                                )
                        ";

            self::$prepared_insert_solution_record_statement = $this->db->prepareManip(
                $query,
                ['integer', 'integer', 'integer', 'integer', 'integer', 'integer', 'text', 'text']
            );
        }

        return self::$prepared_insert_solution_record_statement;
    }

Here is the caller graph for this function:

getPreparedSelectResultRecordStatement()

ilAssQuestionUserSolutionAdopter::getPreparedSelectResultRecordStatement ( )

protected

Definition at line 243 of file class.ilAssQuestionUserSolutionAdopter.php.

References null.

Referenced by adoptSourceResult().

                                                               : ilDBStatement
    {
        if (self::$prepared_select_result_record_statement === null) {
            $query = "
                                SELECT points, manual, hint_count, hint_points, answered FROM tst_test_result
                                WHERE active_fi = ? AND question_fi = ? AND pass = ?
                        ";

            self::$prepared_select_result_record_statement = $this->db->prepare(
                $query,
                ['integer', 'integer', 'integer']
            );
        }

        return self::$prepared_select_result_record_statement;
    }

Here is the caller graph for this function:

getPreparedSelectSolutionRecordsStatement()

ilAssQuestionUserSolutionAdopter::getPreparedSelectSolutionRecordsStatement ( )

protected

Definition at line 194 of file class.ilAssQuestionUserSolutionAdopter.php.

References null.

Referenced by adoptSourceSolution().

                                                                  : ilDBStatement
    {
        if (self::$prepared_select_solution_records_statement === null) {
            $query = "
                                SELECT pass, points, value1, value2 FROM tst_solutions
                                WHERE active_fi = ? AND question_fi = ? AND pass < ? ORDER BY pass DESC
                        ";

            self::$prepared_select_solution_records_statement = $this->db->prepare(
                $query,
                ['integer', 'integer', 'integer']
            );
        }

        return self::$prepared_select_solution_records_statement;
    }

Here is the caller graph for this function:

getQuestionIds()

ilAssQuestionUserSolutionAdopter::getQuestionIds

(

)

Definition at line 83 of file class.ilAssQuestionUserSolutionAdopter.php.

References $question_ids.

Referenced by perform().

                                    : array
    {
        return $this->question_ids;
    }

Here is the caller graph for this function:

getTargetPass()

ilAssQuestionUserSolutionAdopter::getTargetPass

(

)

Definition at line 73 of file class.ilAssQuestionUserSolutionAdopter.php.

References $target_pass.

Referenced by adoptSourceResult(), adoptSourceSolution(), resetTargetResult(), and resetTargetSolution().

                                   : ?int
    {
        return $this->target_pass;
    }

Here is the caller graph for this function:

getUserId()

ilAssQuestionUserSolutionAdopter::getUserId

(

)

Definition at line 53 of file class.ilAssQuestionUserSolutionAdopter.php.

References $user_id.

Referenced by perform().

                               : ?int
    {
        return $this->user_id;
    }

Here is the caller graph for this function:

perform()

ilAssQuestionUserSolutionAdopter::perform

(

)

Definition at line 96 of file class.ilAssQuestionUserSolutionAdopter.php.

References adoptQuestionAnswer(), getQuestionIds(), and getUserId().

                             : void
    {
        $this->process_locker_factory->setUserId($this->getUserId());

        foreach ($this->getQuestionIds() as $question_id) {
            $this->process_locker_factory->setQuestionId($question_id);
            $processLocker = $this->process_locker_factory->getLocker();

            $processLocker->executeUserTestResultUpdateLockOperation(function () use ($question_id) {
                $this->adoptQuestionAnswer($question_id);
            });
        }
    }

Here is the call graph for this function:

resetTargetResult()

ilAssQuestionUserSolutionAdopter::resetTargetResult ( int  $question_id )

protected

Definition at line 130 of file class.ilAssQuestionUserSolutionAdopter.php.

References getActiveId(), getPreparedDeleteResultRecordStatement(), and getTargetPass().

Referenced by adoptQuestionAnswer().

                                                          : void
    {
        $this->db->execute(
            $this->getPreparedDeleteResultRecordStatement(),
            [$this->getActiveId(), $question_id, $this->getTargetPass()]
        );
    }

Here is the call graph for this function:

Here is the caller graph for this function:

resetTargetSolution()

ilAssQuestionUserSolutionAdopter::resetTargetSolution ( int  $question_id )

protected

Definition at line 122 of file class.ilAssQuestionUserSolutionAdopter.php.

References getActiveId(), getPreparedDeleteSolutionRecordsStatement(), and getTargetPass().

Referenced by adoptQuestionAnswer().

                                                            : void
    {
        $this->db->execute(
            $this->getPreparedDeleteSolutionRecordsStatement(),
            [$this->getActiveId(), $question_id, $this->getTargetPass()]
        );
    }

Here is the call graph for this function:

Here is the caller graph for this function:

setActiveId()

ilAssQuestionUserSolutionAdopter::setActiveId

(

int

$active_id

)

Definition at line 68 of file class.ilAssQuestionUserSolutionAdopter.php.

References $active_id.

                                               : void
    {
        $this->active_id = $active_id;
    }

setQuestionIds()

ilAssQuestionUserSolutionAdopter::setQuestionIds

(

array

$question_ids

)

Parameters

array<int>

$question_ids

Definition at line 91 of file class.ilAssQuestionUserSolutionAdopter.php.

References $question_ids.

                                                       : void
    {
        $this->question_ids = $question_ids;
    }

setTargetPass()

ilAssQuestionUserSolutionAdopter::setTargetPass

(

int

$target_pass

)

Definition at line 78 of file class.ilAssQuestionUserSolutionAdopter.php.

References $target_pass.

                                                   : void
    {
        $this->target_pass = $target_pass;
    }

setUserId()

ilAssQuestionUserSolutionAdopter::setUserId

(

int

$user_id

)

Definition at line 58 of file class.ilAssQuestionUserSolutionAdopter.php.

References $user_id.

                                           : void
    {
        $this->user_id = $user_id;
    }

Field Documentation

$active_id

int ilAssQuestionUserSolutionAdopter::$active_id = null

protected

Definition at line 38 of file class.ilAssQuestionUserSolutionAdopter.php.

Referenced by getActiveId(), and setActiveId().

$prepared_delete_result_record_statement

ilDBStatement ilAssQuestionUserSolutionAdopter::$prepared_delete_result_record_statement = null

staticprotected

Definition at line 32 of file class.ilAssQuestionUserSolutionAdopter.php.

$prepared_delete_solution_records_statement

ilDBStatement ilAssQuestionUserSolutionAdopter::$prepared_delete_solution_records_statement = null

staticprotected

Definition at line 29 of file class.ilAssQuestionUserSolutionAdopter.php.

$prepared_insert_result_record_statement

ilDBStatement ilAssQuestionUserSolutionAdopter::$prepared_insert_result_record_statement = null

staticprotected

Definition at line 34 of file class.ilAssQuestionUserSolutionAdopter.php.

$prepared_insert_solution_record_statement

ilDBStatement ilAssQuestionUserSolutionAdopter::$prepared_insert_solution_record_statement = null

staticprotected

Definition at line 31 of file class.ilAssQuestionUserSolutionAdopter.php.

$prepared_select_result_record_statement

ilDBStatement ilAssQuestionUserSolutionAdopter::$prepared_select_result_record_statement = null

staticprotected

Definition at line 33 of file class.ilAssQuestionUserSolutionAdopter.php.

$prepared_select_solution_records_statement

ilDBStatement ilAssQuestionUserSolutionAdopter::$prepared_select_solution_records_statement = null

staticprotected

Definition at line 30 of file class.ilAssQuestionUserSolutionAdopter.php.

$process_locker_factory

ilAssQuestionProcessLockerFactory ilAssQuestionUserSolutionAdopter::$process_locker_factory

private

Definition at line 36 of file class.ilAssQuestionUserSolutionAdopter.php.

$question_ids

array ilAssQuestionUserSolutionAdopter::$question_ids = []

protected

Definition at line 44 of file class.ilAssQuestionUserSolutionAdopter.php.

Referenced by getQuestionIds(), and setQuestionIds().

$target_pass

int ilAssQuestionUserSolutionAdopter::$target_pass = null

protected

Definition at line 39 of file class.ilAssQuestionUserSolutionAdopter.php.

Referenced by getTargetPass(), and setTargetPass().

$user_id

int ilAssQuestionUserSolutionAdopter::$user_id = null

private

Definition at line 37 of file class.ilAssQuestionUserSolutionAdopter.php.

Referenced by getUserId(), and setUserId().

---

The documentation for this class was generated from the following file:

• components/ILIAS/TestQuestionPool/classes/class.ilAssQuestionUserSolutionAdopter.php