Struts2教程5：使用Validation框架驗證數(shù)據(jù)
本文為原創(chuàng)，如需轉(zhuǎn)載，請注明作者和出處，謝謝！上一篇：Struts2教程4：使用validate方法驗證數(shù)據(jù)
在《Struts2教程4：使用validate方法驗證數(shù)據(jù)》中曾講到使用validate方法來驗證客戶端提交的數(shù)據(jù)，但如果使用validate方法就會將驗證代碼和正常的邏輯代碼混在一起，但這樣做并不利于代碼維護，而且也很難將過些代碼用于其他程序的驗證。在Struts2中為我們提供了一個Validation框架，這個框架和Struts1.x提供的Validation框架類似，也是通過XML文件進行配置。
一、服務端驗證
下面將給出一個例子來演示如何使用Struts2的validation框架來進行服務端驗證。我們可以按著如下四步來編寫這個程序：
【第1步】建立Action類（NewValidateAction.java）
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的代碼如下：
<!DOCTYPE struts PUBLIC
"-//Apache Software Foundation//DTD Struts Configuration 2.0//EN"
"http://struts./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步】編寫驗證規(guī)則配置文件
這是一個基于XML的配置文件，和struts1.x中的validator框架的驗證規(guī)則配置文件類似。但一般放到和要驗證的.class文件在同一目錄下，而且配置文件名要使用如下兩個規(guī)則中的一個來命名：
<ActionClassName>-validation.xml
<ActionClassName>-<ActionAliasName>-validation.xml
其中<ActionAliasName>就是struts.xml中<ation>的name屬性值。在本例中我們使用第一種命名規(guī)則，所以文件名是NewValidateAction-validation.xml。文件的內(nèi)容如下：
<!DOCTYPE validators PUBLIC "-//OpenSymphony Group//XWork Validator 1.0.2//EN"
"http://www./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>
這個文件使用了兩個規(guī)則：requiredstring（必須輸入）和int（確定整型范圍）。關于其他更詳細的驗證規(guī)則，請讀者訪問http://struts./2.0.11.1/docs/validation.html來查看。
【第4步】編寫數(shù)據(jù)錄入JSP頁。
在Web根目錄中建立一個validate_form.jsp文件，代碼如下：
<%@ taglib prefix="s" uri="/struts-tags" %>
<link rel="stylesheet" type="text/css" href="<s:url value="/styles/styles.css"/>">
<html>
<head>
<title>驗證數(shù)據(jù)</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
二、客戶端驗證
在Struts2中實現(xiàn)客戶端驗證非常簡單，只需要在<s:form>中加入一個validate屬性，值為true。如<s:form validate="true" ... > ... </form>即可。
三、驗證嵌套屬性有一類特殊的屬性，即這個屬性的類型是另外一個JavaBean，如有一個User類，代碼如下：
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屬性，代碼如下：
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>標簽，代碼如下：
<!DOCTYPE validators PUBLIC "-//OpenSymphony Group//XWork Validator 1.0.2//EN"
"http://www./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參數(shù)將作為驗證User類屬性的文件名的一部分，如user屬性返回一個User對象，那么用于驗證User對象屬性的文件名為User-abc-validation.xml。這個文件要和User.class文件在同一個目錄中。appendPrefix表示是否在字段里加user，如果為true，Struts2就會使用user.name在form提交的數(shù)據(jù)中查找要驗證的數(shù)據(jù)。這個屬性的默認值是true。如果出錯，Struts2會將<message>標簽中的信息加到User-abc-validation.xml文件中的相應錯誤信息前面。
User-abc-validation.xml文件的內(nèi)容如下：<!DOCTYPE validators PUBLIC "-//OpenSymphony Group//XWork Validator 1.0.2//EN"
"http://www./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: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，正好是加了前綴的。
現(xiàn)在重新訪問 http://localhost:8080/validation/validate_form.jsp，驗證界面如圖2所示。
圖2
經(jīng)筆者測試，使用visitor無法以客戶端驗證的方式來驗證user屬性，但NewValidateAction中其他的屬性可以使用客戶端測試。
下一篇：Struts2教程6：在Action類中獲得HttpServletResponse對象的四種方法
