Class Examination

java.lang.Object

org.deltava.beans.DatabaseBean

org.deltava.beans.testing.Test

org.deltava.beans.testing.Examination

All Implemented Interfaces:

Serializable, Comparable<Object>, AuthoredBean, IDBean, ViewEntry, Cacheable

public class Examination
extends Test

A class to store information about written examinations.

Since:

1.0

Version:

11.0

Author:

Luke

See Also:

• Serialized Form

Field Summary

Fields

Modifier and Type	Field	Description
static final String	QUESTIONNAIRE_NAME	Applicant Questionnaire Examination Name.

Fields inherited from class Test

_score

Modifier and Type	Field	Description
protected int	_score

Constructor Summary

Constructors

Constructor	Description
Examination(String name)	Creates a new examination.

Method Summary

Modifier and Type	Method	Description
void	addQuestion(Question q)	Adds a Question to the Examination.
boolean	getAutoScored()	Returns whether this Examination was automatically scored.
boolean	getEmpty()	Returns whether this Examination's answers were empty.
Instant	getExpiryDate()	Returns the Expiration Date of this Examination.
Question	getQuestion(int idx)	Returns a specific Question from the Examination.
Collection<Question>	getQuestions()	Returns this Examination's questions.
boolean	getRoutePlot()	Returns if a route plotting question is included in this Examination.
String	getRowClassName()	Returns the CSS class name for a view table row.
int	getSize()	Returns the number of questions in this Examination.
boolean	hasImage()	Returns if the Examination has any questions with images.
boolean	hasMultipleChoice()	Returns if the Examination has any multiple-choice questions.
void	setAutoScored(boolean isAutoScored)	Updates whether this Examination was automatically scored.
void	setEmpty(boolean isEmpty)	Marks this Examination as having all blank answers.
void	setExpiryDate(Instant dt)	Updates the expiration date of this Examination.
void	setSize(int size)	Updates the size of this examination.

Methods inherited from class Test

compareTo, getAcademy, getAuthorID, getComments, getDate, getFirstName, getLastName, getName, getOwner, getPassFail, getScore, getScoredOn, getScorerID, getStage, getStatus, getSubmittedOn, setAcademy, setAuthorID, setComments, setDate, setFirstName, setLastName, setOwner, setPassFail, setScore, setScoredOn, setScorerID, setStage, setStatus, setSubmittedOn

Modifier and Type	Method	Description
int	compareTo(Object o2)
boolean	getAcademy()	Returns whether this Test is part of the Flight Academy.
int	getAuthorID()	Returns the Author of this bean.
String	getComments()	Returns the Examination comments.
Instant	getDate()	Returns the date this Examination was created/performed on.
String	getFirstName()	Returns the Pilot's first (given) name.
String	getLastName()	Returns the Pilot's last (family) name.
String	getName()	Returns the name of the examination/video.
AirlineInformation	getOwner()	Returns the owner Airline of this Examination.
boolean	getPassFail()	Returns if the Pilot passed or failed this examination
int	getScore()	Returns the score of this examination.
Instant	getScoredOn()	Returns the date/time this Examination was scored on
int	getScorerID()	Returns the Scorer's Database ID.
int	getStage()	Returns the stage level of this examination/checkride.
TestStatus	getStatus()	Returns the status of this examination.
Instant	getSubmittedOn()	Returns the date/time this Examination was submitted on.
void	setAcademy(boolean academy)	Marks this Test as part of the Flight Academy.
void	setAuthorID(int id)	Updates the author of this bean.
void	setComments(String comments)	Updates the Examination comments.
void	setDate(Instant dt)	Updates this Examination's date.
void	setFirstName(String name)	Sets the first (given) name of the Pilot.
void	setLastName(String name)	Sets the last (family) name of the Pilot.
void	setOwner(AirlineInformation ai)	Updates this Examination's owner Airline.
void	setPassFail(boolean passFail)	Sets whether this Pilot passed or failed the examination.
void	setScore(int score)	Sets the score for this Examination.
void	setScoredOn(Instant dt)	Updates this Examination's "scored on" date.
void	setScorerID(int id)	Updates the database ID for the Pilot who scored this exam.
void	setStage(int stage)	Sets the stage level for this Examination.
void	setStatus(TestStatus s)	Sets the status for this Test.
void	setSubmittedOn(Instant dt)	Updates this Examination's submission date.

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

QUESTIONNAIRE_NAME

public static final String QUESTIONNAIRE_NAME

Applicant Questionnaire Examination Name.

See Also:

• Constant Field Values

Constructor Details

Examination

public Examination(String name)

Creates a new examination.

Parameters:

name - the name of the examination

Method Details

getSize

public int getSize()

Returns the number of questions in this Examination.

Specified by:

getSize in class Test

Returns:

the number of questions

See Also:

• setSize(int)

getExpiryDate

public Instant getExpiryDate()

Returns the Expiration Date of this Examination.

Returns:

the date/time this exam must be completed by

See Also:

• setExpiryDate(Instant)

getQuestions

public Collection<Question> getQuestions()

Returns this Examination's questions.

Returns:

a List of questions.

See Also:

• Question
• addQuestion(Question)

getEmpty

public boolean getEmpty()

Returns whether this Examination's answers were empty.

Returns:

TRUE if all Answers are blank, otherwise FALSE

See Also:

• setEmpty(boolean)

getRoutePlot

public boolean getRoutePlot()

Returns if a route plotting question is included in this Examination.

Returns:

TRUE if a route plotting question is included, otherwise FALSE

See Also:

• RoutePlot

getQuestion

public Question getQuestion(int idx)

Returns a specific Question from the Examination.

Parameters:

idx - the question number

Returns:

the Question with the specified number, or null if not present

getAutoScored

public boolean getAutoScored()

Returns whether this Examination was automatically scored.

Returns:

TRUE if the Examination was automatically scored, otherwise FALSE

See Also:

• getAutoScored()

hasMultipleChoice

public boolean hasMultipleChoice()

Returns if the Examination has any multiple-choice questions.

Returns:

TRUE if there is at least one multiple-choice question, otherwise FALSE

hasImage

public boolean hasImage()

Returns if the Examination has any questions with images.

Returns:

TRUE if there is at least one question with an image, otherwise false

setEmpty

public void setEmpty(boolean isEmpty)

Marks this Examination as having all blank answers.

Parameters:

isEmpty - TRUE if all answers are blank, otherwise FALSE

Throws:

IllegalStateException - if Questions have been populated

See Also:

• getEmpty()

addQuestion

public void addQuestion(Question q)

Adds a Question to the Examination.

Parameters:

q - the Question to add

See Also:

• getQuestions()

setSize

public void setSize(int size)

Updates the size of this examination.

Specified by:

setSize in class Test

Parameters:

size - the number of questions

Throws:

IllegalStateException - if at least one question has been aded to this exam

See Also:

• getSize()

setExpiryDate

public void setExpiryDate(Instant dt)

Updates the expiration date of this Examination.

Parameters:

dt - the new expiration date

See Also:

• getExpiryDate()

setAutoScored

public void setAutoScored(boolean isAutoScored)

Updates whether this Examination was automatically scored.

Parameters:

isAutoScored - TRUE if the Examination was automatically scored, otherwise FALSE

See Also:

• getAutoScored()

getRowClassName

public String getRowClassName()

Returns the CSS class name for a view table row.

Returns:

the CSS class name