...
All the above steps happen during the instantiation of the FormEntrySession, so, to display form, a web controller can simply instantiate a FormEntrySession- – passing as parameters the patient, encounter, mode (read, enter, or edit), and the HtmlForm to use -– and then use the FormEntrySession as a backing object. The field htmlToDisplay of the FormEntrySession will contain the html to display in the view.
...
Significantly, the handleFormSubmission methods don't directly commit the changes to the database. Instead each FormSubmissionControllerAction adds the needed actions to commit the changes to the FormSubmissionActions instance associated with the session. (Yes, this is a little confusing … ... there are two types of actions… actions... a FormSubmissionControllerAction creates a new action, or set of actions, that are stored in FormSubmissionActions).
...