org.assistments.domain.content.tutor

Class ChooseOneProblem

java.lang.Object

org.assistments.domain.content.tutor.Persistable

org.assistments.domain.content.tutor.Content

org.assistments.domain.content.tutor.AssessmentContent

org.assistments.domain.content.tutor.Problem

org.assistments.domain.content.tutor.AnswerableProblem<ChooseNAnswerValuePart,ChooseNAnswer,ChooseNAnswerValue,ChooseNResponseValue>

org.assistments.domain.content.tutor.ChooseNProblem

org.assistments.domain.content.tutor.ChooseOneProblem

All Implemented Interfaces:

HasUID, IsPersistable, SelfValidating

public final class ChooseOneProblem
extends ChooseNProblem

ChooseOneProblem represents ... tbs

Currently this class is final. If you need to subclass it and thus remove final, you need to add a second constructor which takes two parameters:
public ChooseOneProblem(String classType, String uid)

Subclasses of would use that new constructor and pass the subclass' type via a call to super(classType, uid)).

Field Summary

Fields inherited from class org.assistments.domain.content.tutor.AnswerableProblem

answerableClasses, probProperties

Fields inherited from class org.assistments.domain.content.tutor.Problem

defaultResponseDescription

Constructor Summary

Constructors

Constructor and Description
ChooseOneProblem(java.lang.String uid)

Method Summary

Modifier and Type	Method and Description
static java.lang.String	getClassName() Returns this class' fully specified name.
static AnswerableProblemAttributes	getProblemAttributes() Returns the problem type attributes for ChooseOneProblem.
java.util.List<java.lang.String>	getResponseTypeDescription()
boolean	isCorrect(ChooseNResponseValue response, java.util.Map<java.lang.String,java.lang.String> args) Determines whether the submitted response to this question is correct.
ChooseNResponseValue	makeResponse(java.lang.String... responseParts) Creates an object that holds the student's response to the question.
void	validate() Check this object's data for inconsistencies Subclasses must (by informal contract) implement this method!

Methods inherited from class org.assistments.domain.content.tutor.ChooseNProblem

addAnswer, addAnswer

Methods inherited from class org.assistments.domain.content.tutor.AnswerableProblem

addAnswer, addProperty, getAnswer, getAnswerCount, getAnswerEvalType, getAnswerEvalTypes, getAnswers, getAnswers, getAnswerValuePartsList, getCorrectAnswer, getProblemTypeAttributes, getProblemTypeAttributes, getProperties, getProperty, getResponseEvalType, getResponseEvalTypes, getUnscrambledAnswerIndexes, getUnscrambledAnswerIndexes, getWrongAnswer, isAllowedAnswerEvalType, isAllowedResponseEvalType, isAnswerable, isCorrect, isCorrectDefault, isScrambleAnswers, registerProblemTypeAttributes, setAnswerEvalTypes, setAnswerEvalTypes, setAnswers, setCorrectAnswer, setProperties, setResponseEvalTypes, setResponseEvalTypes, setScrambleAnswers, setWrongAnswer

Methods inherited from class org.assistments.domain.content.tutor.Problem

getQuestion, setQuestion

Methods inherited from class org.assistments.domain.content.tutor.AssessmentContent

initializeContent

Methods inherited from class org.assistments.domain.content.tutor.Content

getDescription, getName, setDescription, setName

Methods inherited from class org.assistments.domain.content.tutor.Persistable

createKey, createKey, equals, extractType, extractUID, getKey, getShortKey, getShortKey, getType, getUID, getValidatorUtilities, setValidatorUtilities, toString, validateKey

Methods inherited from class java.lang.Object

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

Constructor Detail

ChooseOneProblem

public ChooseOneProblem(java.lang.String uid)

Method Detail

getProblemAttributes

public static AnswerableProblemAttributes getProblemAttributes()

Returns the problem type attributes for ChooseOneProblem.

This is a convenience method so that a caller can gain access to the problem type attributes without having to first instantiate an instance of ChooseOneProblem.

See Also:

AnswerableProblem.getProblemTypeAttributes(), AnswerableProblem.getProblemTypeAttributes(String)

getClassName

public static java.lang.String getClassName()

Returns this class' fully specified name.

makeResponse

public ChooseNResponseValue makeResponse(java.lang.String... responseParts)

Description copied from class: ChooseNProblem

Creates an object that holds the student's response to the question.

Overrides:

makeResponse in class ChooseNProblem

Parameters:

responseParts - An array containing the indexes of the student's selection. For example: if the student checked off the 1st, 3rd, and 4th items, responseParts would contain:

• responseParts[0] = 0
• responseParts[1] = 2
• responseParts[2] = 3

Returns:

A subclass of AnswerValue. By convention the subclass should be named: <problem name>StudentResponseValue

isCorrect

public boolean isCorrect(ChooseNResponseValue response,
                         java.util.Map<java.lang.String,java.lang.String> args)

Description copied from class: AnswerableProblem

Determines whether the submitted response to this question is correct.

If your problem type defines correctness as when the student's response matches any one of the answers marked as a correct answer, then your subclass can implement this method to call #isCorrectDefault(StudentResponseValue).

If your problem type requires a different semantic for determining correctness, you must implement that logic yourself in isCorrect(). In this case, your implementation may want (or need) to call AnswerableProblem.setWrongAnswer(Answer) so that a common wrong answer is available later to a caller.

Overrides:

isCorrect in class ChooseNProblem

Parameters:

response - The student's response to compare to this problem's answer list.

args - Map for problem specific properties that will be used in calculating correctness for the problem.

Returns:

true if the response matches one of the correct answers; otherwise false

See Also:

#isCorrectDefault(StudentResponseValue), AnswerableProblem.setWrongAnswer(Answer)

validate

public void validate()
              throws ValidationException

Description copied from interface: SelfValidating

Check this object's data for inconsistencies Subclasses must (by informal contract) implement this method!

Specified by:

validate in interface SelfValidating

Overrides:

validate in class AnswerableProblem<ChooseNAnswerValuePart,ChooseNAnswer,ChooseNAnswerValue,ChooseNResponseValue>

Throws:

ValidationException - if the data is invalid

getResponseTypeDescription

public java.util.List<java.lang.String> getResponseTypeDescription()

Overrides:

getResponseTypeDescription in class ChooseNProblem