struts2的 addFieldError和標簽 的用法

 

在Struts2中最簡單的驗證數據的方法是使用validate。我們從ActionSupport類的源代碼中可以看到，ActionSupport類實現了一個Validateable接口。這個接口只有一個validate方法。如果Action類實現了這個接口，Struts2在調用execute方法之前首先會調用這個方法，我們可以在validate方法中驗證，如果發生錯誤，可以根據錯誤的level選擇字段級錯誤，還是動作級錯誤。並且可使用addFieldError或addActionError加入相應的錯誤信息，如果存在Action或Field錯誤，Struts2會返回“input”（這個並不用開發人員寫，由Struts2自動返回），如果返回了“input”，Struts2就不會再調用execute方法了。如果不存在錯誤信息，Struts2在最后會調用execute方法。

這兩個add方法和ActionErrors類中的add方法類似，只是add方法的錯誤信息需要一個ActionMessage對象，比較麻煩。除了加入錯誤信息外，還可以使用addActionMessage方法加入成功提交后的信息。當提交成功后，可以顯示這些信息。

以上三個add方法都在ValidationAware接口中定義，並且在ActionSupport類中有一個默認的實現。其實，在ActionSupport類中的實現實際上是調用了ValidationAwareSupport中的相應的方法，也就是這三個add方法是在ValidationAwareSupport類中實現的，代碼如下：

private  final ValidationAwareSupport validationAware =  new ValidationAwareSupport();

public  void addActionError(String anErrorMessage) 
{      validationAware.addActionError(anErrorMessage);
}
public  void addActionMessage(String aMessage) 
{
    validationAware.addActionMessage(aMessage);
}
public  void addFieldError(String fieldName, String errorMessage) 
{
    validationAware.addFieldError(fieldName, errorMessage);
}

下面我們來實現一個簡單的驗證程序，來體驗一個validate方法的使用。

先來在Web根目錄建立一個主頁面（validate.jsp），代碼如下：

 

< %@ page  language ="java"  import ="java.util.*"  pageEncoding ="GBK" % >
< %@ taglib  prefix ="s"  uri ="/struts-tags"  % >
< html >
   < head >
     < title >驗證數據 </ title >
   </ head >
  
   < body >
     < s:actionerror />
     < s:actionmessage />
     <s:form action="validate.action"  theme="simple">
        輸入內容：<s:textfield name="msg"/>
         <s:fielderror key="msg.hello" />
         <br/> 
        <s:submit/>
    </s:form>
   </ body >
</ html >

注意：<s:fielderror key="msg.hello" />會打印所有addFieldError的錯誤信息，但是addFieldError里面的第一個參數也就是字段必須在form表單里面有，如果沒有回出現一個黃色區域的錯誤。

在上面的代碼中，使用了Struts2的tag：<s:actionerror>、<s:fielderror>和<s:actionmessage>，分別用來顯示動作錯誤信息，字段錯誤信息，和動作信息。如果信息為空，則不顯示。

現在我們來實現一個動作類，代碼如下：

 

package action;

import javax.servlet.http.*;

import com.opensymphony.xwork2.ActionSupport;
import org.apache.struts2.interceptor.*;

public  class ValidateAction  extends ActionSupport
{
     private String msg;
     public String execute() 
    {
        System.out.println(SUCCESS);
         return SUCCESS;
    }
     public  void validate()
    {
         if(!msg.equalsIgnoreCase("hello"))
        {
            System.out.println(INPUT);
             this.addFieldError("msg.hello", "必須輸入hello!");
             this.addActionError("處理動作失敗!");
        }
         else
        {
             this.addActionMessage("提交成功");
        }
    }
     public String getMsg()
    {
         return msg;
    }
     public  void setMsg(String msg)
    {
         this.msg = msg;
    }
}

 

大家從上面的代碼可以看出，Field錯誤需要一個key（一般用來表示是哪一個屬性出的錯誤），而Action錯誤和Action消息只要提供一個信息字符串就可以了。

最后來配置一下這個Action，代碼如下：

< package  name ="demo"  extends ="struts-default" >
     < action  name ="validate"  class ="action.ValidateAction" >
         < result  name ="success" >/error/validate.jsp </ result >
         < result  name ="input" >/error/validate.jsp </ result >
     </ action >
</ package >

 

假設應用程序的上下文路徑為demo，則可通過如下的URL來測試程序：

http://localhost:8080/demo/validate.jsp

我們還可以使用ValidationAware接口的其他方法（由ValidationAwareSupport類實現）獲得或設置字段錯誤信息、動作錯誤信息以及動作消息。如hasActionErrors方法判斷是否存在動作層的錯誤，getFieldErrors獲得字段錯誤信息（一個Map對象）。下面是ValidationAware接口提供的所有的方法：

 

package com.opensymphony.xwork2;

import java.util.Collection;
import java.util.Map;

public  interface ValidationAware
{
     void setActionErrors(Collection errorMessages);
    Collection getActionErrors();

     void setActionMessages(Collection messages);
    Collection getActionMessages();
     void setFieldErrors(Map errorMap);
    Map getFieldErrors();
     void addActionError(String anErrorMessage);
     void addActionMessage(String aMessage);
     void addFieldError(String fieldName, String errorMessage);
     boolean hasActionErrors();
     boolean hasActionMessages();
     boolean hasErrors();
     boolean hasFieldErrors();
}