org.sandev.basics.util
Class UIFormContext

java.lang.Object
  org.sandev.basics.structs.UIFormInitializerStruct
      org.sandev.basics.sandmessages.UIFormInitializer
          org.sandev.basics.util.UIFormContext

All Implemented Interfaces:

Resolvable, SandInstanceMessage, SandMessage, SandStructMessage

public class UIFormContext

extends UIFormInitializer

A contract between a user interface and the system. The atomic application input and output is defined via SAND messages. This class captures the context surrounding these atomic actions to enable intuitive traversal and manipulation of data.

The class is structured around UI interaction with the system through a form. For examples of typical system interactions, and an overview of this class, see UIGen.html

Field Summary

protected java.lang.String	displayContext A UI dependent string indicating the environment this form context exists in.
protected java.lang.Object	displayState A UI dependent instance providing access to the overall display processing state.
protected java.util.Locale	locale The locale we are working with.
protected java.lang.String	openLocation A URL to be opened.
protected java.util.Map	parameterMap A map of parameter names to values which provides access to all link parameters.
protected boolean	pendingEdits Provides a flag for tracking if there are outstanding edits which need to be saved to disk.
protected java.lang.String	selectionField An output directive telling the UI display which field in the current instance should be selected.
protected boolean[]	supportedActions A flag array indicating which actions are supported and which are not.
protected AggregateUpdate	updates Outstanding updates necessary for save processing.
protected long	userID The uniqueID of the current user.

Fields inherited from class org.sandev.basics.sandmessages.UIFormInitializer

ACTION_ADD, ACTION_CANCEL, ACTION_CUSTOM, ACTION_DELETE, ACTION_DEREF, ACTION_DRILLDOWN, ACTION_EDIT, ACTION_FIND, ACTION_HELP, ACTION_INIT, ACTION_MOVEDOWN, ACTION_MOVEUP, ACTION_NEW, ACTION_NEXT, ACTION_OK, ACTION_PARENT, ACTION_PREVIOUS, ACTION_REMOVE, ACTION_SAVE, ACTION_SELECT, ACTION_UNDEFINED, MODESTACK_ADDING, MODESTACK_FINDING, MODESTACK_LISTING, MODESTACK_UNDEFINED, MODESTACK_UPDATING

Fields inherited from class org.sandev.basics.structs.UIFormInitializerStruct

action, currClass, currInst, findCollection, findCollIndex, findCollMaxDisplay, findKeys, findQuery, modeStack, outputText, position, rootMsg, userQuery

Fields inherited from interface org.sandev.basics.structs.SandInstanceMessage

FIELDCHECK_INVALIDVAL, FIELDCHECK_NOTAREF, FIELDCHECK_NOTINRANGE, FIELDCHECK_NULLARRAY, FIELDCHECK_STRINGOVER, FIELDCHECK_UNKNOWNVAL, FIELDFLAG_BINARY, FIELDFLAG_ENCRYPT, FIELDFLAG_INTERNAL, FIELDFLAG_NOECHO, FIELDFLAG_OBFUSCATE, FIELDFLAG_STRINGPERSIST, FIELDFLAG_UNIQUE, GENMOD_ACTION_APPEND, GENMOD_ACTION_INSERT, GENMOD_ACTION_REMOVE, GENMOD_ACTION_SET

Constructor Summary

UIFormContext()
default ctor calls init

Method Summary

