Calyxo Action Forms

The Calyxo Forms component comes with its own tag library. This library contains custom tags related to the HTML form- and input tags. These tags directly access your form data, so form bean properties are ignored. To use these tags with Struts, you have to use the form bean class

de.odysseus.calyxo.struts.forms.CalyxoActionForm

or a subclass of it. The input values to be validated are directly taken from the request. Since CalyxoActionForm is a generic form class, Struts users should not derive from this class to add form bean properties as they are used to with ordinary action forms: the populated bean properties will neither be used as validation inputs, nor will the Calyxo Forms input tags pull their display values out of these properties.

Calyxo forms are declared in the Struts configuration file as usual:

<!DOCTYPE struts-config PUBLIC
  "-//Apache Software Foundation//DTD Struts Configuration 1.2//EN"
  "http://struts.apache.org/dtds/struts-config_1_2.dtd">

<struts-config>
  <form-beans>
    <form-bean
      name="loginForm"
      type="de.odysseus.calyxo.struts.forms.CalyxoActionForm"/>
    ...
  </form-beans>
  ...
</struts-config>

This also means, that you no longer need to implement dozens of form bean classes! The CalyxoActionForm class will keep the validated data in a map.