Class Form


public class Form extends ClosingUIBean

Renders HTML an input form.

The remote form allows the form to be submitted without the page being refreshed. The results from the form can be inserted into any HTML element on the page.

NOTE:
The order / logic in determining the posting url of the generated HTML form is as follows:

  1. If the action attribute is not specified, then the current request will be used to determine the posting url
  2. If the action is given, Struts will try to obtain an ActionConfig. This will be successful if the action attribute is a valid action alias defined struts.xml.
  3. If the action is given and is not an action alias defined in struts.xml, Struts will used the action attribute as if it is the posting url, separting the namespace from it and using UrlHelper to generate the final url.

Examples

 

 <s:form ... />

 
 
  • Field Details

  • Constructor Details

    • Form

      public Form(ValueStack stack, jakarta.servlet.http.HttpServletRequest request, jakarta.servlet.http.HttpServletResponse response)
  • Method Details

    • evaluateNameValue

      protected boolean evaluateNameValue()
      Overrides:
      evaluateNameValue in class UIBean
    • getDefaultOpenTemplate

      public String getDefaultOpenTemplate()
      Specified by:
      getDefaultOpenTemplate in class ClosingUIBean
    • getDefaultTemplate

      protected String getDefaultTemplate()
      Description copied from class: UIBean
      A contract that requires each concrete UI Tag to specify which template should be used as a default. For example, the CheckboxTab might return "checkbox.vm" while the RadioTag might return "radio.vm". This value not begin with a '/' unless you intend to make the path absolute rather than relative to the current theme.
      Specified by:
      getDefaultTemplate in class UIBean
      Returns:
      The name of the template to be used as the default.
    • setConfiguration

      public void setConfiguration(Configuration configuration)
    • setObjectFactory

      public void setObjectFactory(ObjectFactory objectFactory)
    • setUrlRenderer

      public void setUrlRenderer(UrlRenderer urlRenderer)
    • setActionValidatorManager

      public void setActionValidatorManager(ActionValidatorManager mgr)
    • evaluateExtraParams

      protected void evaluateExtraParams()
      Overrides:
      evaluateExtraParams in class UIBean
    • populateComponentHtmlId

      protected void populateComponentHtmlId(Form form)
      Form component determine the its HTML element id as follows:-
      1. if an 'id' attribute is specified.
      2. if an 'action' attribute is specified, it will be used as the id.
      Overrides:
      populateComponentHtmlId in class UIBean
      Parameters:
      form - enclosing form tag
    • evaluateClientSideJsEnablement

      protected void evaluateClientSideJsEnablement(String actionName, String namespace, String actionMethod)
      Evaluate client side JavaScript Enablement.
      Parameters:
      actionName - the actioName to check for
      namespace - the namespace to check for
      actionMethod - the method to ckeck for
    • getValidators

      public List getValidators(String name)
    • getVisitorReturnType

      protected Class getVisitorReturnType(Class actionClass, String visitorFieldName)
      Return type of visited object.
      Parameters:
      actionClass - action class
      visitorFieldName - field name
      Returns:
      type of visited object
    • getSequence

      protected int getSequence()
      Get a incrementing sequence unique to this Form component. It is used by Form component's child that might need a sequence to make them unique.
      Returns:
      int
    • setOnsubmit

      public void setOnsubmit(String onsubmit)
    • setOnreset

      public void setOnreset(String onreset)
    • setAction

      public void setAction(String action)
    • setTarget

      public void setTarget(String target)
    • setEnctype

      public void setEnctype(String enctype)
    • setMethod

      public void setMethod(String method)
    • setNamespace

      public void setNamespace(String namespace)
    • setValidate

      public void setValidate(String validate)
    • setPortletMode

      public void setPortletMode(String portletMode)
    • setWindowState

      public void setWindowState(String windowState)
    • setAcceptcharset

      public void setAcceptcharset(String acceptcharset)
    • setFocusElement

      public void setFocusElement(String focusElement)
    • setIncludeContext

      public void setIncludeContext(boolean includeContext)