ITEEDU

Struts Gossip: <html:messages>

ActionMessages是Struts 1.1后所新增的类别，它变成了ActionErrors的父类别，同样的，ActionMessage也是Struts 1.1新增的类别，ActionError则已经不建议使用。

ActionMessages搭配Struts的<html:messages>卷标，在管理讯息时就更为简易，以伺服端窗体验证这篇为例，如果能使用ActionMessages搭配<html:messages>卷标，那么讯息管理会很方便，例如 UserForm.java可以改为：

UserForm.java

package onlyfun.caterpillar;
 
import javax.servlet.http.*; 
import org.apache.struts.action.*;
import org.apache.struts.Globals;
import org.apache.struts.util.MessageResources;
 
public class UserForm extends ActionForm {
    private String username;
    private String password;
    
    public void setUsername(String username) { 
        this.username = username; 
    } 
    
    public void setPassword(String password) { 
        this.password = password; 
    } 
    
    public String getUsername() { 
        return username; 
    }
    
    public String getPassword() {
        return password;
    } 
    
    public void reset(ActionMapping mapping, 
                      HttpServletRequest req) {
        username = null;
        password = null;
    }
    
    public ActionErrors validate(ActionMapping mapping, 
                                HttpServletRequest request) {

        ActionErrors errors = new ActionErrors();
        if(getUsername() == null || 
                getUsername().length() < 1) {

            errors.add(ActionMessages.GLOBAL_MESSAGE, 
                new ActionMessage("error.invalidUsername")); 
        }
        
        if(getPassword() == null || 
                getPassword().length() < 1) {

            errors.add(ActionMessages.GLOBAL_MESSAGE, 
                new ActionMessage("error.invalidPassword"));
        }
        
        return errors;
    }
}

ActionMessage中的字符串（例如 error.invalidUsername）对应于讯息档案中的键值。LoginAction.java可以修改如下：

LoginAction.java

package onlyfun.caterpillar;

 import javax.servlet.http.*; 
 import org.apache.struts.action.*; 
 import org.apache.commons.beanutils.PropertyUtils;
 
 public class LoginAction extends Action {
    public ActionForward execute(ActionMapping mapping,
                               ActionForm form,
                               HttpServletRequest request, 
                               HttpServletResponse response) 
                                  throws Exception { 
        
        String username = (String) 
          PropertyUtils.getSimpleProperty(form, "username"); 
        String password = (String) 
          PropertyUtils.getSimpleProperty(form, "password"); 
        
        request.setAttribute("username", username);
        
        if(username.equals("caterpillar") && 
                  password.equals("1234")) {
            return mapping.findForward("helloUser"); 
        }
        
        ActionMessages messages = new ActionMessages();
        messages.add(ActionMessages.GLOBAL_MESSAGE, 
          new ActionMessage("message.namePasswordMismatched")
          );

        addMessages(request, messages);
        
        return mapping.findForward("loginFail"); 
    }
}

最后配合<html:messages>标签，可以输出ActionMessages的内容，来修改一下fail.jsp：

fail.jsp

<%@ taglib uri="/tags/struts-html" prefix="html" %>
<%@ taglib uri="/tags/struts-bean" prefix="bean" %>
<html>
<head> 
<title>Sorry!</title> 
</head> 
 <body>
    <H1>

    <html:messages id="error"> 
        <bean:write name="error"/> 
    </html:messages>

    <html:messages id="message" message="true"> 
        <bean:write name="message"/> 
    </html:messages>
    
    </H1>
    <p>
    <a href='/strutsapp/html/form.htm'>Login</a>
 </body> 

</html>

<html:messages>的message属性如果不设定为true，会输出ActionErrors中所储存的讯息，Error代表的是一个操作方面的错误，例如错误操作导致使用者名称或密码为空（当然也许也是故意的）。

<html:messages>的message属性如果设定为true，会输出ActionMessages中所储存的讯息， Message表示一个提示讯息，也许使用者输入了不正确的信息，例如在输入名称与密码时打错了字，程序要提示使用者他们输入了不正确的讯息。

在国际化讯息方面，<html:messages>卷标是根据session中的Locale对象来决定要显示区域讯息，您可以在 Action中使用setLocale()方法来改变Locale对象，例如：

Locale locale = new Locale("zh", "CN");
setLocale(request, locale);

如上设定，<html:messages>会找messages_zh_CN.properties中的简体中文讯息来显示。现在的问题是，那ActionForm中的讯息呢？来看一下setLocale()中的原始码您就知道怎么作了：

protected void setLocale(HttpServletRequest request,Locale locale) {
          HttpSession session = request.getSession();
              if (locale == null) {
                  locale = Locale.getDefault();
              }
          session.setAttribute(Globals.LOCALE_KEY, locale);
      }

所以如果您要一开始进行 ActionForm 验证时就使用区域化讯息，则可以在reset()或validate()方法中加入：

HttpSession session = request.getSession();
      session.setAttribute(Globals.LOCALE_KEY, locale);

或者您可以在必要的地方加入以上这段讯息，像是Servlet Filter等地方，这就看您的需求而定了。