ActionErrors與ActionMessages

一、簡介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","毛澤東")) 

那麼JSP頁面上将顯示：毛澤東不能用作使用者名。 

當然在一條複合消息中也可帶多個參數，參數依次為{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>