浏览 19646 次
|
锁定老帖子 主题：struts的验证框架详细介绍
精华帖 (0) :: 良好帖 (0) :: 新手帖 (0) :: 隐藏帖 (0)
|
|
|---|---|
| 作者 | 正文 |
|
发表时间：2009-01-06
最后修改：2009-02-16
引言
数据校验也称为输入校验，指导对用户的输入进行基本的过滤，包括必填的字段，字段必须为数字及两次输入的密码必须匹配等。本文重点介绍了struts的校验框架。 1、struts的数据校验大致有如下几种方式：
1.1 ActionForm的代码校验 ActionForm的代码校验是最基本的校验方式。这种校验方式是重写ActionForm的validate方法，在该方法内对所有的字段进行基本的校验。如果出现不符合要求的输出，则将出错提示封装在ActionError对象里，最后将多个ActionError组合成ActionErrors对象，给对象里封装了全部的出错信息。 以登陆页面为例，下面是重写了Validate方法的ActionForm的代码： import javax.servlet.http.HttpServletRequest;
import org.apache.struts.action.ActionError;
import org.apache.struts.action.ActionErrors;
import org.apache.struts.action.ActionForm;
import org.apache.struts.action.ActionMapping;
public class LoginActionForm extends ActionForm {
private static final long serialVersionUID = 1L;
private String username;
private String password;
public String getUsername() {
return username;
}
public void setUsername(String username) {
this.username = username;
}
public String getPassword() {
return password;
}
public void setPassword(String password) {
this.password = password;
}
//重写validate方法，完成数据校验
@SuppressWarnings("deprecation")
@Override
public ActionErrors validate(ActionMapping mapping,
HttpServletRequest request) {
//ActionErrors用于包装所有的出错信息
ActionErrors errors = new ActionErrors();
//如果用户名为空
if((username == null)||(username.equals(""))) {
//error.username对应资源文件中的key,用户名是对应资源文件的第一个参数
errors.add("username", new ActionError("error.username","用户名"));
}
//如果密码为空
if((password == null )||(password.equals(""))) {
errors.add("password", new ActionError("error.password","密码"));
}
//返回封装了所有的出错信息
return errors;
}
}
在JSP页面中值需要更改一处即可****之间的部分： <%@ page language="java" contentType="text/html; charset=GB2312" errorPage="error.jsp"%>
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<%@ taglib prefix="bean" uri="http://struts.apache.org/tags-bean"%>
<%@ taglib prefix="html" uri="http://struts.apache.org/tags-html" %>
<html>
<head>
<!-- 使用国际化资源文件的key输出标题 -->
<title><bean:message key="login"/></title>
</head>
<!-- 下面的标签用于输出出错信息 -->
<!-- *******************************************-->
<html:errors/>
<!-- ******************************************* -->
<body>
<font color="red">
<%
//用于输出出错信息，出错信息保存在request的err属性中
if(request.getAttribute("err")!=null) {
out.println(request.getAttribute("err"));
}
%>
</font>
<br><br>
<!-- 下面是登陆表单 -->
请输入用户名和密码：<hr>
<html:form action="login.do" method="post">
<bean:message key="username" />:<html:text property="username" />
<br>
<bean:message key="password" />:<html:text property="password" />
<br>
<html:submit>
<bean:message key="login"/>
</html:submit>
<br>
</html:form>
</body>
</html>
由于在本项目中用到了资源文件，因为有了资源文件的支持，JSP页面只需要简单的<html:errors/>标签就可以生成全部的出错信息，下面是资源文件： # -- standard errors --
username=用户名
password=密码
login=登陆
noname=请输入用户名，然后在登陆
nopassword=请输入密码，然后在登陆
#html:errors将自动加载errors.header作为出错提示标题
errors.header=<h3><font color="red">验证出错</font></h3>你必须按以下提示修改你的输入才能继续....
error.username={0} 必须填写.<br>
error.password={0} 必须填写.<br>
#html:errors将自动加载errors.footer作为出错的最后一行
errors.footer=<h3><font color="green">你完成上面提示部分</font></h3>
注：上述资源文件还不能直接在项目中应用，在使用前需要转换成unicode格式。 命令：native2ascii MessageResources_zh_CN.properties MessageResources.properties 以上是使用ActionForm进行数据验证的方法，但是使用ActionForm的数据验证有个显著的问题：ActionErrors和ActionError都是struts不在推荐使用的类，因此，应尽量避免使用这种验证方法。 1.2 Action的代码验证 在Action里通过代码完成输入验证，是最基本，也是最容易使用的方法。与当初的MVC设计相似，在调用业务逻辑组件之前，先对数据进行基本的验证，这是最传统也是最原始的方法。 在Action里面完成数据验证，实际上就是在execute方法前面增加数据验证的部分代码。下面是增加了数据验证Action代码： import java.sql.ResultSet;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
import org.apache.struts.action.Action;
import org.apache.struts.action.ActionForm;
import org.apache.struts.action.ActionForward;
import org.apache.struts.action.ActionMapping;
import cn.com.newcom.dao.DbDao;
public class LoginAction extends Action {
@Override
//必须重写核心方法，该方法负责处理用户的请求
public ActionForward execute(ActionMapping mapping, ActionForm form,
HttpServletRequest request, HttpServletResponse response)
throws Exception {
//解析用户请求参数
LoginActionForm laf = (LoginActionForm)form;
String username = laf.getUsername();
System.out.println(" 您输入的用户名是："+username);
String password = laf.getPassword();
//出错提示
String errMsg = "";
// 完成服务器端的校验
if (username == null || username.equals("")) {
errMsg += "您的用户名丢失或没有输入，请重新输入！";
} else if (password == null || password.equals("")) {
errMsg += "您的密码丢失或是没有输入密码，请重新输入！";
} else {
//如果通过校验，则开始调用业务逻辑
}
}
}
这种校验方式非常容易理解，所有的代码都需要程序员自己控制，相当灵活。但有几个不方便的地方：
注意：在实际的使用中，这种校验方式不仅使程序开发变得复杂，且性能也不高。 1.3 Validator验证框架 利用Struts的提供的Validator验证框架可实现客户端和服务器端双验证。Struts的Validator验证框架定义了常用的十几个验证规则，如：required(验证非空)、minlength(验证最小长度)、maxlength(验证最大长度)、intRange(验证整形范围)、email(验证电子邮件地址)、date(验证日期)等，并且实现了客户端的Javascript验证和服务器端验证，以下是在myeclipse环境下使用Validator验证框架的步骤： 1. 配置 目前使用的版本是Struts1.2.9(下载地址：http://struts.apache.org/download.cgi)，里面有validator-rules.xml和validator.xml两个文件，在使用Validator之前，需要先配置一些东西。 1）必要的包： 将Struts发行包中的commons-validator.jar和jakarta-oro.jar这两个文件放到Web应用的WEB-INF/lib目录中。 2）自己定义的FormBean需要继承ValidatorForm,代码如下： import org.apache.struts.validator.ValidatorForm;
public class LoginActionForm extends ValidatorForm {
private static final long serialVersionUID = 1L;
private String username;
private String password;
public String getUsername() {
return username;
}
public void setUsername(String username) {
this.username = username;
}
public String getPassword() {
return password;
}
public void setPassword(String password) {
this.password = password;
}
}
注：Validator框架不能用于验证标准的org.apache.struts.action.ActionForm类。如果要使用Validator框架应该采用ActionForm类的两个子类：DynavalidatorForm和ValidatorForm。 3）编写表单域时必须满足的校验规则。校验规则都由规则文件控制，规则文件有以下两个：
第一个文件可在struts的解压缩后的文件夹lib下找到，只需将该文件复制到WEB-INF路径下，该文件是通用文件，一般不需要修改。除非打算修改或扩展这组规则，否则无需修改这个文件！ 注意1：需要在资源包(ApplicationResources.properties)中加上一下的“键-值”： # -- standard errors --
username=username
password=password
login=submit
noname=please enter name
nopassword=please enter password
# Struts Validator Error Messages
errors.required={0} is required.
errors.minlength={0} can not be less than {1} characters.
errors.maxlength={0} can not be greater than {1} characters.
errors.invalid={0} is invalid.
errors.byte={0} must be a byte.
errors.short={0} must be a short.
errors.integer={0} must be an integer.
errors.long={0} must be a long.
errors.float={0} must be a float.
errors.double={0} must be a double.
errors.date={0} is not a date.
errors.range={0} is not in the range {1} through {2}.
errors.creditcard={0} is an invalid credit card number.
errors.email={0} is an invalid e-mail address.
#loginForm
loginActionForm.login=username
因为，验证出错的时候，系统会自动在资源包中查找对应的错误消息， 比如：required验证规则出现错误时，就会输出“errors.required”的值。 注意2：在Struts 1.2.9中，验证类使用的是：“org.apache.struts.validator.FieldChecks”， 以前使用的是“org.apache.struts.util.StrutsValidtor”， 只要是从struts 1.2.x发行包中拷贝的“validation-rules.xml”文件，就可以保证是正确的。 而第二个validation.xml文件则是属于你自己项目的校验文件，负责每个表单域必须满足的规则，同样也要放在WEB-INF路径下面： 下面是本示例程序的validation.xml文件： <?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE form-validation PUBLIC "-//Apache Software Foundation//DTD Commons Validator Rules Configuration 1.0.1//EN"
"validator_1_0_1.dtd" >
<!-- 检验规则文件的根元素 -->
<form-validation>
<!-- 所需要校验的form都放在formset元素里面 -->
<formset>
<!-- 定义需要校验的表单，此处的name必须与struts-config.xml中定义的FormBean的名字一致 -->
<form name="loginActionForm">
<!-- 每个field元素定义一个表单域，即要验证的字段；必须满足怎样的规则 -->
<field property="username" depends="required">
<!-- field:要验证的字段，即属性，depends:依赖的验证规则 -->
<arg0 key="loginActionForm.login" />
<!-- arg0:在资源包中配置错误消息的{0}参数值 -->
</field>
<field property="password" depends="required,minlength">
<!-- 多个验证规则用逗号分割 -->
<arg0 key="loginActionForm.password" />
<arg1 name="minlength" key="#{var:minlength}" resource="false" />
<!-- resource:false该key的值不在资源包中给出，而是在本文件给 -->
<var>
<!-- 定义变量，给上面的key所用 -->
<var-name>minlength</var-name>
<var-value>5</var-value>
</var>
</field>
</form>
</formset>
</form-validation>
4）在struts-config.xml中设置插件： <plug-in className="org.apache.struts.validator.ValidatorPlugIn"> <set-property property="pathnames" value="/WEB-INF/validator-rules.xml,/WEB-INF/validation.xml" /> </plug-in> 注：value值用来指定验证规则的文件的路径，多个验证规则文件要用逗号分割 同时还要在该文件中的Action元素里面增加两个属性：input属性和validate属性，input属性指定不满足规则时返回的页面，应该将validate的属性值设置为true。 5）修改JSP页面 代码如下： <%@ page language="java" contentType="text/html; charset=GB2312" errorPage="error.jsp"%>
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<%@ taglib prefix="bean" uri="http://struts.apache.org/tags-bean"%>
<%@ taglib prefix="html" uri="http://struts.apache.org/tags-html" %>
<html:html>
<head>
<!-- 使用国际化资源文件的key输出标题 -->
<title><bean:message key="login"/></title>
</head>
<!-- 下面的标签用于输出出错信息 -->
<html:errors/>
<body>
<font color="red">
<%
//用于输出出错信息，出错信息保存在request的err属性中
if(request.getAttribute("err")!=null) {
out.println(request.getAttribute("err"));
}
%>
</font>
<br><br>
<!-- 下面是登陆表单 -->
请输入用户名和密码：<hr>
<html:form action="login.do" method="post" onsubmit="return validateLoginActionForm(this);">
<bean:message key="username" />:<html:text property="username" />
<br>
<bean:message key="password" />:<html:password property="password"/>
<br>
<html:submit>
<bean:message key="login"/>
</html:submit>
<br>
</html:form>
<html:javascript formName="loginActionForm"/>
</body>
</html:html>
注：实现客户端的javascript验证，只需在<form onSubmit=”return validateLonginActionForm(this);”>配置提交事件和使用<html:javascript formName=”loginActionForm”/> 声明：ITeye文章版权属于作者，受法律保护。没有作者书面许可不得转载。
推荐链接
|
| 返回顶楼 | |
|
发表时间：2009-02-09
validation.xml中，<arg1 name="minlength" key="#{var:minlength}"
#应该为$ |
| 返回顶楼 | |
|
发表时间：2009-02-09
另外，应该在struts-config.xml中，配置Action的validate="true"和input属性
|
| 返回顶楼 | |
|
发表时间：2009-06-19
请问这个怎么和spring融合呢？
我把Validator ActionForm改成ValidatorForm spring就不起作用了 |
| 返回顶楼 | |
|
发表时间：2009-06-26
在使用struts1 验证编辑页面的时候，如果验证出错，返回后就没有值了，是因为request中的对象已不存在，那么大家在实际项目中是怎样解决的，（不要说你用js，不用这种方式验证，这个不是这次讨论的问题），我是把bean放到session中，虽然能解决这个问题，但是，不够友好，听听大家的解决办法
|
| 返回顶楼 | |
