com.aspc.questionnaire

Class Answer

java.lang.Object

com.aspc.DBObj.DBObject

com.aspc.questionnaire.Answer

All Implemented Interfaces:

SecondaryCacheGroup

public class Answer
extends DBObject

A users answer to a question.

data model
THREAD MODE: MIXED, SINGLE-THREADED when called from MutableDataSource else MULTI-THREADED

Since:

June 1, 2001, 11:51 AM

Author:

Nigel Leck

Nested Class Summary

Nested classes/interfaces inherited from class com.aspc.DBObj.DBObject

DBObject.DenormalizeAction

Field Summary

Fields

Modifier and Type	Field and Description
static GlobalId	DBCLASS_GID A users answer to a question.
static java.lang.String	DBCLASS_NAME A users answer to a question.

Fields inherited from class com.aspc.DBObj.DBObject

ATTRIBUTE_MARVIN, dbClass, ds, NO_LOOP_PARAMS

Constructor Summary

Constructors

Constructor and Description
Answer(DBClass def, DataSource dataSource) Std.

Method Summary

Modifier and Type	Method and Description
void	correctStatus() correct the status of this answer
static Answer	create(MutableDataSource mds) Make a new instance of this class.
protected void	eventFieldUpdated(DBField field, java.lang.Object previous, GlobalKey previousKey, FldParams params) update dependent fields.
protected void	extDelete() Additional functionality when an object is marked for deletion by calling delete().
protected void	extFixUp() The extended fix up routine for known problems.
protected java.lang.Object	extGetDerivedValue(DBField field, FldParams params) Calculate the derived value for this field.
protected void	extPreValidate() OVERRIDE To add functionality to before validation is called.
protected ValidationError	extValidateField(DBField field, ValidationList list) Additional validation for particular field OVERRIDE THIS METHOD TO ADD VALIDATIONS FOR A FIELD.
Answers	findAnswers(java.lang.String... args) The answer group.
static Answer	findKey(DataSource ds, int key) Find the target for this class by the primary key
Question	findQuestion(java.lang.String... args) The question for this answer.
Answers	getAnswers(java.lang.String... args)
java.lang.String	getChoiceCodes(java.lang.String... args)
java.util.Date	getCreatedTime(java.lang.String... args)
java.lang.String	getEnteredComment(java.lang.String... args)
java.util.Date	getEnteredDate(java.lang.String... args)
double	getEnteredFloat(java.lang.String... args)
int	getEnteredInt(java.lang.String... args)
java.lang.String	getEnteredText(java.lang.String... args)
int	getID(java.lang.String... args)
Question	getQuestion(java.lang.String... args)
java.lang.String	getRawResult(java.lang.String... args)
java.lang.String	getResult(java.lang.String... args)
double	getScore(java.lang.String... args)
double	getScore2(java.lang.String... args)
java.lang.String	getUniqueCheck(java.lang.String... args)
boolean	isCompleted(java.lang.String... args)
static DBQuery<Answer>	makeQuery(DataSource ds) Make a new QUERY for this class.
Answer	setAnswers(com.aspc.dal.questionnaire.Answers value, java.lang.String... args)
Answer	setCreatedTime(java.util.Date value, java.lang.String... args)
Answer	setEnteredComment(java.lang.String value, java.lang.String... args)
Answer	setEnteredDate(java.util.Date value, java.lang.String... args)
Answer	setEnteredFloat(double value, java.lang.String... args)
Answer	setEnteredInt(int value, java.lang.String... args)
Answer	setEnteredText(java.lang.String value, java.lang.String... args)
Answer	setID(int value, java.lang.String... args)
Answer	setQuestion(com.aspc.dal.questionnaire.Question value, java.lang.String... args)
Answer	setUniqueCheck(java.lang.String value, java.lang.String... args)

Methods inherited from class com.aspc.DBObj.DBObject

