Class Question

java.lang.Object

org.deltava.beans.DatabaseBean

org.deltava.beans.DatabaseBlobBean

org.deltava.beans.ImageBean

org.deltava.beans.testing.Question

All Implemented Interfaces:

Serializable, Comparable<Object>, IDBean, Cacheable

Direct Known Subclasses:

MultiChoiceQuestion, QuestionProfile

public class Question
extends ImageBean

A class to store examination question information.

Since:

1.0

Version:

10.6

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

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
Question(String text)	Creates a new Question.

Method Summary

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.
boolean	getExactMatch()	Returns if the user has provided the exact correct answer.
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

Field Details

_text

protected String _text

The question text.

Constructor Details

Question

public Question(String text)

Creates a new Question.

Parameters:

text - the question text

Throws:

NullPointerException - if text is null

Method Details

getImageType

public ImageType getImageType()

Description copied from class: ImageBean

Returns the database image type.

Specified by:

getImageType in class ImageBean

Returns:

an ImageType

getQuestion

public String getQuestion()

Returns the Question text.

Returns:

the text of the question

See Also:

• Question(String)

getCorrectAnswer

public String getCorrectAnswer()

Returns the Correct Answer to the Question.

Returns:

the correct answer

See Also:

• setCorrectAnswer(String)

getAnswer

public String getAnswer()

Returns the User's answer to the Question.

Returns:

the answer

See Also:

• setAnswer(String)

getReference

public String getReference()

Returns an optional reference to the correct answer.

Returns:

a citation

See Also:

• setReference(String)

getNumber

public int getNumber()

Returns the Question Number.

Returns:

the question number

See Also:

• setNumber(int)

getExactMatch

public boolean getExactMatch()

Returns if the user has provided the exact correct answer. This may indicate a copy/paste.

Returns:

TRUE if the answer exactly matches the correct answer

isCorrect

public boolean isCorrect()

Returns if the question was answered correctly.

Returns:

TRUE if the answer is correct, otherwise FALSE

See Also:

• setCorrect(boolean)

setCorrectAnswer

public void setCorrectAnswer(String answer)

Sets the correct answer to this Question.

Parameters:

answer - the correct answer

See Also:

• getCorrectAnswer()

setAnswer

public void setAnswer(String answer)

Sets the User-provided answer to this Question.

Parameters:

answer - the User's answer

See Also:

• getAnswer()

setReference

public void setReference(String ref)

Sets the reference to the correct answer to this Question.

Parameters:

ref - a citation

See Also:

• getReference()

setCorrect

public void setCorrect(boolean isOK)

Marks a Question as correctly answered.

Parameters:

isOK - TRUE if the Question was answered correctly, otherwise FALSE

See Also:

• isCorrect()

setNumber

public void setNumber(int number)

Updates the Question Number.

Parameters:

number - the question number

See Also:

• getNumber()

compareTo

public int compareTo(Object o2)

Compares to another Question by comparing the Question Numbers.

Specified by:

compareTo in interface Comparable<Object>

Overrides:

compareTo in class DatabaseBean

See Also:

• Comparable.compareTo(Object)