| 
 | ||||||||||
| 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_NAMEDeprecated. as of Spring 2.5, in favor of FormTag.MODEL_ATTRIBUTE_VARIABLE_NAME | 
| protected static String | NESTED_PATH_VARIABLE_NAMEName 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. | 
|  void | doFinally()Disposes of the BindStatusinstance. | 
| protected  BindStatus | getBindStatus()Get the BindStatusfor this tag. | 
| protected  Object | getBoundValue()Get the bound value. | 
|  PropertyEditor | getEditor()Exposes the PropertyEditorforEditorAwareTag. | 
|  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 resolvedproperty path for theform 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 | 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, 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.
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 databinding. 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 failedpublic 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 | |||||||||