Class TransformTag

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.TransformTag
All Implemented Interfaces:
jakarta.servlet.jsp.tagext.IterationTag, jakarta.servlet.jsp.tagext.JspTag, jakarta.servlet.jsp.tagext.Tag, jakarta.servlet.jsp.tagext.TryCatchFinally, Serializable
public class TransformTag extends HtmlEscapingAwareTag
The <transform> tag provides transformation for reference data values from controllers and other objects inside a spring:bind tag (or a data-bound form element tag from Spring's form tag library).

The BindTag has a PropertyEditor that it uses to transform properties of a bean to a String, usable in HTML forms. This tag uses that PropertyEditor to transform objects passed into this tag.

Attribute Summary
Attribute Required? Runtime Expression? Description
htmlEscape false true Set HTML escaping for this tag, as boolean value. Overrides the default HTML escaping setting for the current page.
scope false true The scope to use when exported the result to a variable. This attribute is only used when var is also set. Possible values are page, request, session and application.
value true true The value to transform. This is the actual object you want to have transformed (for instance a Date). Using the PropertyEditor that is currently in use by the 'spring:bind' tag.
var false true The string to use when binding the result to the page, request, session or application scope. If not specified, the result gets outputted to the writer (i.e. typically directly to the JSP).
Since:
20.09.2003
Author:
Alef Arendsen, Juergen Hoeller
See Also:

  • Constructor Details

    • TransformTag

      public TransformTag()

  • Method Details

    • setValue

      public void setValue(Object value)
      Set the value to transform, using the appropriate PropertyEditor from the enclosing BindTag.

      The value can either be a plain value to transform (a hard-coded String value in a JSP or a JSP expression), or a JSP EL expression to be evaluated (transforming the result of the expression).

    • setVar

      public void setVar(String var)
      Set PageContext attribute name under which to expose a variable that contains the result of the transformation.
      See Also:

    • setScope

      public void setScope(String scope)
      Set the scope to export the variable to. Default is SCOPE_PAGE ("page").
      See Also:

    • doStartTagInternal

      protected final int doStartTagInternal() throws jakarta.servlet.jsp.JspException
      Description copied from class: RequestContextAwareTag
      Called by doStartTag to perform the actual work.
      Specified by:
      doStartTagInternal in class RequestContextAwareTag
      Returns:
      same as TagSupport.doStartTag
      Throws:
      jakarta.servlet.jsp.JspException
      See Also:
      • TagSupport.doStartTag()