Class MessageTag
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.MessageTag
- All Implemented Interfaces:
IterationTag,JspTag,Tag,TryCatchFinally,Serializable,ArgumentAware
- Direct Known Subclasses:
ThemeTag
The
<message> tag looks up a message in the scope of this page.
Messages are resolved using the ApplicationContext and thus support
internationalization.
Detects an HTML escaping setting, either on this tag instance, the page level,
or the web.xml level. Can also apply JavaScript escaping.
If "code" isn't set or cannot be resolved, "text" will be used as default message. Thus, this tag can also be used for HTML escaping of any texts.
Message arguments can be specified via the arguments
attribute or by using nested <spring:argument> tags.
| Attribute | Required? | Runtime Expression? | Description |
|---|---|---|---|
| arguments | false | true | Set optional message arguments for this tag, as a (comma-)delimited String (each String argument can contain JSP EL), an Object array (used as argument array), or a single Object (used as single argument). |
| argumentSeparator | false | true | The separator character to be used for splitting the arguments string value; defaults to a 'comma' (','). |
| code | false | true | The code (key) to use when looking up the message. If code is not provided, the text attribute will be used. |
| htmlEscape | false | true | Set HTML escaping for this tag, as boolean value. Overrides the default HTML escaping setting for the current page. |
| javaScriptEscape | false | true | Set JavaScript escaping for this tag, as boolean value. Default is false. |
| message | false | true | A MessageSourceResolvable argument (direct or through JSP EL). Fits nicely when used in conjunction with Spring’s own validation error classes which all implement the MessageSourceResolvable interface. For example, this allows you to iterate over all of the errors in a form, passing each error (using a runtime expression) as the value of this 'message' attribute, thus effecting the easy display of such error messages. |
| scope | false | true | The scope to use when exporting the result to a variable. This attribute is only used when var is also set. Possible values are page, request, session and application. |
| text | false | true | Default text to output when a message for the given code could not be found. If both text and code are not set, the tag will output null. |
| 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). |
- Author:
- Rod Johnson, Juergen Hoeller, Nicholas Williams
- See Also:
-
Field Summary
FieldsModifier and TypeFieldDescriptionstatic final StringDefault separator for splitting an arguments String: a comma (",").Fields inherited from class org.springframework.web.servlet.tags.RequestContextAwareTag
logger, REQUEST_CONTEXT_PAGE_ATTRIBUTEFields inherited from class jakarta.servlet.jsp.tagext.TagSupport
id, pageContextFields inherited from interface jakarta.servlet.jsp.tagext.IterationTag
EVAL_BODY_AGAINFields inherited from interface jakarta.servlet.jsp.tagext.Tag
EVAL_BODY_INCLUDE, EVAL_PAGE, SKIP_BODY, SKIP_PAGE -
Constructor Summary
Constructors -
Method Summary
Modifier and TypeMethodDescriptionvoidaddArgument(Object argument) Callback hook for nested spring:argument tags to pass their value to the parent tag.intdoEndTag()Resolves the message, escapes it if demanded, and writes it to the page (or exposes it as variable).protected final intCalled by doStartTag to perform the actual work.protected MessageSourceUse the current RequestContext's application context as MessageSource.protected StringReturn default exception message.voidrelease()protected Object[]resolveArguments(Object arguments) Resolve the given arguments Object into an arguments array.protected StringResolve the specified message into a concrete message String.voidsetArguments(Object arguments) Set optional message arguments for this tag, as a comma-delimited String (each String argument can contain JSP EL), an Object array (used as argument array), or a single Object (used as single argument).voidsetArgumentSeparator(String argumentSeparator) Set the separator to use for splitting an arguments String.voidSet the message code for this tag.voidsetJavaScriptEscape(boolean javaScriptEscape) Set JavaScript escaping for this tag, as boolean value.voidsetMessage(MessageSourceResolvable message) Set the MessageSourceResolvable for this tag.voidSet the scope to export the variable to.voidSet the message text for this tag.voidSet PageContext attribute name under which to expose a variable that contains the resolved message.protected voidwriteMessage(String msg) Write the message to the page.Methods inherited from class org.springframework.web.servlet.tags.HtmlEscapingAwareTag
htmlEscape, isDefaultHtmlEscape, isHtmlEscape, isResponseEncodedHtmlEscape, setHtmlEscapeMethods inherited from class org.springframework.web.servlet.tags.RequestContextAwareTag
doCatch, doFinally, doStartTag, getRequestContextMethods inherited from class jakarta.servlet.jsp.tagext.TagSupport
doAfterBody, findAncestorWithClass, getId, getParent, getValue, getValues, removeValue, setId, setPageContext, setParent, setValue
-
Field Details
-
DEFAULT_ARGUMENT_SEPARATOR
Default separator for splitting an arguments String: a comma (",").- See Also:
-
-
Constructor Details
-
MessageTag
public MessageTag()
-
-
Method Details
-
setMessage
Set the MessageSourceResolvable for this tag.If a MessageSourceResolvable is specified, it effectively overrides any code, arguments or text specified on this tag.
-
setCode
Set the message code for this tag. -
setArguments
Set optional message arguments for this tag, as a comma-delimited String (each String argument can contain JSP EL), an Object array (used as argument array), or a single Object (used as single argument). -
setArgumentSeparator
Set the separator to use for splitting an arguments String. Default is a comma (",").- See Also:
-
addArgument
Description copied from interface:ArgumentAwareCallback hook for nested spring:argument tags to pass their value to the parent tag.- Specified by:
addArgumentin interfaceArgumentAware- Parameters:
argument- the result of the nestedspring:argumenttag- Throws:
JspTagException
-
setText
Set the message text for this tag. -
setVar
Set PageContext attribute name under which to expose a variable that contains the resolved message. -
setScope
Set the scope to export the variable to. Default is SCOPE_PAGE ("page"). -
setJavaScriptEscape
Set JavaScript escaping for this tag, as boolean value. Default is "false".- Throws:
JspException
-
doStartTagInternal
Description copied from class:RequestContextAwareTagCalled by doStartTag to perform the actual work.- Specified by:
doStartTagInternalin classRequestContextAwareTag- Returns:
- same as TagSupport.doStartTag
- Throws:
JspExceptionIOException- See Also:
-
doEndTag
Resolves the message, escapes it if demanded, and writes it to the page (or exposes it as variable).- Specified by:
doEndTagin interfaceTag- Overrides:
doEndTagin classTagSupport- Throws:
JspException- See Also:
-
release
public void release()- Specified by:
releasein interfaceTag- Overrides:
releasein classTagSupport
-
resolveMessage
Resolve the specified message into a concrete message String. The returned message String should be unescaped.- Throws:
JspExceptionNoSuchMessageException
-
resolveArguments
Resolve the given arguments Object into an arguments array.- Parameters:
arguments- the specified arguments Object- Returns:
- the resolved arguments as array
- Throws:
JspException- if argument conversion failed- See Also:
-
writeMessage
Write the message to the page.Can be overridden in subclasses, e.g. for testing purposes.
- Parameters:
msg- the message to write- Throws:
IOException- if writing failed
-
getMessageSource
Use the current RequestContext's application context as MessageSource. -
getNoSuchMessageExceptionDescription
Return default exception message.
-