Struts2教程4：使用validate方法驗證數據

上一篇：Struts2教程3：struts.xml經常使用配置解析

在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();
}

下一篇：Struts2教程5：使用Validation框架驗證數據