|
|||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | ||||||||
java.lang.Objectjavax.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
public abstract class AbstractDataBoundFormElementTag
Base tag for all data-binding aware JSP form tags.
Provides the common path and id properties.
Provides sub-classes with utility methods for accessing the BindStatus
of their bound value and also for interacting
with the TagWriter.
| Field Summary | |
|---|---|
static String |
COMMAND_NAME_VARIABLE_NAME
Deprecated. as of Spring 2.5, in favor of FormTag.MODEL_ATTRIBUTE_VARIABLE_NAME |
protected static String |
NESTED_PATH_VARIABLE_NAME
Name of the exposed path variable within the scope of this tag: "nestedPath". |
| Fields inherited from class org.springframework.web.servlet.tags.RequestContextAwareTag |
|---|
logger, REQUEST_CONTEXT_PAGE_ATTRIBUTE |
| Fields inherited from class javax.servlet.jsp.tagext.TagSupport |
|---|
pageContext |
| Fields inherited from interface javax.servlet.jsp.tagext.IterationTag |
|---|
EVAL_BODY_AGAIN |
| Fields inherited from interface javax.servlet.jsp.tagext.Tag |
|---|
EVAL_BODY_INCLUDE, EVAL_PAGE, SKIP_BODY, SKIP_PAGE |
| Constructor Summary | |
|---|---|
AbstractDataBoundFormElementTag()
|
|
| Method Summary | |
|---|---|
protected String |
autogenerateId()
Autogenerate the ' id' attribute value for this tag. |
protected String |
convertToDisplayString(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 Object |
getBoundValue()
Get the bound value. |
PropertyEditor |
getEditor()
Exposes the PropertyEditor for EditorAwareTag. |
String |
getId()
Get the value of the ' id' attribute. |
protected String |
getName()
Get the value for the HTML ' name' attribute. |
protected String |
getNestedPath()
Get the value of the nested path that may have been exposed by the NestedPathTag. |
protected String |
getPath()
Get the resolved property path for the
form object. |
protected 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 String |
processFieldValue(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 String |
resolveId()
Determine the ' id' attribute value for this tag,
autogenerating one if none specified. |
void |
setId(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 org.springframework.web.servlet.tags.form.AbstractFormTag |
|---|
createTagWriter, doStartTagInternal, evaluate, evaluateBoolean, getDisplayString, getDisplayString, isDefaultHtmlEscape, writeOptionalAttribute, writeTagContent |
| Methods inherited from class org.springframework.web.servlet.tags.HtmlEscapingAwareTag |
|---|
isHtmlEscape, setHtmlEscape |
| Methods inherited from class org.springframework.web.servlet.tags.RequestContextAwareTag |
|---|
doCatch, doStartTag, getRequestContext |
| Methods inherited from class javax.servlet.jsp.tagext.TagSupport |
|---|
doAfterBody, doEndTag, findAncestorWithClass, getParent, getValue, getValues, release, removeValue, setPageContext, setParent, setValue |
| Methods inherited from class java.lang.Object |
|---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
| Field Detail |
|---|
protected static final String NESTED_PATH_VARIABLE_NAME
NestedPathTag.NESTED_PATH_VARIABLE_NAME.
@Deprecated public static final String COMMAND_NAME_VARIABLE_NAME
FormTag.MODEL_ATTRIBUTE_VARIABLE_NAMEPageContext attribute under which the
command object name is exposed.
| Constructor Detail |
|---|
public AbstractDataBoundFormElementTag()
| Method Detail |
|---|
public void setPath(String path)
form object.
May be a runtime expression.
protected final String getPath()
throws JspException
resolved property path for the
form object.
JspExceptionpublic void setId(String id)
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.
setId in class TagSupportpublic String getId()
id' attribute.
getId in class TagSupport
protected void writeDefaultAttributes(TagWriter tagWriter)
throws JspException
TagWriter.
Further abstract sub-classes should override this method to add in
any additional default attributes but must remember
to call the super method.
Concrete sub-classes should call this method when/if they want to render default attributes.
tagWriter - the TagWriter to which any attributes are to be written
JspException
protected String resolveId()
throws JspException
id' attribute value for this tag,
autogenerating one if none specified.
JspExceptiongetId(),
autogenerateId()
protected String autogenerateId()
throws JspException
id' attribute value for this tag.
The default implementation simply delegates to getName(),
deleting invalid characters (such as "[" or "]").
JspException
protected String getName()
throws JspException
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.
name' attribute
JspException
protected BindStatus getBindStatus()
throws JspException
BindStatus for this tag.
JspExceptionprotected String getNestedPath()
NestedPathTag.
protected String getPropertyPath()
throws JspException
JspExceptiongetNestedPath(),
getPath()
protected final Object getBoundValue()
throws JspException
JspExceptiongetBindStatus()
protected PropertyEditor getPropertyEditor()
throws JspException
PropertyEditor, if any, in use for value bound to this tag.
JspException
public final PropertyEditor getEditor()
throws JspException
PropertyEditor for EditorAwareTag.
Use getPropertyEditor() for internal rendering purposes.
getEditor in interface EditorAwareTagnull if none
JspException - if resolving the editor failed
protected String convertToDisplayString(Object value)
throws JspException
JspException
protected final String processFieldValue(String name,
String value,
String type)
RequestDataValueProcessor
instance if one is configured or otherwise returns the same value.
public void doFinally()
BindStatus instance.
doFinally in interface TryCatchFinallydoFinally in class RequestContextAwareTag
|
|||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | ||||||||