ActionErrors 使用說明 struts1 validate 處理流程 詳細教程（轉)

標籤：

轉自(http://blog.csdn.net/wyx100/article/details/8736445).

struts1  處理流程是  jsp  -->  ActionForm 中的ActionErrors validate-->驗證通過後執行 action  ，否則返回頁面，顯示錯誤資訊！

 

/* * Generated by MyEclipse Struts * Template path: templates/java/JavaClass.vtl */package org.myrose.form;import javax.servlet.http.HttpServletRequest;import org.apache.struts.action.ActionErrors;import org.apache.struts.action.ActionForm;import org.apache.struts.action.ActionMapping;import org.apache.struts.action.ActionMessage;/**  * MyEclipse Struts * Creation date: 12-27-2007 *  * XDoclet definition: * @struts.form name="loginForm" */public class LoginForm extends ActionForm { /*  * Generated fields  */ /** password property */ private String password; /** name property */ private String id; private String validatecode; /*  * Generated Methods  */ public String getValidatecode() {  return validatecode; } public void setValidatecode(String validatecode) {  this.validatecode = validatecode; } /**   * Method validate  * @param mapping  * @param request  * @return ActionErrors  */ public ActionErrors validate(ActionMapping mapping,   HttpServletRequest request) {  ActionErrors errors = new ActionErrors();  if(id == null || id.trim().equals("")){   errors.add("login_id_null",new ActionMessage("login.id.null"));   return errors;  }else if(id.length() != 20){   errors.add("login_id_length",new ActionMessage("login.id.length"));   return errors;  }else if(password == null || password.trim().equals("")){   errors.add("login_password_null",new ActionMessage("login.password.null"));   return errors;  }else if(password.length() != 6){   errors.add("login_password_length",new ActionMessage("login.password.length"));   return errors;  }else if(!validatecode.equals(request.getSession().getAttribute("rand").toString())){   errors.add("login_validatecode_error", new ActionMessage("login.validatecode.error"));   return errors;  }  return null; } /**   * Method reset  * @param mapping  * @param request  */ public void reset(ActionMapping mapping, HttpServletRequest request) {  // TODO Auto-generated method stub } /**   * Returns the password.  * @return String  */ public String getPassword() {  return password; } /**   * Set the password.  * @param password The password to set  */ public void setPassword(String password) {  this.password = password; } public String getId() {  return id; } public void setId(String id) {  this.id = id; }}

一、簡介ActionErrors與ActionMessages
ActionErrors是ActionMessages的子類，包括ActionMessage，他們都實現了介面java.io.serializable。原來ActionError是ActionMessage的子類，後來在struts1.3中已被棄用，估計原因是ActionMessage能滿足要求，並且 ActionErrors亦能用作ActionMessage的容器，所以ActionError顯得多餘。
ActionErrors和ActionMessages都可作為ActionMessage的容器，ActionMessages執行個體也可以互為容器，甚至ActionErrors可以做父類執行個體ActionMessages的容器（這裡體現了“裡氏代換”原則——父類出現的地方，子類是可以安全替代的），既可以有errors.add(msgs)。

二、例子
先來看一個簡單例子
1、資源檔錯誤資訊來源(其格式為 key = value )
   error.test = this is a test error.
2、JSP頁面中用於顯示錯誤資訊標籤
   <html:errors property="testerror"/>
3、ActionFormBean的validate()方法中產生錯誤資訊
   ActionErrors error = new ActionErrors();
   error.add("testerror",new ActionMessage("error.test"))
   return error;
這個例子的功能就是在ActionForm Bean的validate()方法中產生一條名為：testerror的錯誤資訊，
錯誤資訊息是資源檔中key為error.test的值。然後在頁面上用html:errors標籤輸出testerror這條錯誤資訊。
這是最常用的一種功能，所有的錯誤資訊都在資源檔裡面。
有人會問，錯誤資訊只能存放在資源檔中嗎，其實不是這樣。不需要資源檔也可以產生錯誤資訊。
1)ActionMessage(String key,boolean isresource)
如果isresource值為true,則表示key是資源檔中的key，產生的訊息就是與key相對應的訊息
如果isresource值為false,則表示key為一條普通的訊息。
如果上面的error.add改為error.add("testerror",new ActonMessage("這是一條自訂訊息",false",));
那麼頁面上顯示的將是：這是一條自訂訊息.

2)另外還可以用ActionMessage產生複合訊息，比如我們要輸出：xxx不能用作使用者名稱，其中xxx是一個變數。
首先我們在資源檔中加一個條複合訊息
testmsg = {0}不能用作使用者名稱。這裡{0}是要被替換的參數。
我們再來看一下ActionMessage的另一中構造方法
ActionMessage(String key,Object value0);
也就是說用value0的值來替換{0}
我們修改error.add為error.add("testerror",new ActonMessage("testmsg","xxx"))
那麼JSP頁面上將顯示：xxx不能用作使用者名稱。
當然在一條複合訊息中也可帶多個參數，參數依次為{0},{1},{2}或更多
例如：loginUser = 使用者名稱:{0} 姓名:{1} 登入次數:{2}.....
那麼在產生錯誤訊息時就用new ActionMessage(String key,Object value0,Object value1,Object value2.....)
或者使用對象數組new ActionMessage(String key,Object[] values)
String[] detail = {"Admin","王晶","12"};
error.add("testerror",new ActionMessage("loginUser",detail))
________________________________________
Note：
Cannot find message resources under key org.apache.struts.action.MESSAGE 錯誤的原因是沒有配置資源檔
解決辦法： 在struts-config.xml 中加入如下的一段
<message-resources parameter="application" null="false"></message-resources>
-----------------------------------------------------------------------------------------------------------------------
在Action或Form裡產生errors:
在Action中使用：
 ActionErrors errors = new ActionErrors();
//建立一個error,topic.show.error要在application.properties檔案中聲明
 ActionError error1 = new ActionError("topic.show.error");
//加入到errors ，content為鍵
  errors.add("content", error1);
//建立多個error
 ActionError error2 = new ActionError("topic.show.error");
 ActionError error3 = new ActionError("topic.show.error"); 
  errors.add("error2", error2);
  errors.add("error2", error3);      
//Action傳回值是Forward，所以要儲存此errors
  this.saveErrors(request, errors);
在JSP端就可以用：
<html:errors property="content" />
來顯示error1這個錯誤。
若用<html:erros />則顯示出所有的錯誤
三、詳細講解
ActionMessages以一個HashMap儲存ActionMessage.Map中的key是一個標識,其對應的value是一個List對象,所有的ActionMessage儲存在List中.也就是說key標識了一組ActionMessage.
1、 ActionMessage
1)ActionMessage(String key)該方法接受一個字串,字串是在資源檔種配置的key值,必須在設定檔中進行相關配置.
2)ActionMessage(String key,Object value)
3)ActionMessage(String key,Object value0,Object value1)
4)ActionMessage(String key,Object value0,Object value1,Object value2)
5)ActionMessage(String key,Object value0,Object value1,Object value2,Object value3)
上面4個方法第一個參數同樣是資源檔中配置的key值,同樣必須在設定檔中進行相關配置.
後面的參數為資源檔中key所對應的信 息中需要的參數 ActionMessage(String key,Object[] values)
這種方法第一個參數同上,第二個參數接受一個Object數組,其中儲存key在資源檔中對應資訊需要的參數.
6)ActionMessage(String msg,false )這個方法顯示自訂訊息，即訊息輸出內容為msg。
7)getKey()返回ActionMessage的key，傳回型別：String。
8)getValues()返回ActionMessage中設定的資源檔參數，傳回型別：Object[]。
2、ActionMessages
ActionMessages.add(String property,ActionMessage message)
第一個參數property對應於<html:messages>標籤中的property屬性, property的值一般採用ActionMessages類中的靜態常量ActionMessages.GLOBAL_MESSAGE,也可以自己定義一個key.該方法執行時,先判斷ActionMessages中有沒有該key,如果沒有就新添加對key-List索引值對;如果有同樣的key,就先擷取該key對應的Value並轉換為List對象,然後將(ActionMessage)message添加進List對象中.
ActionMessages.add(ActionMessages ams)該方法將參數中儲存的ActionMessage合并到調用ActionMessages中.
3、Action及其所有子類
1)addMessages(HttpServletRequest request,ActionMessages messages)
 該方法首先檢查request對象中是否有ActionMessages對象,如果有對象,則將接收的ActionMessages合并到request中,如果沒有,用setAttribute(Globals.MESSAGE_KEY,messages)方法將messages添加進去.如果一個Action中需要顯示多條錯誤資訊,推薦使用該方法.
