public abstract class

AbstractFormTag

extends HtmlEscapingAwareTag

java.lang.Object
↳	TagSupport
	↳	org.springframework.web.servlet.tags.RequestContextAwareTag
		↳	org.springframework.web.servlet.tags.HtmlEscapingAwareTag
			↳	org.springframework.web.servlet.tags.form.AbstractFormTag

Known Direct Subclasses

AbstractDataBoundFormElementTag

Known Indirect Subclasses

AbstractCheckedElementTag, AbstractHtmlElementBodyTag, AbstractHtmlElementTag, AbstractHtmlInputElementTag, AbstractMultiCheckedElementTag, AbstractSingleCheckedElementTag, CheckboxTag, CheckboxesTag, ErrorsTag, FormTag, HiddenInputTag, InputTag, LabelTag, OptionTag, OptionsTag, PasswordInputTag, RadioButtonTag, RadioButtonsTag, SelectTag, TextareaTag

AbstractCheckedElementTag	Abstract base class to provide common methods for implementing databinding-aware JSP tags for rendering an HTML '`input`' element with a '`type`' of '`checkbox`' or '`radio`'.
AbstractHtmlElementBodyTag	Convenient super class for many html tags that render content using the databinding features of the `AbstractHtmlElementTag`.
AbstractHtmlElementTag	Base class for databinding-aware JSP tags that render HTML element.
AbstractHtmlInputElementTag	Base class for databinding-aware JSP tags that render HTML form input element.
AbstractMultiCheckedElementTag	Abstract base class to provide common methods for implementing databinding-aware JSP tags for rendering multiple HTML '`input`' elements with a '`type`' of '`checkbox`' or '`radio`'.
AbstractSingleCheckedElementTag	Abstract base class to provide common methods for implementing databinding-aware JSP tags for rendering a single HTML '`input`' element with a '`type`' of '`checkbox`' or '`radio`'.
CheckboxTag	Databinding-aware JSP tag for rendering an HTML '`input`' element with a '`type`' of '`checkbox`'.
CheckboxesTag	Databinding-aware JSP tag for rendering multiple HTML '`input`' elements with a '`type`' of '`checkbox`'.
ErrorsTag	Form tag for displaying errors for a particular field or object.
FormTag	Databinding-aware JSP tag for rendering an HTML '`form`' whose inner elements are bound to properties on a form object.
HiddenInputTag	Data-binding aware JSP tag for rendering a hidden HTML '`input`' field containing the databound value.
InputTag	Data-binding-aware JSP tag for rendering an HTML '`input`' element with a '`type`' of '`text`'.
LabelTag	Databinding-aware JSP tag for rendering an HTML '`label`' element that defines text that is associated with a single form element.
OptionTag	JSP tag for rendering an HTML '`option`' tag.
OptionsTag	Convenient tag that allows one to supply a collection of objects that are to be rendered as '`option`' tags within a '`select`' tag.
PasswordInputTag	Databinding-aware JSP tag for rendering an HTML '`input`' element with a '`type`' of '`password`'.
RadioButtonTag	Databinding-aware JSP tag for rendering an HTML '`input`' element with a '`type`' of '`radio`'.
RadioButtonsTag	Databinding-aware JSP tag for rendering multiple HTML '`input`' elements with a '`type`' of '`radio`'.
SelectTag	Databinding-aware JSP tag that renders an HTML '`select`' element.
TextareaTag	Databinding-aware JSP tag for rendering an HTML '`textarea`'.

Class Overview

Base class for all JSP form tags. Provides utility methods for null-safe EL evaluation and for accessing and working with a TagWriter.

Subclasses should implement the writeTagContent(TagWriter) to perform actual tag rendering.

Subclasses (or test classes) can override the createTagWriter() method to redirect output to a Writer other than the javax.servlet.jsp.JspWriter associated with the current javax.servlet.jsp.PageContext.

Summary

[Expand]

Inherited Constants

From class org.springframework.web.servlet.tags.RequestContextAwareTag

[Expand]

Inherited Fields

From class org.springframework.web.servlet.tags.RequestContextAwareTag

Public Constructors
	AbstractFormTag()

