<html:messages>

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等地方，這就看您的需求而定了。

From Gossip@caterpillar

Struts Gossip: <html:messages>