Displays a set of messages prepared by a business logic component and stored as an ActionMessages
object, ActionErrors
object, a String, or a String array in any scope. If such a bean is not found, nothing will be rendered. The messages are placed into the page scope in the body of this tag where they can be displayed by standard JSP methods. (For example: <bean:write>
,<c:out>
)
In order to use this tag successfully, you must have defined an application scope MessageResources
bean under the default attribute name.
Attributes |
Name | Required | Request-time | Type | Description |
id | true | false | java.lang.String | The name of a page scope JSP bean that will contain the current element of the collection of messages on each iteration, if it is not null . |
bundle | false | true | java.lang.String | The servlet context attribute key for the MessageResources instance to use. If not specified, defaults to the application resources configured for our action servlet. |
locale | false | true | java.lang.String | The session attribute key for the Locale used to select messages to be displayed. If not specified, defaults to the Struts standard value. |
name | false | true | java.lang.String | Name of the bean in any scope under which our messages have been stored. If not present, the name specified by the Globals.ERROR_KEY constant string will be used. |
property | false | true | java.lang.String | Name of the property for which messages should be displayed. If not specified, all messages (regardless of property) are displayed. |
header | false | true | java.lang.String | This value is an optional message resource key that will be printed before the iteration of messages begins. |
footer | false | true | java.lang.String | This value is an optional message resource key that will be printed after the iteration of messages has finished. |
message | false | true | java.lang.String | By default the tag will retrieve the bean it will iterate over from the Globals.ERROR_KEY constant string, but if this attribute is set to 'true' the bean will be retrieved from the Globals.MESSAGE_KEY constant string. Also if this is set to 'true', any value assigned to the name attribute will be ignored. |