Class FieldError

  extended by org.apache.struts2.components.Component
      extended by org.apache.struts2.components.UIBean
          extended by org.apache.struts2.components.FieldError
All Implemented Interfaces:

public class FieldError
extends UIBean
implements Param.UnnamedParametric

Render field errors if they exists. Specific layout depends on the particular theme. The field error strings will be html escaped by default.



    <!-- example 1 -->
    <s:fielderror />

    <!-- example 2 -->
    <s:form .... >


          <s:param value="%{'field1'}" />
          <s:param value="%{'field2'}" />
    <s:form .... >


    <s:fielderror fieldName="field1" />




 Example 1: display all field errors

Example 2: display field errors only for 'field1' and 'field2'

Field Summary
private  List<String> errorFieldNames
private  boolean escape
private static String TEMPLATE
Fields inherited from class org.apache.struts2.components.UIBean
accesskey, cssClass, cssErrorClass, cssErrorStyle, cssStyle, defaultTemplateDir, defaultUITheme, disabled, dynamicAttributes, id, javascriptTooltip, key, label, labelPosition, labelSeparator, name, onblur, onchange, onclick, ondblclick, onfocus, onkeydown, onkeypress, onkeyup, onmousedown, onmousemove, onmouseout, onmouseover, onmouseup, onselect, request, required, requiredposition, response, tabindex, template, templateDir, templateEngineManager, templateSuffix, theme, title, tooltip, tooltipConfig, tooltipCssClass, tooltipDelay, tooltipIconPath, value
Fields inherited from class org.apache.struts2.components.Component
actionMapper, COMPONENT_STACK, parameters, stack, throwExceptionOnELFailure
Constructor Summary
FieldError(ValueStack stack, HttpServletRequest request, HttpServletResponse response)
Method Summary
 void addParameter(Object value)
          Adds the given value as a parameter to the outer tag.
protected  void evaluateExtraParams()
protected  String getDefaultTemplate()
          A contract that requires each concrete UI Tag to specify which template should be used as a default.
 List<String> getFieldErrorFieldNames()
 void setEscape(boolean escape)
 void setFieldName(String fieldName)
Methods inherited from class org.apache.struts2.components.UIBean
addFormParameter, buildTemplateName, enableAncestorFormCustomOnsubmit, end, ensureAttributeSafelyNotEscaped, escape, evaluateNameValue, evaluateParams, getId, getTemplate, getTemplateDir, getTheme, getTooltipConfig, getValueClassType, mergeTemplate, populateComponentHtmlId, setAccesskey, setCssClass, setCssErrorClass, setCssErrorStyle, setCssStyle, setDefaultTemplateDir, setDefaultUITheme, setDisabled, setDynamicAttributes, setId, setJavascriptTooltip, setKey, setLabel, setLabelposition, setLabelSeparator, setName, setOnblur, setOnchange, setOnclick, setOndblclick, setOnfocus, setOnkeydown, setOnkeypress, setOnkeyup, setOnmousedown, setOnmousemove, setOnmouseout, setOnmouseover, setOnmouseup, setOnselect, setRequired, setRequiredposition, setTabindex, setTemplate, setTemplateDir, setTemplateEngineManager, setTheme, setTitle, setTooltip, setTooltipConfig, setTooltipCssClass, setTooltipDelay, setTooltipIconPath, setValue
Methods inherited from class org.apache.struts2.components.Component
addAllParameters, addParameter, altSyntax, altSyntax, completeExpressionIfAltSyntax, copyParams, determineActionURL, determineNamespace, end, fieldError, findAncestor, findString, findString, findStringIfAltSyntax, findValue, findValue, findValue, getComponentStack, getParameters, getStack, popComponentStack, setActionMapper, setThrowExceptionsOnELFailure, start, stripExpressionIfAltSyntax, stripExpressionIfAltSyntax, toString, usesBody
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail


private List<String> errorFieldNames


private boolean escape


private static final String TEMPLATE
See Also:
Constant Field Values
Constructor Detail


public FieldError(ValueStack stack,
                  HttpServletRequest request,
                  HttpServletResponse response)
Method Detail


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
The name of the template to be used as the default.


protected void evaluateExtraParams()
evaluateExtraParams in class UIBean


public void addParameter(Object value)
Description copied from interface: Param.UnnamedParametric
Adds the given value as a parameter to the outer tag.

Specified by:
addParameter in interface Param.UnnamedParametric
value - the value


public List<String> getFieldErrorFieldNames()


public void setFieldName(String fieldName)


public void setEscape(boolean escape)

Copyright © 2000-2009 Apache Software Foundation. All Rights Reserved.