At 9:18 PM -0600 6/22/04, David Erickson wrote:
Just wondering if there are any docs up on how the validator works in the
new nightly builds of struts... trying to transition everything to using
ActionMessages and storing the errors/messages under different keys within
that object, just wondering how to do that using the validator.xml plugin.
Thanks,
David

The way in which validator integrates with Struts has not changed. Validation errors are still "errors" and are still stored in request scope using the key org.apache.struts.Globals.ERROR_KEY (which has the literal value "org.apache.struts.action.ERROR") This is the default location where the html:errors and html:messages tags both look for an ActionMessages object.


More generally: the difference between the classes ActionErrors/ActionError/ActionMessages/ActionMessage has *absolutely nothing* to do with the difference in behavior in Action.saveErrors(...) and Action.saveMessages(...)

The difference between the classes is zero -- all behavior in ActionErrors was pushed up into ActionMessages and all behavior in ActionError was pushed up into ActionMessage. This was done in the attempt to clearly signal that these classes can be used to pass any kind of messages from the controller to the view -- errors being only one kind of message.

The difference between saveErrors(...) and saveMessages(...) is simply the attribute name under which the ActionMessages object is stored, providing two convenient default locations for storing controller messages for use by the view. If you look more closely at the html:errors and html:messages tags, you can actually use them to get an ActionMessages object from any arbitrary attribute name in any scope.

While we're clarifying, the difference between html:errors and html:messages is purely in syntax and model -- both tags *default* to look for an ActionMessages object under Globals.ERROR_KEY despite the difference in names. I wasn't part of the history, but I'm assuming that around the same time that people were realizing that there's more than one kind of message to pass, they also realized that sometimes you want more flexibility in displaying them. html:messages provides more flexibility at the cost of more typing.

I hope this helps to clarify things. I would strongly encourage people to have a look inside the Struts source code, as it's really quite clear when you look under the hood. You can see what happens in validation by examining the "processValidate" method in RequestProcessor:
http://cvs.apache.org/viewcvs.cgi/jakarta-struts/src/share/org/apache/struts/action/RequestProcessor.java?view=markup


You can see what happens with saveErrors and saveMessages by examining those methods in Action
http://cvs.apache.org/viewcvs.cgi/jakarta-struts/src/share/org/apache/struts/action/Action.java?view=markup


You can see what the tags do by looking at their respective source files:
http://cvs.apache.org/viewcvs.cgi/jakarta-struts/src/share/org/apache/struts/taglib/html/MessagesTag.java?view=markup
http://cvs.apache.org/viewcvs.cgi/jakarta-struts/src/share/org/apache/struts/taglib/html/ErrorsTag.java?view=markup

I'll put most of this text in the Struts Wiki at http://wiki.apache.org/struts/ActionErrorsAndActionMessages Anyone who wants to clarify is encouraged to document it there, and, of course, if you see a place in the core struts docs that could make this more clear, we welcome documentation contributions as much as code contributions.

Joe
--
Joe Germuska [EMAIL PROTECTED] http://blog.germuska.com "In fact, when I die, if I don't hear 'A Love Supreme,' I'll turn back; I'll know I'm in the wrong place."
- Carlos Santana


---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]



Reply via email to