addReloadEventListener, archiveCheck, autoEnterCreate, calculateValue, calculateValue, calculateValue, callingRestoreByJournal, changeThreadMode, checkCreateAccess, checkDelete, checkDeleteAccess, checkModifyAccess, checkModifyAccess, checkReadAccess, clearCache, copy, copyFields, copyIncludeField, copyInwardLinks, delete, denormalizedResult, displayLogName, displayName, displayValue, doSearch, dump, equals, eventDataLoaded, extAutoEnterCreate, extCanDeleteDependantObject, extCheckCreateAccess, extCheckDeleteAccess, extCheckModifyAccess, extCheckModifyAccess, extCheckReadAccess, extCopy, extDeleteRecord, extGetDerivedGlobalKey, extGetValue, extIsMandatory, extIsOnChange, extMarkSavePoint, extPostDeleteRecord, extPostSaveRecord, extPreDeleteRecord, extPreSaveRecord, extPreValidateDelete, extRaiseEvents, extRollbackTo, extSaveRecord, extSetValue, extUndelete, extValidateDelete, extValidateRecord, fetchLinkHolder, findGlobalKey, findGlobalKey, findGlobalKey, findGlobalKey, findLinkedObject, findLinkedObject, findLinkedObject, findRawData, fireEventDataLoaded, fixUp, forceLockedTransaction, getBoolean, getBoolean, getBoolean, getBoolean, getBoolean, getBoolean, getChangedFieldInfo, getChangedFields, getDate, getDate, getDate, getDate, getDate, getDefaultValue, getDisableOnChangeEvent, getDouble, getDouble, getDouble, getDouble, getDouble, getFieldDouble, getFieldInt, getFieldLong, getFieldString, getFormattedString, getFormattedString, getGlobalKey, getGlobalKey, getGlobalKey, getGlobalKey, getGlobalKey, getInt, getInt, getInt, getInt, getInt, getInt, getInwardLinkage, getKeyString, getKeyValue, getLinkedObject, getLinkedObject, getLinkedObject, getLinkedObjectByKey, getLinkedRowId, getLinkedRowId, getLinkedRowIdByData, getLinkHolder, getLockedTransaction, getLong, getLong, getLong, getLong, getLong, getLong, getMutableArrayValue, getMutableArrayValue, getOriginalKey, getOriginalValue, getOriginalValue, getProcessedValue, getPureValue, getRawData, getRawValue, getRawValue, getRowId, getRowKey, getSecondaryCacheGroupKey, getSrcLayerID, getString, getString, getString, getString, getString, getString, getValue, getValue, getValue, getValue, hasAutoChanged, hasAutoChanged, hasChanged, hasChangedByUser, hasChangedByUserField, hasChangedByUserField, hasFieldChanged, hasFieldChanged, hashCode, hasStoredResult, iCheckDeleteAccess, iCheckModifyAccess, iCheckReadAccess, iGetDenormalizedMap, iGetRawValue, iPlaceDenormalizedResult, iPostSaveOrDeleteRecord, iPreSaveOrDeleteRecord, iPreValidate, iRaiseEvents, iSaveOrDeleteRecord, isBrokenLink, isBrokenLink, isChanged, isDataCacheKnownToBeDirty, isDeleted, isEmpty, iSetValue, isForceReindex, isKeyWordField, isMandatory, isNew, isNull, isNull, isOnChange, isReindex, iValidateRecord, lastTouched, makeArchiveDataLoader, makeClone, makeDataLoader, makeDenormalizedDoc, makeLinkedArray, makeModifyAccessException, makeSearchPlan, makeWriteProvider, manualDenormalizeOnSave, markSavePoint, optLockedTransaction, registerWatchedObject, reindex, releaseDenormalized, removeReloadEventListener, restoreByJournal, rollbackTo, setBoolean, setBoolean, setBoolean, setBoolean, setDisableOnChangeEvent, setDouble, setDouble, setInt, setInt, setLong, setLong, setRawData, setValue, setValue, setValue, setValue, setValue, setValue, setValue, setValue, setValue, setValue, toString, touch, undelete, validateField, validateRecord, validateSubType

Methods inherited from class java.lang.Object

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

Field Detail

DBCLASS_NAME

public static final java.lang.String DBCLASS_NAME

A users answer to a question.

See Also:

Constant Field Values

DBCLASS_GID

public static final GlobalId DBCLASS_GID

A users answer to a question.

Constructor Detail

Answer

public Answer(DBClass def,
              DataSource dataSource)
       throws java.lang.Exception

Std. DBObject constructor.

Parameters:

def - The class of this object

dataSource - The datasource for this object

Throws:

java.lang.Exception - A serious problem occurred

Method Detail

getID

@CheckReturnValue
public int getID(java.lang.String... args)

setID

