Struts2教程:使用Validation框架驗證數(shù)據(jù)
在《Struts2教程4:使用validate方法驗證數(shù)據(jù)》中曾講到使用validate方法來驗證客戶端提交的數(shù)據(jù),但如果使用validate方法就會將驗證代碼和正常的邏輯代碼混在一起,但這樣做并不利于代碼維護,而且也很難將過些代碼用于其他程序的驗證。在Struts2中為我們提供了一個Validation框架,這個框架和Struts1.x提供的Validation框架類似,也是通過XML文件進行配置。
一、服務(wù)端驗證
下面將給出一個例子來演示如何使用Struts2的validation框架來進行服務(wù)端驗證。我們可以按著如下四步來編寫這個程序:
【第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步】編寫驗證規(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)容如下:
- < ?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>
 
這個文件使用了兩個規(guī)則:requiredstring(必須輸入)和int(確定整型范圍)。關(guān)于其他更詳細的驗證規(guī)則,請讀者訪問http://struts.apache.org/2.0.11.1/docs/validation.html來查看。
【第4步】編寫數(shù)據(jù)錄入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>驗證數(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>標(biāo)簽中指定namespace屬性,需要在< s:form>中也將namespace和action分開寫,如上面代碼所示。不能將其連在一起,Struts2需要分開的action和namespace。如下面的代碼是錯誤的:
< s:form action="/test/new_validate" >
... ...
< /s:form>
在上面的程序中還使用了一個styles.css來定制錯誤信息的風(fēng)格。代碼如下:
.label {font-style:italic; }
.errorLabel {font-style:italic; color:red; }
.errorMessage {font-weight:bold; color:red; }
需要在Web根目錄中建立一個styles目錄,并將styles.css
假設(shè)Web工程的上下文路徑是validation,可以使用如下的URL來測試這個程序:
http://localhost:8080/validation/validate_form.jsp
顯示結(jié)果如圖1所示。
圖1
二、客戶端驗證
在Struts2中實現(xiàn)客戶端驗證非常簡單,只需要在< 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>標(biāo)簽,代碼如下:
- < ?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參數(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>標(biāo)簽中的信息加到User-abc-validation.xml文件中的相應(yīng)錯誤信息前面。
User-abc-validation.xml文件的內(nèi)容如下:
- < ?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,正好是加了前綴的。
現(xiàn)在重新訪問 http://localhost:8080/validation/validate_form.jsp,驗證界面如圖2所示。
經(jīng)筆者測試,使用visitor無法以客戶端驗證的方式來驗證user屬性,但NewValidateAction中其他的屬性可以使用客戶端測試。
【編輯推薦】

















 
 
 
 
 
 
 