net.mumie.mathletfactory.util.exercise.mc

Class MCExerciseResult

java.lang.Object

net.mumie.mathletfactory.util.exercise.mc.MCExerciseResult

public class MCExerciseResult
extends java.lang.Object

This class stores the result of an exercise correction and may include answers, solutions, explanations and a score. This class acts as a bridge between the correction process and the illustration of its results.

Author:

gronau

Document status:

finished

Field Summary

Fields

Modifier and Type	Field and Description
static int	QUESTION_FULLY_CORRECT
static int	QUESTION_NOT_EDITED
static int	QUESTION_PARTIALLY_CORRECT
static int	QUESTION_TOTALLY_WRONG

Constructor Summary

Constructors

Constructor and Description
MCExerciseResult()

Method Summary

Methods

Modifier and Type	Method and Description
void	addAnswer(MathMLSerializable answer) Adds a MathML capable object as an answer to this exercise.
void	addAnswer(MathMLSerializable[] answerParts) Adds a list of MathML capable objects as an answer to this exercise.
void	addAnswer(MathMLSerializable[] preLabel, MathMLSerializable answer) Adds a MathML capable object and a preceding text as an answer to this exercise.
void	addAnswer(MathMLSerializable[] preLabel, MathMLSerializable answer, MathMLSerializable[] postLabel) Adds a MathML capable object, a preceding and a following text as an answer to this exercise.
void	addAnswer(java.lang.String answer) Adds an answer text to this exercise result.
void	addAnswer(java.lang.String preLabel, MathMLSerializable answer) Adds a MathML capable object and a preceding text as an answer to this exercise.
void	addAnswer(java.lang.String preLabel, MathMLSerializable[] answers) Adds a list of MathML capable objects and a preceding text as an answer to this exercise.
void	addAnswer(java.lang.String preLabel, MathMLSerializable[] answers, java.lang.String postLabel) Adds a list of MathML capable objects, a preceding and a closing text as an answer to this exercise.
void	addAnswer(java.lang.String preLabel, MathMLSerializable answer, java.lang.String postLabel) Adds a MathML capable object, a preceding and a closing text as an answer to this exercise.
void	addExplanation(MathMLSerializable explanation) Adds a MathML capable object as an explanation to this exercise result.
void	addExplanation(MathMLSerializable[] explanationParts) Adds a list of MathML capable objects as an explanation to this exercise result.
void	addExplanation(java.lang.String explanation) Adds an explanation text to this exercise result.
void	addExplanation(java.lang.String preLabel, MathMLSerializable explanation) Adds a MathML capable object and a preceding text as an explanation to this exercise result.
void	addExplanation(java.lang.String preLabel, MathMLSerializable[] explanations) Adds a list of MathML capable objects and a preceding text as an explanation to this exercise result.
void	addExplanation(java.lang.String preLabel, MathMLSerializable[] explanations, java.lang.String postLabel) Adds a list of MathML capable objects, a preceding and closing text as an explanation to this exercise result.
void	addExplanation(java.lang.String preLabel, MathMLSerializable explanation, java.lang.String postLabel) Adds a MathML capable object, a preceding and closing text as an explanation to this exercise result.
void	addSolution(MathMLSerializable solution) Adds a MathML capable object as a solution to this exercise result.
void	addSolution(MathMLSerializable[] solutionParts) Adds a list of MathML capable objects as a solution to this exercise result.
void	addSolution(MathMLSerializable[] preLabel, MathMLSerializable solution) Adds a list of MathML capable objects and a preceding text as a solution to this exercise result.
void	addSolution(MathMLSerializable[] preLabel, MathMLSerializable solution, MathMLSerializable[] postLabel) Adds a list of MathML capable objects, a preceding and following text as a solution to this exercise result.
void	addSolution(java.lang.String solution) Adds a solution text to this exercise result.
void	addSolution(java.lang.String preLabel, MathMLSerializable solution) Adds a MathML capable object and a preceding text as a solution to this exercise result.
void	addSolution(java.lang.String preLabel, MathMLSerializable[] solutions) Adds a list of MathML capable objects and a preceding text as a solution to this exercise result.
void	addSolution(java.lang.String preLabel, MathMLSerializable[] solutions, java.lang.String postLabel) Adds a list of MathML capable objects, a preceding and closing text as a solution to this exercise result.
void	addSolution(java.lang.String preLabel, MathMLSerializable solution, java.lang.String postLabel) Adds a MathML capable object, a preceding and closing text as a solution to this exercise result.
void	addSubResult(MCExerciseResult answer)
void	addTask(MathMLSerializable[] taskParts) Adds a list of MathML capable objects as a task to this exercise.
void	addTask(java.lang.String task) Adds a task text to this exercise result.
void	addToScore(double amount) Adds the given amount to the score of this exercise result.
MathMLSerializable[][]	getAnswers() Returns a list of all answers to this exercise where each entry consists of a list of MathML capable objects per row.
MathMLSerializable[][]	getExplanations() Returns a list of all explanations to this exercise where each entry consists of a list of MathML capable objects per row.
int	getQuestionCorrection() Returns a constant describing the score literarily.
double	getScore() Returns the score of this exercise result.
MathMLSerializable[][]	getSolutions() Returns a list of all solutions to this exercise where each entry consists of a list of MathML capable objects per row.
MathMLSerializable[][]	getTask() Returns a list of the task for this exercise where each entry consists of a list of MathML capable objects per row.
boolean	isConditionallyCorrected()
boolean	isFullScore() Returns if the given amount of points is the maximum score.
void	setConditionallyCorrected(boolean conditionallyCorrected)
void	setFullScore(double val)
void	setScore(double score) Sets the score for this exercise result.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

QUESTION_NOT_EDITED

public static final int QUESTION_NOT_EDITED

See Also:

Constant Field Values

QUESTION_FULLY_CORRECT

public static final int QUESTION_FULLY_CORRECT

See Also:

Constant Field Values

QUESTION_PARTIALLY_CORRECT

public static final int QUESTION_PARTIALLY_CORRECT

See Also:

Constant Field Values

QUESTION_TOTALLY_WRONG

public static final int QUESTION_TOTALLY_WRONG

See Also:

Constant Field Values

Constructor Detail

MCExerciseResult

public MCExerciseResult()

Method Detail

getQuestionCorrection

public int getQuestionCorrection()

Returns a constant describing the score literarily.

Returns:

See Also:

QUESTION_FULLY_CORRECT, QUESTION_PARTIALLY_CORRECT, QUESTION_TOTALLY_WRONG, QUESTION_NOT_EDITED

addSubResult

public void addSubResult(MCExerciseResult answer)

addTask

public void addTask(java.lang.String task)

Adds a task text to this exercise result.

Parameters:

task - a text

addTask

public void addTask(MathMLSerializable[] taskParts)

Adds a list of MathML capable objects as a task to this exercise.

Parameters:

taskParts - a list of MathML capable objects

getTask

public MathMLSerializable[][] getTask()

Returns a list of the task for this exercise where each entry consists of a list of MathML capable objects per row.

addAnswer

public void addAnswer(java.lang.String answer)

Adds an answer text to this exercise result.

Parameters:

answer - a text

addAnswer

public void addAnswer(MathMLSerializable answer)

Adds a MathML capable object as an answer to this exercise.

Parameters:

answer - a MathML capable object

addAnswer

public void addAnswer(MathMLSerializable[] preLabel,
             MathMLSerializable answer)

Adds a MathML capable object and a preceding text as an answer to this exercise.

Parameters:

preLabel - a preceding text as MathML objects

answer - a MathML capable object

addAnswer

public void addAnswer(MathMLSerializable[] preLabel,
             MathMLSerializable answer,
             MathMLSerializable[] postLabel)

Adds a MathML capable object, a preceding and a following text as an answer to this exercise.

Parameters:

preLabel - a preceding text as MathML objects

postLabel - a following text as MathML objects

answer - a MathML capable object

addAnswer

public void addAnswer(java.lang.String preLabel,
             MathMLSerializable answer)

Adds a MathML capable object and a preceding text as an answer to this exercise.

Parameters:

preLabel - a preceding text

answer - a MathML capable object

addAnswer

public void addAnswer(java.lang.String preLabel,
             MathMLSerializable[] answers)

Adds a list of MathML capable objects and a preceding text as an answer to this exercise.

Parameters:

preLabel - a preceding text

answers - a list of MathML capable objects

addAnswer

public void addAnswer(java.lang.String preLabel,
             MathMLSerializable[] answers,
             java.lang.String postLabel)

Adds a list of MathML capable objects, a preceding and a closing text as an answer to this exercise.

Parameters:

preLabel - a preceding text

answers - a list of MathML capable objects

postLabel - a closing text

addAnswer

public void addAnswer(java.lang.String preLabel,
             MathMLSerializable answer,
             java.lang.String postLabel)

Adds a MathML capable object, a preceding and a closing text as an answer to this exercise.

Parameters:

preLabel - a preceding text

answer - a MathML capable object

postLabel - a closing text

addAnswer

public void addAnswer(MathMLSerializable[] answerParts)

Adds a list of MathML capable objects as an answer to this exercise.

Parameters:

answerParts - a list of MathML capable objects

getAnswers

public MathMLSerializable[][] getAnswers()

Returns a list of all answers to this exercise where each entry consists of a list of MathML capable objects per row.

addSolution

public void addSolution(java.lang.String solution)

Adds a solution text to this exercise result.

Parameters:

solution - a text

addSolution

public void addSolution(MathMLSerializable solution)

Adds a MathML capable object as a solution to this exercise result.

Parameters:

solution - a MathML capable object

addSolution

public void addSolution(java.lang.String preLabel,
               MathMLSerializable solution)

Adds a MathML capable object and a preceding text as a solution to this exercise result.

Parameters:

preLabel - a preceding text

solution - a MathML capable object

addSolution

public void addSolution(MathMLSerializable[] preLabel,
               MathMLSerializable solution)

Adds a list of MathML capable objects and a preceding text as a solution to this exercise result.

Parameters:

preLabel - a preceding text as MathML objects

solutions - a list of MathML capable objects

addSolution

public void addSolution(MathMLSerializable[] preLabel,
               MathMLSerializable solution,
               MathMLSerializable[] postLabel)

Adds a list of MathML capable objects, a preceding and following text as a solution to this exercise result.

Parameters:

preLabel - a preceding text as MathML objects

postLabel - a following text as MathML objects

solutions - a list of MathML capable objects

addSolution

public void addSolution(java.lang.String preLabel,
               MathMLSerializable[] solutions)

Adds a list of MathML capable objects and a preceding text as a solution to this exercise result.

Parameters:

preLabel - a preceding text

solutions - a list of MathML capable objects

addSolution

public void addSolution(java.lang.String preLabel,
               MathMLSerializable[] solutions,
               java.lang.String postLabel)

Adds a list of MathML capable objects, a preceding and closing text as a solution to this exercise result.

Parameters:

preLabel - a preceding text

solutions - a list of MathML capable objects

postLabel - a closing text

addSolution

public void addSolution(java.lang.String preLabel,
               MathMLSerializable solution,
               java.lang.String postLabel)

Adds a MathML capable object, a preceding and closing text as a solution to this exercise result.

Parameters:

preLabel - a preceding text

solution - a list of MathML capable object

postLabel - a closing text

addSolution

public void addSolution(MathMLSerializable[] solutionParts)

Adds a list of MathML capable objects as a solution to this exercise result.

Parameters:

solutionParts - a list of MathML capable objects

getSolutions

public MathMLSerializable[][] getSolutions()

Returns a list of all solutions to this exercise where each entry consists of a list of MathML capable objects per row.

addExplanation

public void addExplanation(java.lang.String explanation)

Adds an explanation text to this exercise result.

Parameters:

explanation - a text

addExplanation

public void addExplanation(MathMLSerializable explanation)

Adds a MathML capable object as an explanation to this exercise result.

Parameters:

explanation - a MathML capable object

addExplanation

public void addExplanation(java.lang.String preLabel,
                  MathMLSerializable explanation)

Adds a MathML capable object and a preceding text as an explanation to this exercise result.

Parameters:

preLabel - a preceding text

explanation - a MathML capable object

addExplanation

public void addExplanation(java.lang.String preLabel,
                  MathMLSerializable[] explanations)

Adds a list of MathML capable objects and a preceding text as an explanation to this exercise result.

Parameters:

preLabel - a preceding text

explanations - a list of MathML capable objects

addExplanation

public void addExplanation(java.lang.String preLabel,
                  MathMLSerializable[] explanations,
                  java.lang.String postLabel)

Adds a list of MathML capable objects, a preceding and closing text as an explanation to this exercise result.

Parameters:

preLabel - a preceding text

explanations - a list of MathML capable objects

postLabel - a closing text

addExplanation

public void addExplanation(java.lang.String preLabel,
                  MathMLSerializable explanation,
                  java.lang.String postLabel)

Adds a MathML capable object, a preceding and closing text as an explanation to this exercise result.

Parameters:

preLabel - a preceding text

explanation - a list of MathML capable object

postLabel - a closing text

addExplanation

public void addExplanation(MathMLSerializable[] explanationParts)

Adds a list of MathML capable objects as an explanation to this exercise result.

Parameters:

explanationParts - a list of MathML capable objects

getExplanations

public MathMLSerializable[][] getExplanations()

Returns a list of all explanations to this exercise where each entry consists of a list of MathML capable objects per row.

setFullScore

public void setFullScore(double val)

getScore

public double getScore()

Returns the score of this exercise result.

Returns:

a number between 0 and 1 (both inclusive); -1 if the exercise was not edited

setScore

public void setScore(double score)

Sets the score for this exercise result.

Parameters:

score - a number between 0 and 1 (both inclusive); -1 if the exercise was not edited

addToScore

public void addToScore(double amount)

Adds the given amount to the score of this exercise result. The resulting score should be a number between 0 and 1 (both inclusive)

Parameters:

amount - number between 0 and 1 (both inclusive)

isFullScore

public boolean isFullScore()

Returns if the given amount of points is the maximum score. This method uses an epsilon comparision.

Parameters:

score - a number greater or equal zero

setConditionallyCorrected

public void setConditionallyCorrected(boolean conditionallyCorrected)

isConditionallyCorrected

public boolean isConditionallyCorrected()