@Nonnull
public Answer setID(int value,
                             java.lang.String... args)
                      throws java.lang.Exception

Throws:

java.lang.Exception

getAnswers

@CheckReturnValue
 @Nullable
public Answers getAnswers(java.lang.String... args)

findAnswers

@CheckReturnValue
 @Nonnull
public final Answers findAnswers(java.lang.String... args)
                                                      throws NotFoundException

The answer group.

--> Answers (Integer, Mandatory, Searchable)

Parameters:

args - the optional arguments

Returns:

Answers

Throws:

NotFoundException - Answers was not found

setAnswers

@Nonnull
public Answer setAnswers(com.aspc.dal.questionnaire.Answers value,
                                  java.lang.String... args)
                           throws java.lang.Exception

Throws:

java.lang.Exception

getChoiceCodes

@CheckReturnValue
 @Nonnull
public java.lang.String getChoiceCodes(java.lang.String... args)

isCompleted

@CheckReturnValue
public boolean isCompleted(java.lang.String... args)

getCreatedTime

@CheckReturnValue
 @Nullable
public java.util.Date getCreatedTime(java.lang.String... args)

setCreatedTime

@Nonnull
public Answer setCreatedTime(java.util.Date value,
                                      java.lang.String... args)
                               throws java.lang.Exception

Throws:

java.lang.Exception

getEnteredComment

@CheckReturnValue
 @Nonnull
public java.lang.String getEnteredComment(java.lang.String... args)

setEnteredComment

@Nonnull
public Answer setEnteredComment(java.lang.String value,
                                         java.lang.String... args)
                                  throws java.lang.Exception

Throws:

java.lang.Exception

getEnteredDate

@CheckReturnValue
 @Nullable
public java.util.Date getEnteredDate(java.lang.String... args)

setEnteredDate

@Nonnull
public Answer setEnteredDate(java.util.Date value,
                                      java.lang.String... args)
                               throws java.lang.Exception

Throws:

java.lang.Exception

getEnteredFloat

@CheckReturnValue
public double getEnteredFloat(java.lang.String... args)

setEnteredFloat

@Nonnull
public Answer setEnteredFloat(double value,
                                       java.lang.String... args)
                                throws java.lang.Exception

Throws:

java.lang.Exception

getEnteredInt

@CheckReturnValue
public int getEnteredInt(java.lang.String... args)

setEnteredInt

@Nonnull
public Answer setEnteredInt(int value,
                                     java.lang.String... args)
                              throws java.lang.Exception

Throws:

java.lang.Exception

getEnteredText

@CheckReturnValue
 @Nonnull
public java.lang.String getEnteredText(java.lang.String... args)

setEnteredText

@Nonnull
public Answer setEnteredText(java.lang.String value,
                                      java.lang.String... args)
                               throws java.lang.Exception

Throws:

java.lang.Exception

getQuestion

@CheckReturnValue
 @Nullable
public Question getQuestion(java.lang.String... args)

findQuestion

@CheckReturnValue
 @Nonnull
public final Question findQuestion(java.lang.String... args)
                                                        throws NotFoundException

The question for this answer.

--> Question (Integer, Mandatory, Searchable)

Parameters:

args - the optional arguments

Returns:

Question

Throws:

NotFoundException - Question was not found

setQuestion

@Nonnull
public Answer setQuestion(com.aspc.dal.questionnaire.Question value,
                                   java.lang.String... args)
                            throws java.lang.Exception

Throws:

java.lang.Exception

getRawResult

@CheckReturnValue
 @Nonnull
public java.lang.String getRawResult(java.lang.String... args)

getResult

@CheckReturnValue
 @Nonnull
public java.lang.String getResult(java.lang.String... args)

getScore

@CheckReturnValue
public double getScore(java.lang.String... args)

getScore2

@CheckReturnValue
public double getScore2(java.lang.String... args)

getUniqueCheck

@CheckReturnValue
 @Nonnull
public java.lang.String getUniqueCheck(java.lang.String... args)

setUniqueCheck

@Nonnull
public Answer setUniqueCheck(java.lang.String value,
                                      java.lang.String... args)
                               throws java.lang.Exception

Throws:

java.lang.Exception

create

@Nonnull
 @CheckReturnValue
public static Answer create(@Nonnull
                                                        MutableDataSource mds)
                                                 throws java.lang.Exception

