Class AbstractDataBoundFormElementTag

java.lang.Object

jakarta.servlet.jsp.tagext.TagSupport

org.springframework.web.servlet.tags.RequestContextAwareTag

org.springframework.web.servlet.tags.HtmlEscapingAwareTag

org.springframework.web.servlet.tags.form.AbstractFormTag

org.springframework.web.servlet.tags.form.AbstractDataBoundFormElementTag

All Implemented Interfaces:

jakarta.servlet.jsp.tagext.IterationTag, jakarta.servlet.jsp.tagext.JspTag, jakarta.servlet.jsp.tagext.Tag, jakarta.servlet.jsp.tagext.TryCatchFinally, Serializable, EditorAwareTag

Direct Known Subclasses:

AbstractHtmlElementTag

public abstract class AbstractDataBoundFormElementTag
extends AbstractFormTag
implements EditorAwareTag

Base tag for all data-binding aware JSP form tags.

Provides the common path and id properties. Provides subclasses with utility methods for accessing the BindStatus of their bound value and also for interacting with the TagWriter.

Since:

2.0

Author:

Rob Harrop, Juergen Hoeller

See Also:

• Serialized Form

Field Summary

Fields

Modifier and Type	Field	Description
protected static final String	NESTED_PATH_VARIABLE_NAME	Name of the exposed path variable within the scope of this tag: "nestedPath".

Fields inherited from class RequestContextAwareTag

logger, REQUEST_CONTEXT_PAGE_ATTRIBUTE

Fields inherited from class jakarta.servlet.jsp.tagext.TagSupport

pageContext

Fields inherited from interface jakarta.servlet.jsp.tagext.IterationTag

EVAL_BODY_AGAIN

Fields inherited from interface jakarta.servlet.jsp.tagext.Tag

EVAL_BODY_INCLUDE, EVAL_PAGE, SKIP_BODY, SKIP_PAGE

Constructor Summary

Constructors

Constructor	Description
AbstractDataBoundFormElementTag()

Method Summary

Modifier and Type	Method	Description
protected @Nullable String	autogenerateId()	Autogenerate the 'id' attribute value for this tag.
protected String	convertToDisplayString(@Nullable Object value)	Get a display String for the given value, converted by a PropertyEditor that the BindStatus may have registered for the value's Class.
void	doFinally()	Disposes of the BindStatus instance.
protected BindStatus	getBindStatus()	Get the BindStatus for this tag.
protected final @Nullable Object	getBoundValue()	Get the bound value.
final @Nullable PropertyEditor	getEditor()	Exposes the PropertyEditor for EditorAwareTag.
@Nullable String	getId()	Get the value of the 'id' attribute.
protected @Nullable String	getName()	Get the value for the HTML 'name' attribute.
protected @Nullable String	getNestedPath()	Get the value of the nested path that may have been exposed by the NestedPathTag.
protected final String	getPath()	Get the resolved property path for the form object.
protected @Nullable PropertyEditor	getPropertyEditor()	Get the PropertyEditor, if any, in use for value bound to this tag.
protected String	getPropertyPath()	Build the property path for this tag, including the nested path but not prefixed with the name of the form attribute.
protected final String	processFieldValue(@Nullable String name, String value, String type)	Process the given form field through a RequestDataValueProcessor instance if one is configured or otherwise returns the same value.
protected @Nullable String	resolveId()	Determine the 'id' attribute value for this tag, autogenerating one if none specified.
void	setId(@Nullable String id)	Set the value of the 'id' attribute.
void	setPath(String path)	Set the property path from the form object.
protected void	writeDefaultAttributes(TagWriter tagWriter)	Writes the default set of attributes to the supplied TagWriter.

Methods inherited from class AbstractFormTag

createTagWriter, doStartTagInternal, evaluate, getDisplayString, getDisplayString, isDefaultHtmlEscape, writeOptionalAttribute, writeTagContent

Methods inherited from class HtmlEscapingAwareTag

htmlEscape, isHtmlEscape, isResponseEncodedHtmlEscape, setHtmlEscape

Methods inherited from class RequestContextAwareTag

doCatch, doStartTag, getRequestContext

Methods inherited from class jakarta.servlet.jsp.tagext.TagSupport

doAfterBody, doEndTag, findAncestorWithClass, getParent, getValue, getValues, release, removeValue, setPageContext, setParent, setValue

Methods inherited from class Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Details

NESTED_PATH_VARIABLE_NAME

protected static final String NESTED_PATH_VARIABLE_NAME

Name of the exposed path variable within the scope of this tag: "nestedPath". Same value as NestedPathTag.NESTED_PATH_VARIABLE_NAME.