boolean	actionSupported(int action) Returns true if this action is currently supported, false otherwise.
void	addCurrInstToParentColl() Add the currInst to our findCollection.
void	addOutputText(java.lang.String text) Convenience append method.
boolean	atTopLevel() Returns true if we are at the root display for the form.
UIFormContext	cloneContext() Return a copy of this UIFormContext instance.
void	copyValuesFrom(UIFormContext uifc) Copy all the values from the given UIFormContext.
static void	debugDump(java.lang.String headerline, UIFormContext uifc) Dump this form context to the standard output.
static void	debugDump(UIFormContext uifc) Dump this form context to the standard output with a default header.
static void	debugout(java.lang.String text) Used for all debug output.
void	disableAction(int action) Disables a specific form action.
void	disableActionsFromContext() Disables all top level actions that are not appropriate given the current context.
static java.lang.String	dumpQuery(SandQueryMessage sqm) Returns the match expression as a String.
static java.lang.String	dumpUIFormQuery(UIFormQuery uiq)
void	evalPosition() Set our currInst and currClass the position and rootMsg information.
static java.lang.String	getAccessMethodForField(java.lang.String field) return the name of the access method for the given field
static java.lang.String	getAppendMethodForField(java.lang.String field) return the name of the append method for the given field
static int	getArrayIndex(java.lang.String posentry) Given a position entry, return the array index it is referencing or -2 if it is not referencing an array.
static java.lang.String	getArraySetMethodForField(java.lang.String field) return the name of the array set method for the given field
static java.lang.String	getArraySuffix(java.lang.String value) Convenience method for returning just the array index suffix of a given string.
java.lang.String	getCurrentField() Return the name of the field we are currently positioned at.
int	getCurrentFieldIndex() Returns the array index of the current field, or -2 if this field is not an array.
SandInstanceMessage	getCurrentObject() Walk the position and msg variables to find the message instance corresponding to the last position entry.
SandInstanceMessage	getCurrentParent() Walk the position and msg variables to find the message instance corresponding to the second-to-last position entry.
java.lang.String	getDisplayClass() Return the current class we are working with.
java.lang.String	getDisplayContext() accessor for displayContext
java.lang.Object	getDisplayState() accessor for displayState
java.lang.String	getFindKeysPath() Return the findKeys array as a dot separated string.
static java.lang.String	getInsertMethodForField(java.lang.String field) return the name of the insert method for the given field
SandInstanceMessage	getInstanceAtPosition(SandInstanceMessage source, int index) Walk the position stack down to the specified index and return the referenced object.
java.lang.String	getLastPositionEntry() Returns the last element in the position stack.
java.util.Locale	getLocale() accessor for locale
int	getMode() Equivalent to lastModeStack.
java.lang.String	getModePath() Returns the modeStack array as a dot separated string.
java.lang.String	getOpenLocation() accessor for openLocation
java.lang.String	getParam(java.lang.String key) Utility for retrieving single-valued string parameters from our parameterMap.
java.util.Map	getParameterMap() accessor for parameterMap
boolean	getPendingEdits() accessor for pendingEdits
java.lang.String	getPositionPath() Return the position as a dot separated string.
SandInstanceMessage	getReferencedObject(SandInstanceMessage obj, java.lang.String posentry) Given an object reference, and the name of a field within the object which may have array indices at the end, return the referenced object.
static java.lang.String	getRemoveMethodForField(java.lang.String field) return the name of the remove method for the given field
java.lang.String	getSelectionField() accessor for selectionField
static java.lang.String	getSetMethodForField(java.lang.String field) return the name of the set method for the given field
boolean[]	getSupportedActions() accessor for supportedActions.
AggregateUpdate	getUpdates() accessor for updates
long	getUserID() accessor for userID
boolean	hasPendingEdits() accessor for pendingEdits
void	init() Initialize this form context to the default values.
void	initCollectionDisplay(java.lang.String dispClass, SandCollectionMessage coll) Set up this initialized form context to display a collection.
void	initInstanceDisplay(SandInstanceMessage sim) Set up the form context to display the specified instance.
void	initPosition(java.lang.String pos) Sets the position to a new array containing only the specified value.
boolean	isCollectionView() Return true if we are currently displaying a collection.
boolean	isFindCollectionView() Return true if we are currently displaying a find collection.
boolean	isFormManagerAction() Return true if the current action is expected to be handled by a UIFormManager implementation, false otherwise.
boolean	isUninitialized() Return true if this form context is uninitialized.
void	normalizeReferences() Make equivalent data point to the same object.
static java.lang.String	removeArrayIndex(java.lang.String value) Convenience method for removing any array index brackets from a given string field value.
void	resetToCollection() This method factors the calls needed to nuke whatever context is captured in the uifc, in preparation for initializing it with a collection display.
void	resolveTransactionResults(AggregateUpdate oldUpdate, AggregateUpdate newUpdate, java.lang.String source) Walk the old updates and the new updates, resolving any data against the new values.
void	setDisplayContext(java.lang.String val) mutator for displayContext
void	setDisplayState(java.lang.Object val) mutator for displayState
void	setFindKeysPath(java.lang.String path) Set the findKeys array from the given dot separated string.
void	setLocale(java.util.Locale loc) mutator for locale
void	setModePath(java.lang.String path) Set the modeStack array from the given dot separated string.
void	setOpenLocation(java.lang.String val) mutator for openLocation
void	setParameterMap(java.util.Map pmap) mutator for parameterMap
void	setPendingEdits(boolean val) mutator for pendingEdits
void	setPositionPath(java.lang.String pos) Set the position array from the given dot separated string.
void	setSelectionField(java.lang.String val) mutator for selectionField
void	setSupportedActions(boolean[] val) mutator for supportedActions.
void	setUpdates(AggregateUpdate val) mutator for updates
void	setUserID(long ID) mutator for userID
void	trimLastUpdate() Removes the last update message from the aggregate.
void	upOneLevel() Moves the entire context up one level, discarding any current working text or object.

Methods inherited from class org.sandev.basics.sandmessages.UIFormInitializer

actionActual2Print, actionLabelToValue, actionPrint2Actual, actionPrint2Key, actionValueToLabel, addFindKeys, addFindKeys, addModeStack, addModeStack, addPosition, addPosition, clearFindKeys, clearModeStack, clearPosition, cloneMessage, cloneUIFormInitializer, convertToSuperstructClass, copyDataFrom, copyFieldValue, debugDump, defaultField, fieldHasFlag, fieldsValid, fieldValidate, findKeysContains, findKeysIndexOf, generalAccessor, generalDereference, generalModifier, getAction, getActionActualVals, getActionDefaultValue, getActionEnumSummary, getActionFieldPrintValue, getActionFlag, getActionInvalidValue, getActionKeyVals, getActionMetatype, getActionPrintVals, getActionPrintValue, getActionRange, getActionValidityCheck, getAllFields, getCollectionMessage, getCurrClass, getCurrClassDefaultValue, getCurrClassFieldPrintValue, getCurrClassFlag, getCurrClassInvalidValue, getCurrClassLengthMax, getCurrClassLengthNorm, getCurrClassMetatype, getCurrClassPrintValue, getCurrClassRange, getCurrClassValidityCheck, getCurrInst, getCurrInstDefaultValue, getCurrInstFieldPrintValue, getCurrInstFlag, getCurrInstInvalidValue, getCurrInstMetatype, getCurrInstPrintValue, getCurrInstRange, getCurrInstValidityCheck, getDisplayFields, getDisplayValues, getDisplayValues, getFindCollection, getFindCollectionDefaultValue, getFindCollectionFieldPrintValue, getFindCollectionFlag, getFindCollectionInvalidValue, getFindCollectionMetatype, getFindCollectionPrintValue, getFindCollectionRange, getFindCollectionValidityCheck, getFindCollIndex, getFindCollIndexDefaultValue, getFindCollIndexFieldPrintValue, getFindCollIndexFlag, getFindCollIndexInvalidValue, getFindCollIndexMetatype, getFindCollIndexPrintValue, getFindCollIndexRange, getFindCollIndexValidityCheck, getFindCollMaxDisplay, getFindCollMaxDisplayDefaultValue, getFindCollMaxDisplayFieldPrintValue, getFindCollMaxDisplayFlag, getFindCollMaxDisplayInvalidValue, getFindCollMaxDisplayMetatype, getFindCollMaxDisplayPrintValue, getFindCollMaxDisplayRange, getFindCollMaxDisplayValidityCheck, getFindKeys, getFindKeys, getFindKeysDefaultValue, getFindKeysElementInvalidValue, getFindKeysFlag, getFindKeysInvalidValue, getFindKeysLengthMax, getFindKeysLengthNorm, getFindKeysMetatype, getFindKeysRange, getFindKeysValidityCheck, getFindQuery, getFindQueryDefaultValue, getFindQueryFieldPrintValue, getFindQueryFlag, getFindQueryInvalidValue, getFindQueryMetatype, getFindQueryPrintValue, getFindQueryRange, getFindQueryValidityCheck, getModeStack, getModeStack, getModeStackActualVals, getModeStackDefaultValue, getModeStackElementInvalidValue, getModeStackEnumSummary, getModeStackFlag, getModeStackInvalidValue, getModeStackKeyVals, getModeStackMetatype, getModeStackPrintVals, getModeStackRange, getModeStackValidityCheck, getOutputText, getOutputTextDefaultValue, getOutputTextFieldPrintValue, getOutputTextFlag, getOutputTextInvalidValue, getOutputTextLengthMax, getOutputTextLengthNorm, getOutputTextMetatype, getOutputTextPrintValue, getOutputTextRange, getOutputTextValidityCheck, getPosition, getPosition, getPositionDefaultValue, getPositionElementInvalidValue, getPositionFlag, getPositionInvalidValue, getPositionLengthMax, getPositionLengthNorm, getPositionMetatype, getPositionRange, getPositionValidityCheck, getQueryMessage, getRootMsg, getRootMsgDefaultValue, getRootMsgFieldPrintValue, getRootMsgFlag, getRootMsgInvalidValue, getRootMsgMetatype, getRootMsgPrintValue, getRootMsgRange, getRootMsgValidityCheck, getShortName, getStructMessage, getUpdateMessage, getUserQuery, getUserQueryDefaultValue, getUserQueryFieldPrintValue, getUserQueryFlag, getUserQueryInvalidValue, getUserQueryMetatype, getUserQueryPrintValue, getUserQueryRange, getUserQueryValidityCheck, getValueForFieldName, insertFindKeys, insertModeStack, insertPosition, isEquivalent, lastFindKeys, lastModeStack, lastPosition, modeStackActual2Print, modeStackContains, modeStackIndexOf, modeStackLabelToValue, modeStackPrint2Actual, modeStackPrint2Key, modeStackValueToLabel, popFindKeys, popModeStack, popPosition, positionContains, positionIndexOf, pushFindKeys, pushModeStack, pushPosition, referenceValidate, removeFindKeys, removeFindKeysValue, removeModeStack, removeModeStackValue, removePosition, removePositionValue, setAction, setCurrClass, setCurrClass, setCurrInst, setCurrInst, setFindCollection, setFindCollection, setFindCollIndex, setFindCollMaxDisplay, setFindKeys, setFindKeys, setFindQuery, setFindQuery, setModeStack, setModeStack, setOutputText, setOutputText, setPosition, setPosition, setRootMsg, setRootMsg, setUserQuery, setUserQuery, sizeofFindKeys, sizeofModeStack, sizeofPosition, toString

Methods inherited from class java.lang.Object

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

Field Detail

pendingEdits

protected boolean pendingEdits

Provides a flag for tracking if there are outstanding edits which need to be saved to disk. If you set this to false, any pending updates will be dropped as well.

updates

protected AggregateUpdate updates

Outstanding updates necessary for save processing. This is typically populated by the UIFormManager and maintained as part of the form context to enable save processing.

By using ACTION_OK to accumulate updates without committing them, a user can generate a transaction where several updates are done at once. If ACTION_OK is disabled, then they user saves as they go, so the number of outstanding updates will be limited to new references from the current instance.

userID

protected long userID

The uniqueID of the current user. This is useful for holding onto who the user is after the initial lookup. Each request must still be authenticated, but with the ID this can be a cache lookup. The value starts out as zero.

locale

protected java.util.Locale locale

The locale we are working with. Used for loading resources during processing by the UIFormOwner (not part of the serialized form).

displayContext

protected java.lang.String displayContext

A UI dependent string indicating the environment this form context exists in. For a SandUI, this is the name of the screen followed by a dot followed by the name of the link (form or text). This provides a unique display value which can be used for localized text lookup.

displayState

protected java.lang.Object displayState

A UI dependent instance providing access to the overall display processing state. For a SandUI, this is the working copy of the Screen instance, which can be traversed to reference the formState of another Link.

parameterMap

protected java.util.Map parameterMap

A map of parameter names to values which provides access to all link parameters. This method may return the the same map used by UIRenderInput, but is not required to.

supportedActions

protected boolean[] supportedActions

A flag array indicating which actions are supported and which are not. By default all actions are supported. To disable an action set the associated flag to false by calling disableAction.

Specific actions can be disabled, but not enabled, during processing. Essentially actions which are not applicable, or which are not authorized, are turned off by setting them to false in this array. The supportedActions are reinitialized for each request, and then restricted by the UIFormManager and the UIFormAdaptor based on the mode and authorization.

A UI may completely disable a command by setting it to false before passing it to the UIFormManager. This can be used to create limited functionality forms.

selectionField

protected java.lang.String selectionField

An output directive telling the UI display which field in the current instance should be selected. Only really used while editing or adding. For something like a text field, this would typically set the focus to that field. For something like an array, the name is followed by the array index and would result in that index being set as selected.

openLocation

protected java.lang.String openLocation

A URL to be opened. The specified URL may be opened in a new browser window, or within the current browser window if this is a web UI.

Constructor Detail

UIFormContext

public UIFormContext()

default ctor calls init

Method Detail

hasPendingEdits

public boolean hasPendingEdits()

accessor for pendingEdits

getPendingEdits

public boolean getPendingEdits()

accessor for pendingEdits

setPendingEdits

public void setPendingEdits(boolean val)

mutator for pendingEdits

getUpdates

public AggregateUpdate getUpdates()

accessor for updates

setUpdates

public void setUpdates(AggregateUpdate val)

mutator for updates

trimLastUpdate

public void trimLastUpdate()

Removes the last update message from the aggregate.

getUserID

public long getUserID()

accessor for userID

setUserID

public void setUserID(long ID)

mutator for userID

getLocale

public java.util.Locale getLocale()

accessor for locale

setLocale

public void setLocale(java.util.Locale loc)

mutator for locale

getDisplayContext

public java.lang.String getDisplayContext()

accessor for displayContext

setDisplayContext

public void setDisplayContext(java.lang.String val)

mutator for displayContext

getDisplayState

public java.lang.Object getDisplayState()

accessor for displayState

setDisplayState

public void setDisplayState(java.lang.Object val)

mutator for displayState

getParameterMap

public java.util.Map getParameterMap()

accessor for parameterMap

setParameterMap

public void setParameterMap(java.util.Map pmap)

mutator for parameterMap

getParam

public java.lang.String getParam(java.lang.String key)

Utility for retrieving single-valued string parameters from our parameterMap. Note that all hardcoded Strings within java code are automatically interned by the compiler, which enables fast lookup. If the key passed in here is not interned, then this method may not find it. Returns the value of the given parameter if found, null otherwise.

getSupportedActions

public boolean[] getSupportedActions()

accessor for supportedActions. This initializes supportedActions if necessary, with all actions enabled.

setSupportedActions

public void setSupportedActions(boolean[] val)

mutator for supportedActions. Since the UIFormContext functions as a workspace, this method makes a copy of the given array. This prevents any inadvertent modifications to the reference passed as a parameter.

If the array given is null, or the length of the array is not ACTION_HELP+1, then the call is ignored.

actionSupported

public boolean actionSupported(int action)

Returns true if this action is currently supported, false otherwise.

if(actionSupported(UIFormContext.ACTION_HELP))

disableAction

public void disableAction(int action)

Disables a specific form action.

formContext.disableAction(UIFormContext.ACTION_HELP)

disableActionsFromContext

public void disableActionsFromContext()

Disables all top level actions that are not appropriate given the current context. The top level actions are:

• ACTION_PARENT
• ACTION_EDIT
• ACTION_ADD
• ACTION_DELETE
• ACTION_FIND
• ACTION_CANCEL
• ACTION_SAVE
• ACTION_NEXT
• ACTION_PREVIOUS
• ACTION_OK
• ACTION_HELP

ACTION_HELP is not necessarily context dependent, so it is not modified here. It is up to specific form adaptors/owners to enable or disable help appropriately.

getSelectionField

public java.lang.String getSelectionField()

accessor for selectionField

setSelectionField

public void setSelectionField(java.lang.String val)

mutator for selectionField

getOpenLocation

public java.lang.String getOpenLocation()

accessor for openLocation

setOpenLocation

public void setOpenLocation(java.lang.String val)

mutator for openLocation

init

public void init()

Initialize this form context to the default values. By default we start in MODE_LISTING. This calls getSupportedActions to trigger initialization of supported actions.

Overrides:

init in class UIFormInitializer

getMode

public int getMode()

Equivalent to lastModeStack.

getModePath

public java.lang.String getModePath()

Returns the modeStack array as a dot separated string. This is useful for debugging and to support stack tail checking logic.

setModePath

public void setModePath(java.lang.String path)

Set the modeStack array from the given dot separated string. This essentially reconstructs the stack from the path form.

initPosition

public void initPosition(java.lang.String pos)

Sets the position to a new array containing only the specified value. Equivalent to setPositionPath(pos).

getPositionPath

public java.lang.String getPositionPath()

Return the position as a dot separated string.

setPositionPath

public void setPositionPath(java.lang.String pos)

Set the position array from the given dot separated string.

getFindKeysPath

public java.lang.String getFindKeysPath()

Return the findKeys array as a dot separated string.

setFindKeysPath

public void setFindKeysPath(java.lang.String path)

Set the findKeys array from the given dot separated string.

addOutputText

public void addOutputText(java.lang.String text)

Convenience append method. Each subsequent call to this method appends a newline as a delimiter between calls.

debugDump

public static void debugDump(UIFormContext uifc)

Dump this form context to the standard output with a default header.

debugDump

public static void debugDump(java.lang.String headerline,
                             UIFormContext uifc)

Dump this form context to the standard output. This method is static so it can be used with null form context references.

dumpQuery

public static java.lang.String dumpQuery(SandQueryMessage sqm)

Returns the match expression as a String. Used for debug dump.

dumpUIFormQuery

public static java.lang.String dumpUIFormQuery(UIFormQuery uiq)

debugout

public static void debugout(java.lang.String text)

Used for all debug output. If singleton access to a Logger instance is standardized, then this method should use that mechanism. For now this just wraps System.out.println.

getDisplayClass

public java.lang.String getDisplayClass()

Return the current class we are working with. This method makes a best guess using the current class and the display state.

getCurrentParent

public SandInstanceMessage getCurrentParent()

Walk the position and msg variables to find the message instance corresponding to the second-to-last position entry. This is the parent of the instance currently being edited, which is necessary for insert/append/remove operations. Note that by default this works off the root message.

If the current message has no parent, then this method returns null. That's necessary as a termination point, and to distinguish if you are editing the root directly.

getCurrentObject

public SandInstanceMessage getCurrentObject()

Walk the position and msg variables to find the message instance corresponding to the last position entry. This is necessary to get the current information for editing.

NOTE: This method returns the current instance, which may be the same as the value returned by getCurrInst() if you are adding a new instance.

getInstanceAtPosition

public SandInstanceMessage getInstanceAtPosition(SandInstanceMessage source,
                                                 int index)

Walk the position stack down to the specified index and return the referenced object. If not possible, return null.

getCurrentField

public java.lang.String getCurrentField()

Return the name of the field we are currently positioned at. This is the last string in the position, with any array reference brackets trimmed off.

getLastPositionEntry

public java.lang.String getLastPositionEntry()

Returns the last element in the position stack.

getCurrentFieldIndex

public int getCurrentFieldIndex()

Returns the array index of the current field, or -2 if this field is not an array.

upOneLevel

public void upOneLevel()

Moves the entire context up one level, discarding any current working text or object. This method modifies the position and then calls evalPosition to set the other elements accordingly

evalPosition

public void evalPosition()

Set our currInst and currClass the position and rootMsg information. Essentially we traverse the rootMsg according to the position and then update the currInst and currClass from the instance information there.

If there is no object for the last field (as can happen when you are adding a new element), then the currInst is set to null, and nothing is done with the currClass. The presumption is that the currClass will already have been set to something reasonable.

atTopLevel

public boolean atTopLevel()

Returns true if we are at the root display for the form. Being at the root display means we are either:

• displaying a top level collection (sizeofPosition is 0)
• displaying the top level object (sizeofPosition is 1) and we have not just selected something.
• about to process ok/save and return to listing

This method is somewhat heuristic in that if a save fails, then you won't really be back at the top level yet. But under normal processing you would be.

normalizeReferences

public void normalizeReferences()

Make equivalent data point to the same object. To support cancel operations (and context over time), the currInst, rootMsg, findCollection and updates normally have separate object information even if they are referring to the same data. But when processing a save operation, uniqueID values are assigned to new instances, and these values need to be reflected in the rest of the context. The easiest way to make sure things stay consistent is to make all the references point to the same actual object instances.

Once the UIFormContext is serialized into display form and reconstructed, the references will all point to separate object instances again. Since the display is refreshed at the conclusion of save processing, this consolidation is short lived.

This method assumes that we are about to save (so pendingEdits is true) and uses the information in the updates as its base reference. If updates is null or empty, this method does nothing.

resolveTransactionResults

public void resolveTransactionResults(AggregateUpdate oldUpdate,
                                      AggregateUpdate newUpdate,
                                      java.lang.String source)

Walk the old updates and the new updates, resolving any data against the new values. If a source is specified, then any new updates not matching the source are ignored. This allows processing to ignore any other updates that were inserted into the transaction to enforce application logic.

isFormManagerAction

public boolean isFormManagerAction()

Return true if the current action is expected to be handled by a UIFormManager implementation, false otherwise.

isUninitialized

public boolean isUninitialized()

Return true if this form context is uninitialized. This method returns true if:

• the action is UNDEFINED
• no userQuery is defined
• the position is empty (there is no current instance)
• there is no find collection (there is no current collection)

isCollectionView

public boolean isCollectionView()

Return true if we are currently displaying a collection.

isFindCollectionView

public boolean isFindCollectionView()

Return true if we are currently displaying a find collection.

resetToCollection

public void resetToCollection()

This method factors the calls needed to nuke whatever context is captured in the uifc, in preparation for initializing it with a collection display.

initCollectionDisplay

public void initCollectionDisplay(java.lang.String dispClass,
                                  SandCollectionMessage coll)

Set up this initialized form context to display a collection.

initInstanceDisplay

public void initInstanceDisplay(SandInstanceMessage sim)

Set up the form context to display the specified instance.

addCurrInstToParentColl

public void addCurrInstToParentColl()

Add the currInst to our findCollection. If the instance is not already there, then it is added. If it is already there, then the instance is replaced with the currInst. This method is called when a new instance is added or changed, to reflect these changes in the current working collection.

This method does not check if the currInst matches the parameters in the find query. There are two reasons for this:

1. The query may have been reset while the collection was still available (for example finding a sub reference).
2. Even if the new instance does not match, it's still usually better to show it.

cloneContext

public UIFormContext cloneContext()

Return a copy of this UIFormContext instance.

copyValuesFrom

public void copyValuesFrom(UIFormContext uifc)

Copy all the values from the given UIFormContext. Essentially this sets this UIFormContext equal to the given uifc.

removeArrayIndex

public static java.lang.String removeArrayIndex(java.lang.String value)

Convenience method for removing any array index brackets from a given string field value.

getArraySuffix

public static java.lang.String getArraySuffix(java.lang.String value)

Convenience method for returning just the array index suffix of a given string. This method returns the empty string if it is unable to find a suffix.

getArrayIndex

public static int getArrayIndex(java.lang.String posentry)

Given a position entry, return the array index it is referencing or -2 if it is not referencing an array. The return value is -2 because -1 is used as an index specification on an ACTION_ADD that is appending a new value.

getAccessMethodForField

public static java.lang.String getAccessMethodForField(java.lang.String field)

return the name of the access method for the given field

getSetMethodForField

public static java.lang.String getSetMethodForField(java.lang.String field)

return the name of the set method for the given field

getArraySetMethodForField

public static java.lang.String getArraySetMethodForField(java.lang.String field)

return the name of the array set method for the given field

getInsertMethodForField

public static java.lang.String getInsertMethodForField(java.lang.String field)

return the name of the insert method for the given field

getAppendMethodForField

public static java.lang.String getAppendMethodForField(java.lang.String field)

return the name of the append method for the given field

getRemoveMethodForField

public static java.lang.String getRemoveMethodForField(java.lang.String field)

return the name of the remove method for the given field

getReferencedObject

public SandInstanceMessage getReferencedObject(SandInstanceMessage obj,
                                               java.lang.String posentry)

Given an object reference, and the name of a field within the object which may have array indices at the end, return the referenced object.