天天看點

Struts2教程5:使用Validation架構驗證資料

在《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>

</validators>

【第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所示。

Struts2教程5:使用Validation架構驗證資料

圖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;

在NewValidateAction類中加一個user屬性,代碼如下:

import data.User;

    private String msg;

    private User user;

    public User getUser()

        return user;

    public void setUser(User user)

        this.user = user;

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

首先在NewValidateAction-validation.xml中加入一個<field>标簽,代碼如下:

Struts2教程5:使用Validation架構驗證資料
Struts2教程5:使用Validation架構驗證資料

    <field name="user">

    <field-validator type="visitor">

            <param name="context">abc</param>

            <param name="appendPrefix">true</param>

            <message>User:</message>

其中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檔案的内容如下:

 "http://www.opensymphony.com/xwork/xwork-validator-1.0.2.dtd">

    <field name="name">

            <message>請輸入name</message>

            <param name="min">5</param>

                必須在 5至20之間

下面修改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:textfield>的name屬性是user.name和user.age,正好是加了字首的。

現在重新通路 http://localhost:8080/validation/validate_form.jsp,驗證界面如圖2所示。

Struts2教程5:使用Validation架構驗證資料

                                           圖2

經筆者測試,使用

visitor

無法以用戶端驗證的方式來驗證

user

屬性,但

NewValidateAction

中其他的屬性可以使用用戶端測試。