...
- It creates an instance of the appropriate * HtmlGeneratorElement * implementation and calls it's generateHtml(Context) method to generate the Html input fields to substitute for the tag. When a HtmlGeneratorElement is instantiated, it creates any widgets needed to render the element, and registers the widgets with the FormEntryContext.
- It creates an instance of the appropriate * FormSubmissionControllerAction * implementation implementation, and adds it to the FormSubmissionController. The FormSubmissonController will use this to handle the specifics of form submissions for this element.
...
That's a basic, but not exhaustive, overview of how the module work. We didn't discuss how obsgroups are implemented, or about the various classes in the schema package, among other things. Check out the javadocs for more information.
Custom Tags
For a good example of how to add a custom tag to the valid list of htmlformentry tags from another module (or, in other words, how to register a custom tag handler from another module), see the htmlformflowsheet moduleCustom tags can be registered by calling the HtmlFormEntryService addHandler method(). Modules can register new tags by calling this method... for an example, in the HTML Form Flowsheet module the onLoad() method in the HtmlFormFlowsheetActivator registers a handler for a new "htmlformflowsheet" tag. To create a custom tag, you will need to define implementations of TagHandler, HtmlGeneratorElement, and FormSubmissionControllerAction for this new tag. You can take a look at some of the existing tags for examples of how to do this.
Defining attribute descriptors for custom tags
...