在《Struts2教程4：使用validate方法驗證數據》中曾講到使用validate方法來驗證客戶端提交的數據，但如果使用validate方法就會將驗證代碼和正常的邏輯代碼混在一起，但這樣做并不利于代碼維護，而且也很難將過些代碼用于其他程序的驗證。在Struts2中為我們提供了一個Validation框架，這個框架和Struts1.x提供的Validation框架類似，也是通過XML文件進行配置。

一、服務端驗證

下面將給出一個例子來演示如何使用Struts2的validation框架來進行服務端驗證。我們可以按著如下四步來編寫這個程序：

【第1步】建立Action類（NewValidateAction.java）

package action;  
 
import com.opensymphony.xwork2.ActionSupport;  
 
public class NewValidateAction extends ActionSupport  
{  
    private String msg;  // 必須輸入  
    private int age;   // 在13和20之間  
    public String getMsg()  
    {  
        return msg;  
    }  
    public void setMsg(String msg)  
    {  
        this.msg = msg;  
    }  
    public int getAge()  
    {  
        return age;  
    }  
    public void setAge(int age)  
    {  
        this.age = age;  
    }  
}  

下面我們來驗證msg和age屬性。

【第2步】配置Action類，struts.xml的代碼如下：

< ?xml version="1.0" encoding="UTF-8" ?> 
< !DOCTYPE struts PUBLIC  
    "-//Apache Software Foundation//DTD Struts Configuration 2.0//EN"  
    "http://struts.apache.org/dtds/struts-2.0.dtd"> 
< struts> 
    < package name="demo" extends="struts-default" namespace="/test"> 
        < action name="new_validate" class="action.NewValidateAction"> 
            < result name="input">/validate_form.jsp< /result> 
            < result name="success">/validate_form.jsp< /result> 
        < /action> 
    < /package> 
< /struts> 

【第3步】編寫驗證規則配置文件

這是一個基于XML的配置文件，和struts1.x中的validator框架的驗證規則配置文件類似。但一般放到和要驗證的.class文件在同一目錄下，而且配置文件名要使用如下兩個規則中的一個來命名：

< ActionClassName>-validation.xml

< ActionClassName>-< ActionAliasName>-validation.xml

其中< ActionAliasName>就是struts.xml中< ation>的name屬性值。在本例中我們使用***種命名規則，所以文件名是NewValidateAction-validation.xml。文件的內容如下：

< ?xml version="1.0" encoding="UTF-8"?> 
< !DOCTYPE validators PUBLIC "-//OpenSymphony Group//XWork Validator 1.0.2//EN"   
"http://www.opensymphony.com/xwork/xwork-validator-1.0.2.dtd"> 
< validators> 
    < field name="msg"> 
        < field-validator type="requiredstring"> 
            < message>請輸入信息< /message> 
        < /field-validator> 
    < /field> 
    < field name="age"> 
        < field-validator type="int"> 
            < param name="min">13< /param> 
            < param name="max">20< /param> 
            < message> 
                必須在 13至20之間  
            < /message> 
        < /field-validator> 
    < /field> 
< /validators> 

這個文件使用了兩個規則：requiredstring（必須輸入）和int（確定整型范圍）。關于其他更詳細的驗證規則，請讀者訪問http://struts.apache.org/2.0.11.1/docs/validation.html來查看。

【第4步】編寫數據錄入JSP頁。

在Web根目錄中建立一個validate_form.jsp文件，代碼如下：

< %@ page language="java" import="java.util.*" pageEncoding="GBK"%> 
< %@ taglib prefix="s" uri="/struts-tags" %> 
< link rel="stylesheet" type="text/css" href="< s:url value="/styles/styles.css"/>"> 
< html> 
  < head> 
    < title>驗證數據< /title> 
  < /head>    
  < body> 
    < s:form action="new_validate" namespace="/test" > 
        < s:textfield name="msg" label="姓名"  /> 
        < s:textfield name="age" label="年齡"/>   
        < s:submit/> 
    < /s:form>   
  < /body>    
< /html> 

大家要注意一下，如果在struts.xml的< package>標簽中指定namespace屬性，需要在< s:form>中也將namespace和action分開寫，如上面代碼所示。不能將其連在一起，Struts2需要分開的action和namespace。如下面的代碼是錯誤的：

< s:form action="/test/new_validate" >

   ... ...

< /s:form>

在上面的程序中還使用了一個styles.css來定制錯誤信息的風格。代碼如下：

.label {font-style:italic; }

.errorLabel {font-style:italic; color:red; }

.errorMessage {font-weight:bold; color:red; }

