struts的验证框架详细介绍

于 2009-01-06 11:57:06 发布
阅读量112 收藏 1
点赞数
分类专栏： struts 文章标签： 框架 Struts Apache XML Bean
[b][size=medium]引言[/size][/b]
数据校验也称为输入校验，指导对用户的输入进行基本的过滤，包括必填的字段，字段必须为数字及两次输入的密码必须匹配等。本文重点介绍了struts的校验框架。


[b][size=medium]1、struts的数据校验大致有如下几种方式：[/size][/b]
[list=1]
[*]ActionForm的代码校验
[*]Action里的代码校验
[*]结合commons-validator.jar的校验
[/list]


[b][size=medium]1.1 ActionForm的代码校验[/size][/b]
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>


[color=red]注：上述资源文件还不能直接在项目中应用，在使用前需要转换成unicode格式。[/color]
命令：native2ascii MessageResources_zh_CN.properties MessageResources.properties


[color=red]以上是使用ActionForm进行数据验证的方法，但是使用ActionForm的数据验证有个显著的问题：ActionErrors和ActionError都是struts不在推荐使用的类，因此，应尽量避免使用这种验证方法。[/color]

[b][size=medium]1.2 Action的代码验证[/size][/b]
在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 {
                   //如果通过校验，则开始调用业务逻辑
		}
	}

}


这种校验方式非常容易理解，所有的代码都需要程序员自己控制，相当灵活。但有几个不方便的地方：

[list]
[*]需要书写大量的验证代码，是程序变得繁琐
[*] 数据验证应该在填充ActionForm里完成，最好能在客户端完成检验，而不是推迟到Action里才完成数据校验。
[/list]
[color=red]
注意：在实际的使用中，这种校验方式不仅使程序开发变得复杂，且性能也不高。[/color]


[b][size=medium]1.3 Validator验证框架[/size][/b]
利用Struts的提供的Validator验证框架可实现客户端和服务器端双验证。Struts的Validator验证框架定义了常用的十几个验证规则，如：required(验证非空)、minlength(验证最小长度)、maxlength(验证最大长度)、intRange(验证整形范围)、email(验证电子邮件地址)、date(验证日期)等，并且实现了客户端的Javascript验证和服务器端验证，以下是在myeclipse环境下使用Validator验证框架的步骤：
[b][size=small]1. 配置[/size][/b]
目前使用的版本是Struts1.2.9(下载地址：[url]http://struts.apache.org/download.cgi[/url])，里面有validator-rules.xml和validator.xml两个文件，在使用Validator之前，需要先配置一些东西。
[b]1）必要的包：[/b]
将Struts发行包中的commons-validator.jar和jakarta-oro.jar这两个文件放到Web应用的WEB-INF/lib目录中。
[b]2）自己定义的FormBean需要继承ValidatorForm,代码如下[/b]： 
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;
	}
}


[color=red]注：Validator框架不能用于验证标准的org.apache.struts.action.ActionForm类。如果要使用Validator框架应该采用ActionForm类的两个子类：DynavalidatorForm和ValidatorForm。 [/color]

[b]3）编写表单域时必须满足的校验规则。校验规则都由规则文件控制，规则文件有以下两个：[/b]
[list=1]
[*]validator-rules.xml文件
[*]validation.xml文件
[/list]

第一个文件可在struts的解压缩后的文件夹lib下找到，只需将该文件复制到WEB-INF路径下，该文件是通用文件，一般不需要修改。除非打算修改或扩展这组规则，否则无需修改这个文件！
[color=red]注意1：需要在资源包(ApplicationResources.properties)中加上一下的“键-值”：[/color] 
# -- 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”的值。

[color=red]注意2：在Struts 1.2.9中，验证类使用的是：“org.apache.struts.validator.FieldChecks”，
以前使用的是“org.apache.struts.util.StrutsValidtor”，
只要是从struts 1.2.x发行包中拷贝的“validation-rules.xml”文件，就可以保证是正确的。[/color] 而第二个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>


[b]4）在struts-config.xml中设置插件：[/b] 
<plug-in className="org.apache.struts.validator.ValidatorPlugIn">
		<set-property property="pathnames"
			value="/WEB-INF/validator-rules.xml,/WEB-INF/validation.xml" />
	</plug-in>

[color=red]
注：value值用来指定验证规则的文件的路径，多个验证规则文件要用逗号分割[/color]
同时还要在该文件中的Action元素里面增加两个属性：input属性和validate属性，input属性指定不满足规则时返回的页面，应该将validate的属性值设置为true。

[b]5）修改JSP页面[/b]
代码如下： 
<%@ 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>



[color=red]注：实现客户端的javascript验证，只需在<form onSubmit=”return validateLonginActionForm(this);”>配置提交事件和使用<html:javascript formName=”loginActionForm”/>[/color]
walsh_bupt
关注
  • 0
    点赞
  • 踩
  • 1
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
专栏目录
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值