Make a new instance of this class.

Parameters:

mds - the datasource

Returns:

the new record

Throws:

java.lang.Exception - an object of this class could not be created

makeQuery

@Nonnull
 @CheckReturnValue
public static DBQuery<Answer> makeQuery(@Nonnull
                                                                    DataSource ds)
                                                             throws NotFoundException

Make a new QUERY for this class.

Parameters:

ds - the datasource

Returns:

the new QUERY

Throws:

NotFoundException - if class could not be found

findKey

@Nonnull
 @CheckReturnValue
public static Answer findKey(@Nonnull
                                                         DataSource ds,
                                                         int key)
                                                  throws NotFoundException,
                                                         java.lang.Exception

Find the target for this class by the primary key

Parameters:

ds - the datasource

key - the value

Returns:

the target

Throws:

NotFoundException - if target could not be found

java.lang.Exception - a serious problem

extPreValidate

@OverridingMethodsMustInvokeSuper
protected void extPreValidate()
                                                         throws java.lang.Exception

Description copied from class: DBObject

OVERRIDE To add functionality to before validation is called.

THIS IS YOUR LAST CHANCE TO MAKE CHANGES BEFORE VALIDATIONS.

Overrides:

extPreValidate in class DBObject

Throws:

java.lang.Exception - a serious problem

extGetDerivedValue

@CheckReturnValue
protected java.lang.Object extGetDerivedValue(@Nonnull
                                                                DBField field,
                                                                @Nullable
                                                                FldParams params)
                                                         throws java.lang.Exception

Calculate the derived value for this field.

Overrides:

extGetDerivedValue in class DBObject

Parameters:

field - The field to get

params - The parameters for this field eg. language= or default=

Returns:

The value.

Throws:

java.lang.Exception - A serious problem

eventFieldUpdated

@OverridingMethodsMustInvokeSuper
protected void eventFieldUpdated(@Nonnull
                                                                   DBField field,
                                                                   @Nullable
                                                                   java.lang.Object previous,
                                                                   @Nullable
                                                                   GlobalKey previousKey,
                                                                   @Nullable
                                                                   FldParams params)
                                                            throws java.lang.Exception

update dependent fields.

Overrides:

eventFieldUpdated in class DBObject

Parameters:

field - The field updated.

previous - The previous value for this field.

previousKey - The previous key

params - The parameters used

Throws:

java.lang.Exception - a serious problem

correctStatus

public void correctStatus()
                   throws java.lang.Exception

correct the status of this answer

Throws:

java.lang.Exception - A serious problem

extDelete

@OverridingMethodsMustInvokeSuper
protected void extDelete()
                                                    throws java.lang.Exception

Additional functionality when an object is marked for deletion by calling delete().

Overrides:

extDelete in class DBObject

Throws:

java.lang.Exception - A serious problem

extFixUp

@OverridingMethodsMustInvokeSuper
protected void extFixUp()
                                                   throws java.lang.Exception

The extended fix up routine for known problems. This routine will be called by the method fixUp() in DBObject.

Overrides:

extFixUp in class DBObject

Throws:

java.lang.Exception - a serious problem

extValidateField

@OverridingMethodsMustInvokeSuper
 @CheckReturnValue
 @Nullable
protected ValidationError extValidateField(@Nonnull
                                                                                                           DBField field,
                                                                                                           @Nonnull
                                                                                                           ValidationList list)
                                                                                                    throws java.lang.Exception

Description copied from class: DBObject

Additional validation for particular field OVERRIDE THIS METHOD TO ADD VALIDATIONS FOR A FIELD.

OVERRIDE this method to add validation to a field but call iValidateField to perform the full validation for a field.

This method should be READ ONLY. Don't create DBObjects here.
When overriding this method the following code stub should be used.
ValidationError ve;
ve = super.extValidateField( field, list);
if( ve != null) return ve;
if( field.getName().equalsIgnoreCase( DBFIELD_FIELD1))
{
return list.createError( DBMessage.LIST_DB_MY_ERROR, this, field);
}
else if( field.getName().equalsIgnoreCase( DBFIELD_FIELD2))
{
....
}

Overrides:

extValidateField in class DBObject

Parameters:

field - The field to be validated

list - The validation list

Returns:

the error or warning.

Throws:

java.lang.Exception - a serious error