Struts2教程4：使用validate方法驗證資料

本文為原創，如需轉載，請註明作者和出處，謝謝！

在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 ValidationAwareSupportvalidationAware = new ValidationAwareSupport();

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

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

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



















theme="simple">

輸入內容：













在上面的程式碼中，使用了Struts2的tag：、和，分別用來顯示動作錯誤資訊，欄位錯誤資訊，和動作資訊。如果資訊為空，則不顯示。

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

package action;

import javax.servlet.http.*;

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

public class ValidateAction extendsActionSupport
{

privateString msg;

publicString execute()

{

System.out.println(SUCCESS);

returnSUCCESS;

}

publicvoid validate()

{

if(!msg.equalsIgnoreCase("hello"))

{


System.out.println(INPUT);


this.addFieldError("msg.hello","必須輸入hello!");


this.addActionError("處理動作失敗!");

}

else

{


this.addActionMessage("提交成功");

}

}

publicString getMsg()

{

returnmsg;

}

publicvoid setMsg(String msg)

{

this.msg= msg;

}
}

大家從上面的程式碼可以看出，Field錯誤需要一個key（一般用來表示是哪一個屬性出的錯誤），而Action錯誤和Action訊息只要提供一個資訊字串就可以了。
最後來配置一下這個Action，程式碼如下：



/error/validate.jsp
/error/validate.jsp



假設應用程式的上下文路徑為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
{

voidsetActionErrors(Collection errorMessages);

CollectiongetActionErrors();


voidsetActionMessages(Collection messages);

CollectiongetActionMessages();

voidsetFieldErrors(Map errorMap);

MapgetFieldErrors();

voidaddActionError(String anErrorMessage);

voidaddActionMessage(String aMessage);

voidaddFieldError(String fieldName, String errorMessage);

booleanhasActionErrors();

booleanhasActionMessages();

booleanhasErrors();

booleanhasFieldErrors();
}


在以後的文章中將介紹Struts2更高階的驗證功能！

來自 “ ITPUB部落格 ” ，連結：http://blog.itpub.net/12921506/viewspace-255112/，如需轉載，請註明出處，否則將追究法律責任。