(Globals.MESSAGE_KEY ="org.apache.struts.action.ACTION_MESSAGE")
2)saveMessages(HttpServletRequest request,ActionMessages messages)
 該方法儲存messages時,如果request中已經有一個ActionMessages對象,則用新的覆蓋原有的.不推薦使用該方法,該方法容易發生丟失資訊的情況.
3)addErrors()和saveErrors()
這兩個方法與addMessages()和saveMessages()相似,不過在HttpServletRequest.setAttribute()時的參數不一樣,這兩個方法是:setAttribute(Globals.ERROR_KEY,messages)添加的.(Globals.ERROR_KEY = "org.apache.struts.action.ERROR")
4)clear()
5)isEmpty()
6)isAccessed()是否已將ActionMessages存入request中。
7)size()存於ActionMessages中的ActionMessage的數量。
8)size(String property)ActionMessages中property鍵對應的List中的ActionMessage的數量。
9)properties()返回ActionMessages的所有key，並存於Iterator中。
10)get()返回存於ActionMessages中的所有ActionMessage，並存於Iterator中。
11)get(String property)返回ActionMessages中property鍵對應的List中的所有ActionMessage，並存於Iterator中。
4、 AtionErrors和ActionMessages的區別
1) ActionErrors是ActionMessages的一個子類，功能幾乎相同，不同點在於標籤<html:errors/>和<html:messages>的使用上的區別。
html:errors指定了footer和header屬性。預設值為errors.header和errors.footer,需要時可以自己指定。如果資源屬性檔案配置了 errors.header和errors.footer，則任何時候使用html:errors時開頭和結尾都是這兩個屬性對應的資源資訊。
而html:message預設情況下沒有errors.header和errors.footer值，當然可以自己指定。
2)html:errors可以根據property屬性指定顯示一個錯誤資訊。html:messages有一個必添項id。html:messages不能直接顯示資訊，它將選出的資訊放入一個用id標識的Iterator對象裡，然後在用ben:write或JSTL c:out標籤顯示每個資訊.例如：
<html:messages message="true" id="msg">
    <c:out value="${msg}"/><br />
</html:messages>

ActionErrors 使用說明 struts1 validate 處理流程 詳細教程（轉)