Struts2教程:使用Validation框架驗(yàn)證數(shù)據(jù)
在《Struts2教程4:使用validate方法驗(yàn)證數(shù)據(jù)》中曾講到使用validate方法來(lái)驗(yàn)證客戶端提交的數(shù)據(jù),但如果使用validate方法就會(huì)將驗(yàn)證代碼和正常的邏輯代碼混在一起,但這樣做并不利于代碼維護(hù),而且也很難將過(guò)些代碼用于其他程序的驗(yàn)證。在Struts2中為我們提供了一個(gè)Validation框架,這個(gè)框架和Struts1.x提供的Validation框架類似,也是通過(guò)XML文件進(jìn)行配置。
一、服務(wù)端驗(yàn)證
下面將給出一個(gè)例子來(lái)演示如何使用Struts2的validation框架來(lái)進(jìn)行服務(wù)端驗(yàn)證。我們可以按著如下四步來(lái)編寫這個(gè)程序:
【第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;
- }
- }
下面我們來(lái)驗(yàn)證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步】編寫驗(yàn)證規(guī)則配置文件
這是一個(gè)基于XML的配置文件,和struts1.x中的validator框架的驗(yàn)證規(guī)則配置文件類似。但一般放到和要驗(yàn)證的.class文件在同一目錄下,而且配置文件名要使用如下兩個(gè)規(guī)則中的一個(gè)來(lái)命名:
< 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>請(qǐng)輸入信息< /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>
這個(gè)文件使用了兩個(gè)規(guī)則:requiredstring(必須輸入)和int(確定整型范圍)。關(guān)于其他更詳細(xì)的驗(yàn)證規(guī)則,請(qǐng)讀者訪問(wèn)http://struts.apache.org/2.0.11.1/docs/validation.html來(lái)查看。
【第4步】編寫數(shù)據(jù)錄入JSP頁(yè)。
在Web根目錄中建立一個(gè)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>驗(yàn)證數(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。如下面的代碼是錯(cuò)誤的:
< s:form action="/test/new_validate" >
... ...
< /s:form>
在上面的程序中還使用了一個(gè)styles.css來(lái)定制錯(cuò)誤信息的風(fēng)格。代碼如下:
.label {font-style:italic; }
.errorLabel {font-style:italic; color:red; }
.errorMessage {font-weight:bold; color:red; }
需要在Web根目錄中建立一個(gè)styles目錄,并將styles.css
假設(shè)Web工程的上下文路徑是validation,可以使用如下的URL來(lái)測(cè)試這個(gè)程序:
http://localhost:8080/validation/validate_form.jsp
顯示結(jié)果如圖1所示。
圖1
二、客戶端驗(yàn)證
在Struts2中實(shí)現(xiàn)客戶端驗(yàn)證非常簡(jiǎn)單,只需要在< s:form>中加入一個(gè)validate屬性,值為true。如< s:form validate="true" ... > ... < /form>即可。
三、驗(yàn)證嵌套屬性
有一類特殊的屬性,即這個(gè)屬性的類型是另外一個(gè)JavaBean,如有一個(gè)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類中加一個(gè)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;
- }
- }
如果要驗(yàn)證NewValidateAction中的user屬性,可以使用visitor驗(yàn)證器。操作過(guò)程如下:
首先在NewValidateAction-validation.xml中加入一個(gè)< 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ù)將作為驗(yàn)證User類屬性的文件名的一部分,如user屬性返回一個(gè)User對(duì)象,那么用于驗(yàn)證User對(duì)象屬性的文件名為User-abc-validation.xml。這個(gè)文件要和User.class文件在同一個(gè)目錄中。appendPrefix表示是否在字段里加user,如果為true,Struts2就會(huì)使用user.name在form提交的數(shù)據(jù)中查找要驗(yàn)證的數(shù)據(jù)。這個(gè)屬性的默認(rèn)值是true。如果出錯(cuò),Struts2會(huì)將< message>標(biāo)簽中的信息加到User-abc-validation.xml文件中的相應(yīng)錯(cuò)誤信息前面。
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>請(qǐng)輸入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>
大家可以看到,***兩個(gè)< s:textfield>的name屬性是user.name和user.age,正好是加了前綴的。
現(xiàn)在重新訪問(wèn) http://localhost:8080/validation/validate_form.jsp,驗(yàn)證界面如圖2所示。
經(jīng)筆者測(cè)試,使用visitor無(wú)法以客戶端驗(yàn)證的方式來(lái)驗(yàn)證user屬性,但NewValidateAction中其他的屬性可以使用客戶端測(cè)試。
【編輯推薦】