Struts2教程:使用Validation框架验证数据

开发 后端
本文为Struts2教程,本部分教你如何使用Validation框架验证数据。Struts2虽然在大版本号上是第二个版本,但基本上在配置和使用上已经完全颠覆了Struts1.x的方式。

在《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;  
    }  
}  
  • 1.
  • 2.
  • 3.
  • 4.
  • 5.
  • 6.
  • 7.
  • 8.
  • 9.
  • 10.
  • 11.
  • 12.
  • 13.
  • 14.
  • 15.
  • 16.
  • 17.
  • 18.
  • 19.
  • 20.
  • 21.
  • 22.
  • 23.
  • 24.
  • 25.

下面我们来验证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> 
  • 1.
  • 2.
  • 3.
  • 4.
  • 5.
  • 6.
  • 7.
  • 8.
  • 9.
  • 10.
  • 11.
  • 12.

【第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> 
  • 1.
  • 2.
  • 3.
  • 4.
  • 5.
  • 6.
  • 7.
  • 8.
  • 9.
  • 10.
  • 11.
  • 12.
  • 13.
  • 14.
  • 15.
  • 16.
  • 17.
  • 18.
  • 19.

这个文件使用了两个规则: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> 
  • 1.
  • 2.
  • 3.
  • 4.
  • 5.
  • 6.
  • 7.
  • 8.
  • 9.
  • 10.
  • 11.
  • 12.
  • 13.
  • 14.
  • 15.

大家要注意一下,如果在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 显示结果 

图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;  
    }  
}  
  • 1.
  • 2.
  • 3.
  • 4.
  • 5.
  • 6.
  • 7.
  • 8.
  • 9.
  • 10.
  • 11.
  • 12.
  • 13.
  • 14.
  • 15.
  • 16.
  • 17.
  • 18.
  • 19.
  • 20.
  • 21.
  • 22.
  • 23.

在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;  
    }  
}  
  • 1.
  • 2.
  • 3.
  • 4.
  • 5.
  • 6.
  • 7.
  • 8.
  • 9.
  • 10.
  • 11.
  • 12.
  • 13.
  • 14.
  • 15.
  • 16.
  • 17.
  • 18.
  • 19.
  • 20.
  • 21.
  • 22.
  • 23.
  • 24.
  • 25.
  • 26.
  • 27.
  • 28.
  • 29.
  • 30.
  • 31.
  • 32.
  • 33.
  • 34.
  • 35.
  • 36.
  • 37.

如果要验证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> 
  • 1.
  • 2.
  • 3.
  • 4.
  • 5.
  • 6.
  • 7.
  • 8.
  • 9.
  • 10.
  • 11.
  • 12.
  • 13.

其中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> 
 
  • 1.
  • 2.
  • 3.
  • 4.
  • 5.
  • 6.
  • 7.
  • 8.
  • 9.
  • 10.
  • 11.
  • 12.
  • 13.
  • 14.
  • 15.
  • 16.
  • 17.
  • 18.
  • 19.
  • 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:form> 
  • 1.
  • 2.
  • 3.
  • 4.
  • 5.
  • 6.
  • 7.

大家可以看到,***两个< s:textfield>的name属性是user.name和user.age,正好是加了前缀的。

现在重新访问 http://localhost:8080/validation/validate_form.jsp,验证界面如图2所示。

图2 验证界面 

经笔者测试,使用visitor无法以客户端验证的方式来验证user属性,但NewValidateAction中其他的属性可以使用客户端测试。

【编辑推荐】

  1. Struts2教程:使用validate方法验证数据
  2. Struts2教程:struts.xml常用配置解析
  3. Struts2教程:处理一个form多个submit
  4. Struts2教程:***个Struts2程序
  5. Struts2中POI在内存中生成文件并下载
责任编辑:yangsai 来源: BlogJava
相关推荐

2009-02-04 13:13:03

2009-06-25 15:33:12

Struts2教程使用validate验证数据

2009-06-04 11:08:32

struts2 val框架

2009-02-04 12:00:08

2011-03-30 09:03:57

struts2

2009-06-05 09:58:20

struts2验证用户注册

2009-06-25 15:11:28

Struts2教程Struts2程序

2009-02-04 10:51:07

2009-06-03 14:19:34

Struts2Guice

2009-06-25 16:04:30

2009-06-25 15:26:25

Struts2教程struts.xml常

2012-05-10 14:00:06

StrutsjsonJava

2009-02-04 15:04:13

2009-06-25 15:54:42

Struts2教程拦截器

2009-06-25 15:50:03

Struts2教程上传任意多个文件

2009-07-29 09:54:34

struts2和str

2009-02-04 11:37:15

2009-02-04 14:00:59

2009-06-04 09:20:19

struts2 if标使用

2009-02-04 14:19:38

点赞
收藏

51CTO技术栈公众号