struts1.2.9的校验框架 -

hongye612430

浏览: 60570 次
性别:
来自: 安康

最近访客更多访客>>

hanmo110

jieming

taoda

wc2019

博主相关

博客

微博

相册

留言

关于我

文章分类

社区版块

存档分类

struts1.2.9的校验框架

框架 Struts Bean Apache XML

数据校验也称为输入校验，指导对用户的输入进行基本的过滤，包括必填的字段，字段必须为数字及两次输入的密码必须匹配等。本文重点介绍了struts的校验框架。

ActionForm的代码校验
Action里的代码校验
结合commons-validator.jar的校验

1.1 ActionForm的代码校验

ActionForm的代码校验是最基本的校验方式。这种校验方式是重写ActionForm的validate方法，在该方法内对所有的字段进行基本的校验。如果出现不符合要求的输出，则将出错提示封装在ActionError对象里，最后将多个ActionError组合成ActionErrors对象，给对象里封装了全部的出错信息。

以登陆页面为例，下面是重写了Validate方法的ActionForm的代码：

Java代码

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>
<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>

# -- 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代码：

Java代码

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 {
//如果通过校验，则开始调用业务逻辑
}
}
}

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

需要书写大量的验证代码，是程序变得繁琐
数据验证应该在填充ActionForm里完成，最好能在客户端完成检验，而不是推迟到Action里才完成数据校验。

注意：在实际的使用中，这种校验方式不仅使程序开发变得复杂，且性能也不高。

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,代码如下：

Java代码

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

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）编写表单域时必须满足的校验规则。校验规则都由规则文件控制，规则文件有以下两个：

validator-rules.xml文件
validation.xml文件

第一个文件可在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

# -- standard errors --username=usernamepassword=passwordlogin=submitnoname=please enter namenopassword=please enter password# Struts Validator Error Messageserrors.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代码

<?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>
<formset>
<form name="loginActionForm">
<field property="username" depends="required">
<arg0 key="loginActionForm.login" />
</field>
<field property="password" depends="required,minlength">
<arg0 key="loginActionForm.password" />
<arg1 name="minlength" key="#{var:minlength}" resource="false" />
<var>
<var-name>minlength</var-name>
<var-value>5</var-value>
</var>
</field>
</form>
</formset>
</form-validation>

<?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>  <formset>  <form name="loginActionForm">  <field property="username" depends="required">  <arg0 key="loginActionForm.login" />  </field> <field property="password" depends="required,minlength">  <arg0 key="loginActionForm.password" /> <arg1 name="minlength" key="#{var:minlength}" resource="false" />  <var>  <var-name>minlength</var-name> <var-value>5</var-value> </var> </field> </form> </formset></form-validation>

4）在struts-config.xml中设置插件：

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>

<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页面

代码如下：

Java代码

<%@ 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>
<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>