32.2. The dbform JSP tag

This diagram shows the interaction between the DbFormTag class and all the other classes that are used to render the data into the target jsp page.

32.2.1. Steps

  • The jsp page containing the dbform tag instantiates and initializes the DbFormTag class.

    The DbFormTag object gets the main table object, and checks if it has granted-privileges that make queries possible.

  • The DbFormTag object checks if the main table contains interceptor objects. If yes, process those objects calling their PRE_SELECT hook up method.

  • The DbFormTag object generates the HTML form.

  • The DbFormTag executes the initOverrulingOrder() method to overrule other default declarations eventually done into the XML configuration file. initOverrulingOrder() initialises the datastructures containing informations about how table should be ordered. The information is specified in the JSP this tags lives in. This declaration OVERRULES other default declarations eventually done into the XML configuration file.

  • The DbFormTag object sets the initial navigation position.

  • The DbFormTag object executes the checkLinkage() method to check if the fieldvalue-list related to the position strings for a certain subform is valid in the current state.

  • The DbFormTag object tries to retrieve from the request context the any previously instantiated WebEvent object. If the event doesn't exist, the DbFormTag object generates a new navigation event and then processes it.

    Note: the member localWebEvent action string is used to identify the navigation event type to instantiate.

  • The DbFormTag object checks if the main table contains interceptor objects. If yes, process those objects calling their POST_SELECT hook up method.

  • The DbFormTag object recalculates its cursor position.