See Also:

• Constant Field Values

Constructor Details

AbstractDataBoundFormElementTag

public AbstractDataBoundFormElementTag()

Method Details

setPath

public void setPath(String path)

Set the property path from the form object. May be a runtime expression.

getPath

protected final String getPath()
                        throws jakarta.servlet.jsp.JspException

Get the resolved property path for the form object.

Throws:

jakarta.servlet.jsp.JspException

setId

public void setId(@Nullable String id)

Set the value of the 'id' attribute.

May be a runtime expression; defaults to the value of getName(). Note that the default value may not be valid for certain tags.

Overrides:

setId in class jakarta.servlet.jsp.tagext.TagSupport

getId

public @Nullable String getId()

Get the value of the 'id' attribute.

Overrides:

getId in class jakarta.servlet.jsp.tagext.TagSupport

writeDefaultAttributes

protected void writeDefaultAttributes(TagWriter tagWriter)
                               throws jakarta.servlet.jsp.JspException

Writes the default set of attributes to the supplied TagWriter. Further, abstract subclasses should override this method to add in any additional default attributes but must remember to call the super method.

Concrete subclasses should call this method when/if they want to render default attributes.

Parameters:

tagWriter - the TagWriter to which any attributes are to be written

Throws:

jakarta.servlet.jsp.JspException

resolveId

protected @Nullable String resolveId()
                              throws jakarta.servlet.jsp.JspException

Determine the 'id' attribute value for this tag, autogenerating one if none specified.

Throws:

jakarta.servlet.jsp.JspException

See Also:

• getId()
• autogenerateId()

autogenerateId

protected @Nullable String autogenerateId()
                                   throws jakarta.servlet.jsp.JspException

Autogenerate the 'id' attribute value for this tag.

The default implementation simply delegates to getName(), deleting invalid characters (such as "[" or "]").

Throws:

jakarta.servlet.jsp.JspException

getName

protected @Nullable String getName()
                            throws jakarta.servlet.jsp.JspException

Get the value for the HTML 'name' attribute.

The default implementation simply delegates to getPropertyPath() to use the property path as the name. For the most part this is desirable as it links with the server-side expectation for data binding. However, some subclasses may wish to change the value of the 'name' attribute without changing the bind path.

Returns:

the value for the HTML 'name' attribute

Throws:

jakarta.servlet.jsp.JspException

getBindStatus

protected BindStatus getBindStatus()
                            throws jakarta.servlet.jsp.JspException

Get the BindStatus for this tag.

Throws:

jakarta.servlet.jsp.JspException

getNestedPath

protected @Nullable String getNestedPath()

Get the value of the nested path that may have been exposed by the NestedPathTag.

getPropertyPath

protected String getPropertyPath()
                          throws jakarta.servlet.jsp.JspException

Build the property path for this tag, including the nested path but not prefixed with the name of the form attribute.

Throws:

jakarta.servlet.jsp.JspException

See Also:

• getNestedPath()
• getPath()

getBoundValue

protected final @Nullable Object getBoundValue()
                                        throws jakarta.servlet.jsp.JspException

Get the bound value.

Throws:

jakarta.servlet.jsp.JspException

See Also:

• getBindStatus()

getPropertyEditor

protected @Nullable PropertyEditor getPropertyEditor()
                                              throws jakarta.servlet.jsp.JspException

Get the PropertyEditor, if any, in use for value bound to this tag.

Throws:

jakarta.servlet.jsp.JspException

getEditor

public final @Nullable PropertyEditor getEditor()
                                         throws jakarta.servlet.jsp.JspException

Exposes the PropertyEditor for EditorAwareTag.

Use getPropertyEditor() for internal rendering purposes.

Specified by:

getEditor in interface EditorAwareTag

Returns:

the current PropertyEditor, or null if none

Throws:

jakarta.servlet.jsp.JspException - if resolving the editor failed

convertToDisplayString

protected String convertToDisplayString(@Nullable Object value)
                                 throws jakarta.servlet.jsp.JspException

Get a display String for the given value, converted by a PropertyEditor that the BindStatus may have registered for the value's Class.

Throws:

jakarta.servlet.jsp.JspException

processFieldValue

protected final String processFieldValue(@Nullable String name,
 String value,
 String type)

Process the given form field through a RequestDataValueProcessor instance if one is configured or otherwise returns the same value.

doFinally

public void doFinally()

Disposes of the BindStatus instance.

Specified by:

doFinally in interface jakarta.servlet.jsp.tagext.TryCatchFinally

Overrides:

doFinally in class RequestContextAwareTag