在《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;
}
}
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 >
<! 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 >
<! 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 >
< %@ 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 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
所示。
http://localhost:8080/validation/validate_form.jsp
图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;
}
}
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;
}
}
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 >
<! 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 >
<! 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 ="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
中其他的属性可以使用客户端测试。
本文转自 androidguy 51CTO博客,原文链接:
http://blog.51cto.com/androidguy/216504
,如需转载请自行联系原作者