Class MultiChoiceQuestion

java.lang.Object

org.deltava.beans.DatabaseBean

org.deltava.beans.DatabaseBlobBean

org.deltava.beans.ImageBean

org.deltava.beans.testing.Question

org.deltava.beans.testing.MultiChoiceQuestion

All Implemented Interfaces:

Serializable, Comparable<Object>, IDBean, MultipleChoice, Cacheable

Direct Known Subclasses:

RoutePlotQuestion

public class MultiChoiceQuestion
extends Question
implements MultipleChoice

A bean to store multiple-choice examination questions.

Since:

1.0

Version:

9.0

Author:

Luke

See Also:

• Serialized Form

Nested Class Summary

Nested classes/interfaces inherited from class ImageBean

ImageBean.ImageFormat

Modifier and Type	Class	Description
static enum	ImageBean.ImageFormat	Supported image types.

Field Summary

Fields inherited from class Question

_text

Modifier and Type	Field	Description
protected String	_text	The question text.

Fields inherited from class DatabaseBlobBean

_buffer

Modifier and Type	Field	Description
protected byte[]	_buffer	The buffer for the image/file data.

Constructor Summary

Constructors

Constructor	Description
MultiChoiceQuestion(String text)	Creates a new Question bean

Method Summary

Modifier and Type	Method	Description
void	addChoice(String choice)	Adds a choice to the available choices.
List<String>	getChoices()	Returns the list of choices.
final boolean	getExactMatch()	Returns if the user has provided the exact correct answer.
int	getMaxAnswerLength()	Returns the maximum length of any of the answer choices.

Methods inherited from class Question

compareTo, getAnswer, getCorrectAnswer, getImageType, getNumber, getQuestion, getReference, isCorrect, setAnswer, setCorrect, setCorrectAnswer, setNumber, setReference

Modifier and Type	Method	Description
int	compareTo(Object o2)	Compares to another Question by comparing the Question Numbers.
String	getAnswer()	Returns the User's answer to the Question.
String	getCorrectAnswer()	Returns the Correct Answer to the Question.
ImageType	getImageType()	Returns the database image type.
int	getNumber()	Returns the Question Number.
String	getQuestion()	Returns the Question text.
String	getReference()	Returns an optional reference to the correct answer.
boolean	isCorrect()	Returns if the question was answered correctly.
void	setAnswer(String answer)	Sets the User-provided answer to this Question.
void	setCorrect(boolean isOK)	Marks a Question as correctly answered.
void	setCorrectAnswer(String answer)	Sets the correct answer to this Question.
void	setNumber(int number)	Updates the Question Number.
void	setReference(String ref)	Sets the reference to the correct answer to this Question.

Methods inherited from class ImageBean

checkParam, getFormat, getHasImage, getHeight, getSize, getWidth, load, load, setFormat, setHeight, setSize, setWidth

Modifier and Type	Method	Description
protected static void	checkParam(int param, String msg)	Helper method to check for negative numeric parameters.
ImageBean.ImageFormat	getFormat()	Returns the type of image.
boolean	getHasImage()	Queries if the bean has an associated Image.
int	getHeight()	Returns the height of the image.
int	getSize()	Returns the size of the image.
int	getWidth()	Returns the width of the image.
final void	load(byte[] buffer)	Updates the image buffer.
final void	load(InputStream is)	Loads an image into the buffer.
void	setFormat(ImageBean.ImageFormat t)	Updates the image format.
void	setHeight(int y)	Updates the height of this image.
void	setSize(int newSize)	Updates the size of this image.
void	setWidth(int x)	Updates the width of this image.

Methods inherited from class DatabaseBlobBean

clear, getInputStream, isLoaded

Modifier and Type	Method	Description
void	clear()	Clears the buffer.
InputStream	getInputStream()	Returns the content of the buffer.
boolean	isLoaded()	Returns whether the buffer has been populated.

Methods inherited from class DatabaseBean

cacheKey, equals, getHexID, getID, hashCode, setID, validateID, validateID

Modifier and Type	Method	Description
Object	cacheKey()	Returns the cache key for this object.
boolean	equals(Object o)
String	getHexID()	Returns the hexadecimal database ID of this object.
int	getID()	Returns the database ID of this object.
int	hashCode()
void	setID(int id)	Update the database row ID of this bean.
static void	validateID(int oldID, int newID)	Validates a database ID.
static void	validateID(int oldID, int newID, boolean allowZero)	Validates a database ID.

Methods inherited from class Object

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

Constructor Details

MultiChoiceQuestion

public MultiChoiceQuestion(String text)

Creates a new Question bean

Parameters:

text - the Question text

Throws:

NullPointerException - if text is null

Method Details

getChoices

public List<String> getChoices()

Returns the list of choices.

Specified by:

getChoices in interface MultipleChoice

Returns:

a List of choices

See Also:

• MultiChoiceQuestionProfile.getChoices()

getMaxAnswerLength

public int getMaxAnswerLength()

Returns the maximum length of any of the answer choices.

Returns:

the maximum answer length

addChoice

public void addChoice(String choice)

Adds a choice to the available choices.

Specified by:

addChoice in interface MultipleChoice

Parameters:

choice - the choice text

Throws:

NullPointerException - if choice is null

See Also:

• getChoices()
• MultiChoiceQuestionProfile.addChoice(String)

getExactMatch

public final boolean getExactMatch()

Returns if the user has provided the exact correct answer.

Overrides:

getExactMatch in class Question

Returns:

FALSE always