在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>
在上面的代碼中,使用了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(); }