Class QuestionProfile

java.lang.Object

org.deltava.beans.DatabaseBean

org.deltava.beans.DatabaseBlobBean

org.deltava.beans.ImageBean

org.deltava.beans.testing.Question

org.deltava.beans.testing.QuestionProfile

All Implemented Interfaces:

Serializable, Cloneable, Comparable<Object>, Auditable, IDBean, PassStatistics, ViewEntry, Cacheable

Direct Known Subclasses:

MultiChoiceQuestionProfile

public class QuestionProfile
extends Question
implements Auditable, PassStatistics, ViewEntry

A class to store Exam Question profiles.

Since:

1.0

Version:

9.1

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

Method Summary

Modifier and Type	Method	Description
void	addAirline(AirlineInformation ai)	Makes this Question visible to an Airline.
void	addExam(String examName)	Links this Question to an Examination.
final int	compareTo(Object o2)	Compares to another Question by comparing the Question Numbers.
boolean	getActive()	Returns whether this Question is active.
Collection<AirlineInformation>	getAirlines()	Returns the Airlines that can access this Question.
String	getAuditID()	Returns the object ID for this auditable object.
Collection<String>	getExams()	Returns the Examinatios associated with this Question.
AirlineInformation	getOwner()	Returns the Owner Airline for this Question.
int	getPassCount()	Returns the number of test passes or correct answers.
String	getRowClassName()	Returns the CSS row class name if included in a view table.
int	getTotal()	Returns the total number of invocations.
void	setActive(boolean active)	Marks this Question as Active.
void	setAirlines(Collection<AirlineInformation> airlines)	Sets the Airlines that this Question will be visible to.
void	setCorrectAnswers(int count)	Updates the total number of times this Question has been answered correctly.
void	setExams(Collection<String> exams)	Links this Question to a number of Examinations.
final void	setNumber(int number)	Sets the Question Number.
void	setOwner(AirlineInformation ai)	Sets which airline is the owner of this Question.
void	setQuestion(String text)	Updates the Question text.
void	setTotalAnswers(int count)	Updates the total number of times this Question has been included in an Examination.
Question	toQuestion()	Converts this question profile into a question.

Methods inherited from class Question

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

Modifier and Type	Method	Description
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	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

Methods inherited from interface Auditable

getAuditType, isCrossApp

Modifier and Type	Method	Description
default String	getAuditType()	Returns the audit type for this auditable object.
default boolean	isCrossApp()	Returns whether this object is within multiple web applications.

Constructor Details

QuestionProfile

public QuestionProfile(String text)

Creates a new Question Profile.

Parameters:

text - the question text

Throws:

NullPointerException - if text is null

Method Details

getExams

public Collection<String> getExams()

Returns the Examinatios associated with this Question.

Returns:

a Collection of Examination names

See Also:

• addExam(String)
• setExams(Collection)

getActive

public boolean getActive()

Returns whether this Question is active.

Returns:

TRUE if the Question can be included in an Examination, otherwise FALSE

See Also:

• setActive(boolean)

getOwner

public AirlineInformation getOwner()

Returns the Owner Airline for this Question.

Returns:

an AirlineInformation bean

See Also:

• setOwner(AirlineInformation)

getAirlines

public Collection<AirlineInformation> getAirlines()

Returns the Airlines that can access this Question.

Returns:

a Collection of AirlineInformation beans

See Also:

• addAirline(AirlineInformation)
• setAirlines(Collection)

getTotal

public int getTotal()

Description copied from interface: PassStatistics

Returns the total number of invocations.

Specified by:

getTotal in interface PassStatistics

Returns:

the number of invocations

getPassCount

public int getPassCount()

Description copied from interface: PassStatistics

Returns the number of test passes or correct answers.

Specified by:

getPassCount in interface PassStatistics

Returns:

the number of successes

setNumber

public final void setNumber(int number)

Sets the Question Number. DISABLED

Overrides:

setNumber in class Question

Parameters:

number - the question number

Throws:

UnsupportedOperationException - always

See Also:

• Question.getNumber()

setQuestion

public void setQuestion(String text)

Updates the Question text.

Parameters:

text - the quesstion

Throws:

NullPointerException - if text is null

See Also:

• Question.getQuestion()

addExam

public void addExam(String examName)

Links this Question to an Examination.

Parameters:

examName - the Examination name

See Also:

• setExams(Collection)
• getExams()

setExams

public void setExams(Collection<String> exams)

Links this Question to a number of Examinations.

Parameters:

exams - a Collection of examination names

See Also:

• addExam(String)
• getExams()

setActive

public void setActive(boolean active)

Marks this Question as Active.

Parameters:

active - TRUE if the Question can be included in an Examination, otherwise FALSE

See Also:

• getActive()

setCorrectAnswers

public void setCorrectAnswers(int count)

Updates the total number of times this Question has been answered correctly.

Parameters:

count - the number of correct answers

See Also:

• PassStatistics.getPassCount()

setTotalAnswers

public void setTotalAnswers(int count)

Updates the total number of times this Question has been included in an Examination.

Parameters:

count - the number of times included

See Also:

• PassStatistics.getTotal()

setOwner

public void setOwner(AirlineInformation ai)

Sets which airline is the owner of this Question.

Parameters:

ai - the AirlineInformation bean for the owner airline

See Also:

• getOwner()

addAirline

public void addAirline(AirlineInformation ai)

Makes this Question visible to an Airline.

Parameters:

ai - the AirlineInformation bean

See Also:

• setAirlines(Collection)
• getAirlines()

setAirlines

public void setAirlines(Collection<AirlineInformation> airlines)

Sets the Airlines that this Question will be visible to.

Parameters:

airlines - a Collection of AirlineInformation beans

compareTo

public final int compareTo(Object o2)

Description copied from class: Question

Compares to another Question by comparing the Question Numbers.

Specified by:

compareTo in interface Comparable<Object>

Overrides:

compareTo in class Question

See Also:

• Comparable.compareTo(Object)

getRowClassName

public String getRowClassName()

Returns the CSS row class name if included in a view table.

Specified by:

getRowClassName in interface ViewEntry

Returns:

the CSS class name

getAuditID

public String getAuditID()

Description copied from interface: Auditable

Returns the object ID for this auditable object.

Specified by:

getAuditID in interface Auditable

Returns:

the ID

toQuestion

public Question toQuestion()

Converts this question profile into a question. Subclasess should extend this method to create the necessary Question subclasses.

Returns:

a Question bean