Protected Methods
TagWriter	createTagWriter() Create the `TagWriter` which all output will be written to.
final int	doStartTagInternal() Provide a simple template method that calls `createTagWriter()` and passes the created `TagWriter` to the `writeTagContent(TagWriter)` method.
Object	evaluate(String attributeName, Object value) Evaluate the supplied value for the supplied attribute name.
boolean	evaluateBoolean(String attributeName, String value) Evaluate the supplied value for the supplied attribute name.
String	getDisplayString(Object value, PropertyEditor propertyEditor) Get the display value of the supplied `Object`, HTML escaped as required.
String	getDisplayString(Object value) Get the display value of the supplied `Object`, HTML escaped as required.
boolean	isDefaultHtmlEscape() Overridden to default to `true` in case of no explicit default given.
final void	writeOptionalAttribute(TagWriter tagWriter, String attributeName, String value) Optionally writes the supplied value under the supplied attribute name into the supplied `TagWriter`.
abstract int	writeTagContent(TagWriter tagWriter) Subclasses should implement this method to perform tag content rendering.

[Expand]

Inherited Methods

From class org.springframework.web.servlet.tags.HtmlEscapingAwareTag

From class org.springframework.web.servlet.tags.RequestContextAwareTag

From class java.lang.Object

Public Constructors

public AbstractFormTag ()

Protected Methods

protected TagWriter createTagWriter ()

Create the TagWriter which all output will be written to. By default, the TagWriter writes its output to the javax.servlet.jsp.JspWriter for the current javax.servlet.jsp.PageContext. Subclasses may choose to change the Writer to which output is actually written.

protected final int doStartTagInternal ()

Provide a simple template method that calls createTagWriter() and passes the created TagWriter to the writeTagContent(TagWriter) method.

Returns

the value returned by writeTagContent(TagWriter)

Throws

Exception

protected Object evaluate (String attributeName, Object value)

Evaluate the supplied value for the supplied attribute name. If the supplied value is null then null is returned, otherwise evaluation is handled using ExpressionEvaluationUtils#evaluate(String, String, javax.servlet.jsp.PageContext).

Throws

JspException

protected boolean evaluateBoolean (String attributeName, String value)

Evaluate the supplied value for the supplied attribute name. If the supplied value is null then false is returned, otherwise evaluation is handled using ExpressionEvaluationUtils#evaluate(String, String, javax.servlet.jsp.PageContext), with subsequent matching against Boolean.TRUE and Boolean.valueOf.

Throws

JspException

protected String getDisplayString (Object value, PropertyEditor propertyEditor)

Get the display value of the supplied Object, HTML escaped as required. If the supplied value is not a String and the supplied PropertyEditor is not null then the PropertyEditor is used to obtain the display value.

protected String getDisplayString (Object value)

Get the display value of the supplied Object, HTML escaped as required. This version is not PropertyEditor-aware.

protected boolean isDefaultHtmlEscape ()

Overridden to default to true in case of no explicit default given.

protected final void writeOptionalAttribute (TagWriter tagWriter, String attributeName, String value)

Optionally writes the supplied value under the supplied attribute name into the supplied TagWriter. In this case, the supplied value is evaluated first and then the String representation is written as the attribute value. If the resultant String representation is null or empty, no attribute is written.

Throws

JspException

protected abstract int writeTagContent (TagWriter tagWriter)

Subclasses should implement this method to perform tag content rendering.

Returns

valid tag render instruction as per javax.servlet.jsp.tagext.Tag#doStartTag().

Throws

JspException

Classes

AbstractFormTag

Class Overview

Summary

Public Constructors

public AbstractFormTag ()

Protected Methods

protected TagWriter createTagWriter ()

protected final int doStartTagInternal ()

Returns

Throws

protected Object evaluate (String attributeName, Object value)

Throws

protected boolean evaluateBoolean (String attributeName, String value)

Throws

protected String getDisplayString (Object value, PropertyEditor propertyEditor)

protected String getDisplayString (Object value)

protected boolean isDefaultHtmlEscape ()

protected final void writeOptionalAttribute (TagWriter tagWriter, String attributeName, String value)

Throws

See Also

protected abstract int writeTagContent (TagWriter tagWriter)

Returns

Throws