在《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所示。
圖2
經筆者測試,使用visitor無法以客戶端驗證的方式來驗證user屬性,但NewValidateAction中其他的屬性可以使用客戶端測試。