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

本文为原创,如需转载,请注明作者和出处,谢谢!

上一篇:Struts2教程4:使用validate方法验证数据

在《Struts2教程4:使用validate方法验证数据》中曾讲到使用validate方法来验证客户端提交的数据,但如果使用validate方法就会将验证代码和正常的逻辑代码混在一起,但这样做并不利于代码维护,而且也很难将过些代码用于其他程序的验证。在Struts2中为我们提供了一个Validation框架,这个框架和Struts1.x提供的Validation框架类似,也是通过XML文件进行配置。

一、服务端验证

下面将给出一个例子来演示如何使用Struts2validation框架来进行服务端验证。我们可以按着如下四步来编写这个程序:

【第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;
    }
}

下面我们来验证msgage属性。

【第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>中也将namespaceaction分开写,如上面代码所示。不能将其连在一起,Struts2需要分开的actionnamespace。如下面的代码是错误的:

<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,如果为trueStruts2就会使用user.nameform提交的数据中查找要验证的数据。这个属性的默认值是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.nameuser.age,正好是加了前缀的。

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


                                                   

                                           2


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


下一篇:Struts2教程6:在Action类中获得HttpServletResponse对象的四种方法


posted on 2008-04-21 20:06 银河使者 阅读(4586) 评论(17)  编辑  收藏 所属分类: Struts2 原创

评论

# re: Struts2教程5:使用Validation框架验证数据 2008-06-02 21:30 Jeanvixue

为什么我按这个方法去做, 不会显示不良的信息呢? 你例子中的红色字体部分. 谢谢.  回复  更多评论   

# re: Struts2教程5:使用Validation框架验证数据 2008-06-02 22:01 Jeanvixue

需要设置其他的什么属性之类的来达到的吗?  回复  更多评论   

# re: Struts2教程5:使用Validation框架验证数据 2008-06-02 22:17 银河使者

@Jeanvixue

有可能是你的用于验证的xml文件名不对。或是嵌套字段写的不对。如下面的所示:

<s:textfield name="user.name" label="姓名1" />
<s:textfield name="user.age" label="年龄1"/>

再仔细检查一下。  回复  更多评论   

# re: Struts2教程5:使用Validation框架验证数据 2008-06-03 16:17 Jeanvixue

以下是我实际使用的部分, 但是没有办法看到提示的信息.
JSP内容:
<s:form action="login">
<s:textfield name="username" key="username"/>
<s:password name="password" key="password" />

<s:submit key="login"></s:submit>
</s:form>

loging的Class为loginAction
loginAction-validation.xml内容:
<validators>
<field name="username">
<field-validator type="requiredstring">
<message>usernamerequired</message>
</field-validator>
</field>
</validators>  回复  更多评论   

# re: Struts2教程5:使用Validation框架验证数据 2008-06-03 16:27 银河使者

有几点你可以看一下。
1. 类名是loginAction吗?一般类名单词第一个字母都是大写,如LoginAction。看看是不是名子弄错了。是区分大小写的。
2. 验证xml文件名为:类名-validation.xml,如类名为LoginAction,xml文件名为LoginAction-validation.xml,注意大小写。
3. LoginAction-validation.xml和LoginAction.class必须在同一个目录下。看看这些文件的位置  回复  更多评论   

# re: Struts2教程5:使用Validation框架验证数据 2008-06-03 17:10 Jeanvixue

谢谢您的回复.
以上3点没有问题我都注意到了, 因为我的手误,所以我把LoginAction的第一个字母用了小写了. 所以我就都用小写了.
我用的是Netbeans6.1进行开发的. 我不知道是否还有哪里的设置会影响到这些.  回复  更多评论   

# re: Struts2教程5:使用Validation框架验证数据 2008-06-03 20:06 银河使者

我没用过netbeans6.1开发过基于struts的程序,用的是myeclipse6.x。

但我想netbeans6.1应该差不多。至于没出来错误提示的原因可能是某些资源没找到,如资源文件、验证文件(可能路径不对)、或是要验证的属性写的不正确。具体的只有调程序才能出来,原因很多。  回复  更多评论   

# re: Struts2教程5:使用Validation框架验证数据 2008-06-03 20:07 银河使者

建议你做个简单的程序,用记事本写个程序,最简单的,按着步骤写,看看到底是哪个地方出错了。用struts做这些东西稍有不注意,就可能出错。  回复  更多评论   

# re: Struts2教程5:使用Validation框架验证数据 2008-08-20 11:53 bigheadbird

大家要注意一下,如果在struts.xml的<package>标签中指定namespace属性,需要在<s:form>中也将namespace和action分开写,如上面代码所示。不能将其连在一起,Struts2需要分开的action和namespace。如下面的代码是错误的:

<s:form action="/test/new_validate" >

... ...

</s:form>


你这里提到这个,但你前面的章节都是这样写的

<s:form action="mystruts/sum.action" >
<s:textfield name="operand1" label=" 操作数1"/>
<s:textfield name="operand2" label=" 操作数2" />
<s:submit value="代数和" />
</s:form>

让我很郁闷!!!!
  回复  更多评论   

# re: Struts2教程5:使用Validation框架验证数据 2008-08-20 13:04 银河使者

to bigheadbird

是这样的,可能是我没写清楚。在struts 2中,如果在<package>标签中加namespace,一般需要在<s:form>标签中使用namespace指定命名空间,再用action属性指定动作名,代码如下:
<s:form action="abcd" namespace="xyz" >
... ...
</s:form>

上面的代码所对应的struts.xml中定义如下:
<package name="mypackage" namespace="xyz" extends="struts-default">
<action name="abcd" class="..."/>
</package>

如果按着上面的写法是没有任何问题的,也是Struts 2建议的方式
但要知道,<s:form>实际上就是对应的html的<form>标签,而action属性其实就是<form>的属性,因此,也可以直接将命名空间写在action属性值中,而不使用<s:form>的namespace属性。如下面代码所示:
<s:form action="mystruts/sum.action" >
<s:textfield name="operand1" label=" 操作数1"/>
<s:textfield name="operand2" label=" 操作数2" />
<s:submit value="代数和" />
</s:form>

这么做同样可以成功提交给Action类,但这么做,Struts 2会在控制台输出一个类似于下面的警告:
警告: No configuration found for the specified action: 'xyz/parent.action' in namespace: ''. Form action defaulting to 'action' attribute's literal value.
说是未找到xyz/parent.action, 这也说明Struts 2在处理时是将namespace和action属性分开的。但这个警告并不会影响程序的运行。就象我们在编写java或其他语言的程序时,编译器可能会出现一些警告信息,但仍然可以编译通过,并成功运行。
但要注意,如果不使用namespace,只使用action来表示命名空间的话,后面必须加上“.action”后缀,如果Struts 2未找到这个action,是不会自动加上.action后缀的。

实际上,还可以直接使用<form>来处理

我在后面的程序中直接使用了第二种方式,其实读者可以选择自己想用的方式,但笔者建议使用Struts 2建议的第一种方式。  回复  更多评论   

# re: Struts2教程5:使用Validation框架验证数据 2008-08-20 15:04 bigheadbird

哈哈,回复很及时,很详细.谢谢.  回复  更多评论   

# re: Struts2教程5:使用Validation框架验证数据 2008-09-27 17:00

您好 ,请问您验证后的错误信息是用什么标签显示出来的,我显示不出来,谢谢  回复  更多评论   

# re: Struts2教程5:使用Validation框架验证数据 2008-09-29 10:26 银河使者

to 董

是这样的,如果使用Struts 2的<s:textfield>或其他的表单标签,字段错误是可以自动显示出的,并不需要编写代码或使用<s:fielderror/>标签去显示,当然,使用<s:fielderror/>标签也可以显示字段错误,但就重复了。

如果使用普通的html标签,就需要使用<s:fielderror/>标签显示字段错误了。如果是动作错误或消息,就需要使用<actionerror/>或<actionmessage/>标签显示了。  回复  更多评论   

# re: Struts2教程5:使用Validation框架验证数据 2008-09-30 22:30 jackie

您好!我把类和valition.xml文件放置在同一个包中,配置文件也配置好了,但是出错信息不会显示(红色部分),是什么原因!配置也和你的服务器端验证的例子一样,导入显示出错信息的样式,但并没有进行验证!  回复  更多评论   

# re: Struts2教程5:使用Validation框架验证数据 2008-09-30 22:49 银河使者

不是validation.xmL文件,是<ActionClassName>-validation.xml文件  回复  更多评论   

# re: Struts2教程5:使用Validation框架验证数据 2008-10-24 10:45 lyshyhaungli

Document root element "validators", must match DOCTYPE root "struts".
我出现了这个错误
怎么也找不错来问题。
请指教!  回复  更多评论   

# re: Struts2教程5:使用Validation框架验证数据 2008-10-24 10:54 lyshyhaungli

我解决了这个问题了
哈哈!!  回复  更多评论   


标题  
姓名  
主页
验证码 *  
内容(请不要发表任何与政治相关的内容)  
  登录  使用高级评论  新用户注册  返回页首  恢复上次提交      
该文被作者在 2008-05-24 09:03 编辑过
 
 

相关链接:
网站导航:



<2008年9月>
31123456
78910111213
14151617181920
21222324252627
2829301234
567891011

导航

统计

公告

我的其他blog
http://nokiaguy.cnblogs.com

常用链接

留言簿(4)

我参与的团队

随笔分类(150)

随笔档案(70)

相册

搜索

积分与排名

最新评论

阅读排行榜

评论排行榜