需要在Web根目錄中建立一個styles目錄，并將styles.css   

假設Web工程的上下文路徑是validation，可以使用如下的URL來測試這個程序：

http://localhost:8080/validation/validate_form.jsp

顯示結果如圖1所示。

圖1

二、客戶端驗證

在Struts2中實現客戶端驗證非常簡單，只需要在< s:form>中加入一個validate屬性，值為true。如< s:form validate="true" ... > ... < /form>即可。

三、驗證嵌套屬性

有一類特殊的屬性，即這個屬性的類型是另外一個JavaBean，如有一個User類，代碼如下：

package data;  
 
public class User  
{  
    private String name;  
    private int age;  
    public String getName()  
    {  
        return name;  
    }  
    public void setName(String name)  
    {  
        this.name = name;  
    }  
    public int getAge()  
    {  
        return age;  
    }  
    public void setAge(int age)  
    {  
        this.age = age;  
    }  
}  

在NewValidateAction類中加一個user屬性，代碼如下：

package action;  
 
import com.opensymphony.xwork2.ActionSupport;  
import data.User;  
 
public class NewValidateAction extends ActionSupport  
{  
    private String msg;  
    private int age;  
    private User user;  
    public String getMsg()  
    {  
        return msg;  
    }  
 
    public void setMsg(String msg)  
    {  
        this.msg = msg;  
    }  
    public int getAge()  
    {  
        return age;  
    }  
    public void setAge(int age)  
    {  
        this.age = age;  
    }  
    public User getUser()  
    {  
        return user;  
    }  
      
    public void setUser(User user)  
    {  
        this.user = user;  
    }  
}  

如果要驗證NewValidateAction中的user屬性，可以使用visitor驗證器。操作過程如下：

首先在NewValidateAction-validation.xml中加入一個< field>標簽，代碼如下：

< ?xml version="1.0" encoding="UTF-8"?> 
< !DOCTYPE validators PUBLIC "-//OpenSymphony Group//XWork Validator 1.0.2//EN"   
"http://www.opensymphony.com/xwork/xwork-validator-1.0.2.dtd"> 
< validators> 
       
    < field name="user"> 
    < field-validator type="visitor"> 
            < param name="context">abc< /param> 
            < param name="appendPrefix">true< /param> 
            < message>User:< /message> 
        < /field-validator> 
    < /field> 
< /validators> 

其中context參數將作為驗證User類屬性的文件名的一部分，如user屬性返回一個User對象，那么用于驗證User對象屬性的文件名為User-abc-validation.xml。這個文件要和User.class文件在同一個目錄中。appendPrefix表示是否在字段里加user，如果為true，Struts2就會使用user.name在form提交的數據中查找要驗證的數據。這個屬性的默認值是true。如果出錯，Struts2會將< message>標簽中的信息加到User-abc-validation.xml文件中的相應錯誤信息前面。

User-abc-validation.xml文件的內容如下：

< ?xml version="1.0" encoding="UTF-8"?> 
< !DOCTYPE validators PUBLIC "-//OpenSymphony Group//XWork Validator 1.0.2//EN"  
 "http://www.opensymphony.com/xwork/xwork-validator-1.0.2.dtd"> 
< validators> 
    < field name="name"> 
        < field-validator type="requiredstring"> 
            < message>請輸入name< /message> 
        < /field-validator> 
    < /field> 
    < field name="age"> 
        < field-validator type="int"> 
            < param name="min">5< /param> 
            < param name="max">20< /param> 
            < message> 
                必須在 5至20之間  
            < /message> 
        < /field-validator> 
    < /field> 
< /validators> 
 

下面修改validate_form.jsp，代碼如下：

< s:form validate="true" action="new_validate" namespace="/test" > 
     < s:textfield name="msg" label="姓名"  /> 
     < s:textfield name="age" label="年齡"/>   
     < s:textfield name="user.name" label="姓名1"  /> 
     < s:textfield name="user.age" label="年齡1"/>   
    < s:submit/> 
< /s:form> 

大家可以看到，***兩個< s:textfield>的name屬性是user.name和user.age，正好是加了前綴的。

現在重新訪問 http://localhost:8080/validation/validate_form.jsp，驗證界面如圖2所示。

經筆者測試，使用visitor無法以客戶端驗證的方式來驗證user屬性，但NewValidateAction中其他的屬性可以使用客戶端測試。

【編輯推薦】

1. Struts2教程：使用validate方法驗證數據
2. Struts2教程：struts.xml常用配置解析
3. Struts2教程：處理一個form多個submit
4. Struts2教程：***個Struts2程序
5. Struts2中POI在內存中生成文件并下載