随笔 - 312, 文章 - 14, 评论 - 1393, 引用 - 0
数据加载中……

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对象的四种方法






Android开发完全讲义(第2版)(本书版权已输出到台湾)

http://product.dangdang.com/product.aspx?product_id=22741502



Android高薪之路:Android程序员面试宝典 http://book.360buy.com/10970314.html


新浪微博:http://t.sina.com.cn/androidguy   昵称:李宁_Lining

posted on 2008-04-21 20:06 银河使者 阅读(37779) 评论(32)  编辑  收藏 所属分类: 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框架验证数据  回复  更多评论   

@Jeanvixue

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

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

再仔细检查一下。
2008-06-02 22:17 | 银河使者

# re: Struts2教程5:使用Validation框架验证数据  回复  更多评论   

以下是我实际使用的部分, 但是没有办法看到提示的信息.
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>
2008-06-03 16:17 | Jeanvixue

# re: Struts2教程5:使用Validation框架验证数据  回复  更多评论   

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

# re: Struts2教程5:使用Validation框架验证数据  回复  更多评论   

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

# re: Struts2教程5:使用Validation框架验证数据  回复  更多评论   

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

但我想netbeans6.1应该差不多。至于没出来错误提示的原因可能是某些资源没找到,如资源文件、验证文件(可能路径不对)、或是要验证的属性写的不正确。具体的只有调程序才能出来,原因很多。
2008-06-03 20:06 | 银河使者

# re: Struts2教程5:使用Validation框架验证数据  回复  更多评论   

建议你做个简单的程序,用记事本写个程序,最简单的,按着步骤写,看看到底是哪个地方出错了。用struts做这些东西稍有不注意,就可能出错。
2008-06-03 20:07 | 银河使者

# re: Struts2教程5:使用Validation框架验证数据  回复  更多评论   

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

让我很郁闷!!!!
2008-08-20 11:53 | bigheadbird

# re: Struts2教程5:使用Validation框架验证数据  回复  更多评论   

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建议的第一种方式。
2008-08-20 13:04 | 银河使者

# re: Struts2教程5:使用Validation框架验证数据  回复  更多评论   

哈哈,回复很及时,很详细.谢谢.
2008-08-20 15:04 | bigheadbird

# re: Struts2教程5:使用Validation框架验证数据  回复  更多评论   

您好 ,请问您验证后的错误信息是用什么标签显示出来的,我显示不出来,谢谢
2008-09-27 17:00 |

# re: Struts2教程5:使用Validation框架验证数据  回复  更多评论   

to 董

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

如果使用普通的html标签,就需要使用<s:fielderror/>标签显示字段错误了。如果是动作错误或消息,就需要使用<actionerror/>或<actionmessage/>标签显示了。
2008-09-29 10:26 | 银河使者

# re: Struts2教程5:使用Validation框架验证数据  回复  更多评论   

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

# re: Struts2教程5:使用Validation框架验证数据  回复  更多评论   

不是validation.xmL文件,是<ActionClassName>-validation.xml文件
2008-09-30 22:49 | 银河使者

# re: Struts2教程5:使用Validation框架验证数据  回复  更多评论   

Document root element "validators", must match DOCTYPE root "struts".
我出现了这个错误
怎么也找不错来问题。
请指教!
2008-10-24 10:45 | lyshyhaungli

# re: Struts2教程5:使用Validation框架验证数据  回复  更多评论   

我解决了这个问题了
哈哈!!
2008-10-24 10:54 | lyshyhaungli

# re: Struts2教程5:使用Validation框架验证数据  回复  更多评论   

那么麻烦的验证??而且还要把验证的xml和bean放在同一个目录下.我们的工程bean本来就是jar包.
2009-02-10 12:11 | 1121

# re: Struts2教程5:使用Validation框架验证数据  回复  更多评论   

@1121
放到一起是在开发阶段,发布了,就已经放到jar包中了。
2009-02-10 12:27 | 银河使者

# re: Struts2教程5:使用Validation框架验证数据  回复  更多评论   

lz写得很好啊
问个问题哈:这个例子里如果不想要验证了,是不是光把<s:form>中的validate=true去掉是不够的吧?是不是还得把*-validation.xml中的想对应的部分去掉?
谢谢!
2009-08-11 14:19 | 五角

# re: Struts2教程5:使用Validation框架验证数据  回复  更多评论   

-..- 照着作者的方法写了验证..一点作用也没有....
完全不知道错误出在哪里..
大小写,名称,字段,检查了又检查..

但是是一点反应也没有..
2009-10-01 10:46 | Cancer

# re: Struts2教程5:使用Validation框架验证数据  回复  更多评论   

知道怎么 指定 验证 某个 方法 么
2010-04-10 15:21 | grass

# re: Struts2教程5:使用Validation框架验证数据  回复  更多评论   

在<s:form>标签中加入validate=true属性,就为客户端验证。。没试出来效果,好像跟不写,没什么区别呀,验证时,还是会刷页面,地址栏跳到action中。到底这里说的,客户端验证,是什么意思呀?
2010-07-03 10:03 | elvis

# re: Struts2教程5:使用Validation框架验证数据  回复  更多评论   

不错,就是验证没试出来,诶
2011-03-22 17:11 | 死掉

# re: Struts2教程5:使用Validation框架验证数据[未登录]  回复  更多评论   

如你所说:

两个规则中的一个来命名:

<ActionClassName>-validation.xml

<ActionClassName>-<ActionAliasName>-validation.xml

其中<ActionAliasName>就是struts.xml中<ation>的name属性值。


N久没试出来!!!!!


我的struts.xml 是这样:
<action name="login" class="action.MyAction">
<result name="input">/login.jsp</result>
<result name="success">/login.jsp</result>
<result name="login">/login.jsp</result>
</action>


验证的xml 取名是这样login-validation.xml action 的name属性值是login吧?
后来改成MyAction-validation.xml 就ok 了,是我理解错了,还是你忽悠人呢?
2012-01-04 13:09 | 小拽

# re: Struts2教程5:使用Validation框架验证数据  回复  更多评论   

警告: Error setting expression 'age' with value '[Ljava.lang.String;@8698fa'

当年龄 那一栏 不写 的时候 爆这个警告
2012-07-26 11:35 | 110

# re: Struts2教程5:使用Validation框架验证数据  回复  更多评论   

傻逼
2012-07-27 16:04 | ssss

# re: Struts2教程5:使用Validation框架验证数据  回复  更多评论   

一、服务端验证,没有反应,是不是少了什么代码没贴
2013-02-16 10:28 | 彭堃

# re: Struts2教程5:使用Validation框架验证数据  回复  更多评论   


@Cancer
validation.xml没有和验证类放在同一个文件夹下
2013-02-17 11:41 | 彭堃

# re: Struts2教程5:使用Validation框架验证数据[未登录]  回复  更多评论   

@elvis
你查看网页源代码就能看出来了。 加了validate=“true"的客户端会自动生成js代码做验证。而不加的不会有js代码,也就是在服务端做的验证。我想这样做的原因是为了让客户端分担服务端的压力吧!
2013-05-06 15:39 | zm

# re: Struts2教程5:使用Validation框架验证数据  回复  更多评论   

试过验证错误信息没出来
2014-03-09 21:57 | Fylee

# re: Struts2教程5:使用Validation框架验证数据  回复  更多评论   

我在最代码网站上转载了你的文章,有问题请回复,地址:http://www.zuidaima.com/share/1778685765291008.htm
2014-04-13 22:01 | 最代码

只有注册用户登录后才能发表评论。


网站导航: