Package org.javarosa.core.model

Class Fast2014DagImpl

java.lang.Object

org.javarosa.core.model.IDag

org.javarosa.core.model.LatestDagBase

org.javarosa.core.model.Fast2014DagImpl

public class Fast2014DagImpl
extends LatestDagBase

The fast (Latest_fastest) eval logic for 2014

Author:

mitchellsundt@gmail.com, meletis@surveycto.com

Nested Class Summary

Nested classes/interfaces inherited from class org.javarosa.core.model.IDag

IDag.EventNotifierAccessor

Field Summary

Fields inherited from class org.javarosa.core.model.IDag

accessor, conditionRepeatTargetIndex, triggerablesDAG, triggerIndex, unorderedTriggerables

Constructor Summary

Constructors

Constructor	Description
Fast2014DagImpl(IDag.EventNotifierAccessor accessor)

Method Summary

Modifier and Type	Method	Description
void	addChildrenOfReference(FormInstance mainInstance, EvaluationContext evalContext, TreeReference original, Set<TreeReference> toAdd, boolean expandRepeatables)	This is a utility method to get all of the references of a node.
void	copyItemsetAnswer(FormInstance mainInstance, EvaluationContext evalContext, TreeReference copyRef, TreeElement copyToElement, boolean midSurvey)	Take actions related to changes of select-one and select-multiple itemsets.
void	createRepeatGroup(FormInstance mainInstance, EvaluationContext evalContext, TreeReference createRef, TreeElement parentElement, TreeElement createdElement)	Take whatever action is required when creating a repeat group.
void	deleteRepeatGroup(FormInstance mainInstance, EvaluationContext evalContext, TreeReference deleteRef, TreeElement parentElement, TreeElement deletedElement)	Take whatever action is required when deleting a repeat group.
void	fillTriggeredElements(FormInstance mainInstance, EvaluationContext evalContext, QuickTriggerable qt, Set<QuickTriggerable> destinationSet, Set<QuickTriggerable> newDestinationSet, boolean midSurvey)	Get all of the elements which will need to be evaluated (in order) when the triggerable is fired.
void	finalizeTriggerables(FormInstance mainInstance, EvaluationContext evalContext)	Finalize the DAG associated with the form's triggered conditions.
FormDef.EvalBehavior	getEvalBehavior()	The EvalBehavior that the implementation provides.
QuickTriggerable	getTriggerableForRepeatGroup(TreeReference repeatRef)	Used to obtain the triggerable that impacts the relevancy of the repeat group.
Collection<QuickTriggerable>	initializeTriggerables(FormInstance mainInstance, EvaluationContext evalContext, TreeReference rootRef, boolean midSurvey)	Walks the current set of conditions, and evaluates each of them with the current context.
boolean	shouldTrustPreviouslyCommittedAnswer()	Specifies if unchanged answers should be trusted (and not re-committed).
Collection<QuickTriggerable>	triggerTriggerables(FormInstance mainInstance, EvaluationContext evalContext, TreeReference ref, boolean midSurvey)	The entry point for the DAG cascade after a value is changed in the model.

Methods inherited from class org.javarosa.core.model.LatestDagBase

doEvaluateTriggerables

Methods inherited from class org.javarosa.core.model.IDag

addTriggerable, getConditionExpressionForTrueAction, getConditions, getRecalculates, printTriggerables, publishSummary, publishSummary, reportDependencyCycles, validate

Methods inherited from class java.lang.Object

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

Constructor Details

Fast2014DagImpl

public Fast2014DagImpl(IDag.EventNotifierAccessor accessor)

Method Details

getEvalBehavior

public FormDef.EvalBehavior getEvalBehavior()

Description copied from class: IDag

The EvalBehavior that the implementation provides.

Specified by:

getEvalBehavior in class IDag

Returns:

getTriggerableForRepeatGroup

public QuickTriggerable getTriggerableForRepeatGroup(TreeReference repeatRef)

Description copied from class: IDag

Used to obtain the triggerable that impacts the relevancy of the repeat group.

Specified by:

getTriggerableForRepeatGroup in class IDag

Returns:

deleteRepeatGroup

public void deleteRepeatGroup(FormInstance mainInstance, EvaluationContext evalContext, TreeReference deleteRef, TreeElement parentElement, TreeElement deletedElement)

Description copied from class: IDag

Take whatever action is required when deleting a repeat group.

Specified by:

deleteRepeatGroup in class IDag

createRepeatGroup

public void createRepeatGroup(FormInstance mainInstance, EvaluationContext evalContext, TreeReference createRef, TreeElement parentElement, TreeElement createdElement)

Description copied from class: IDag

Take whatever action is required when creating a repeat group.

Specified by:

createRepeatGroup in class IDag

copyItemsetAnswer

public void copyItemsetAnswer(FormInstance mainInstance, EvaluationContext evalContext, TreeReference copyRef, TreeElement copyToElement, boolean midSurvey)

Description copied from class: IDag

Take actions related to changes of select-one and select-multiple itemsets.

Specified by:

copyItemsetAnswer in class IDag

finalizeTriggerables

public void finalizeTriggerables(FormInstance mainInstance, EvaluationContext evalContext) throws IllegalStateException

Finalize the DAG associated with the form's triggered conditions. This will create the appropriate ordering and dependencies to ensure the conditions will be evaluated in the appropriate orders.

Specified by:

finalizeTriggerables in class IDag

Throws:

IllegalStateException - - If the trigger ordering contains an illegal cycle and the triggers can't be laid out appropriately

fillTriggeredElements

public void fillTriggeredElements(FormInstance mainInstance, EvaluationContext evalContext, QuickTriggerable qt, Set<QuickTriggerable> destinationSet, Set<QuickTriggerable> newDestinationSet, boolean midSurvey)

Get all of the elements which will need to be evaluated (in order) when the triggerable is fired.

Parameters:

qt -

destinationSet - where to store the triggerables

midSurvey - if true, then the slow code will execute, if false, then old/fast code will execute that suffers from https://code.google.com/p/opendatakit/issues/detail?id=888

addChildrenOfReference

public void addChildrenOfReference(FormInstance mainInstance, EvaluationContext evalContext, TreeReference original, Set<TreeReference> toAdd, boolean expandRepeatables)

This is a utility method to get all of the references of a node. It can be replaced when we support dependent XPath Steps (IE: /path/to//)

initializeTriggerables

public Collection<QuickTriggerable> initializeTriggerables(FormInstance mainInstance, EvaluationContext evalContext, TreeReference rootRef, boolean midSurvey)

Walks the current set of conditions, and evaluates each of them with the current context.

Specified by:

initializeTriggerables in class IDag

midSurvey - true if we are during the survey, false if we are on loading/saving phase

triggerTriggerables

public Collection<QuickTriggerable> triggerTriggerables(FormInstance mainInstance, EvaluationContext evalContext, TreeReference ref, boolean midSurvey)

The entry point for the DAG cascade after a value is changed in the model.

Specified by:

triggerTriggerables in class IDag

Parameters:

ref - The full contextualized unambiguous reference of the value that was changed.

shouldTrustPreviouslyCommittedAnswer

public boolean shouldTrustPreviouslyCommittedAnswer()

Description copied from class: IDag

Specifies if unchanged answers should be trusted (and not re-committed).

Specified by:

shouldTrustPreviouslyCommittedAnswer in class IDag

Returns: