为了和前台基于JavaScript的开源验证框架RapidValidation使用统一的验证规则, 最大限度的减少重复的后台验证代码, 使用方式简便, 扩展方便.

https://blog.csdn.net/autojoke/article/details/5192534

本框架依赖于:

Struts 2

Java 5或者更高版本

GET/POST协议(支持带文件上传的表单, 依赖于Commons-Upload组件)

整合步骤
1. 将文件struts2-quickvalidation-plugin-1.0.jar 放入WEB-INF/lib目录下;

2. 修改您自己的代码的src/struts.xml中的package定义继承自quickValidation;

示例代码:

3. 使用注解加入验证规则表达式;

在每个需要调用的Action的入口方法处, 加入@FormValidator 注解.

注解的完整语法如下:

@common.validation.FormValidator(input="出错时需要返回的result别名", enabled=true/false , value="表单参数名称1,表单参数中文提示信息1,规则1 规则2…; 表单参数名称2,表单参数中文提示信息2,规则1 规则2…;更多字段验证信息")

input 参数: 可选 . 如果不指定, 则出错时仍然继续进入到Action方法中; 如果指定, 则在表单验证出错时, 返回到给定的result中, 例如: 原始表单输入页面或者统一的错误输出页面;

enabled 参数: 可选 . 是否启用此验证规则, 如果不指定, 则忽略解析注解, 不进行任何验证;

value 参数: 必填选项 , 可输入一个或者多个表单参数验证规则. 简单说就是: [字段1验证配置];[字段2验证配置];…. 虽然不建议, 然而字段验证配置可以留空, 此时不会进行任何验证处理.

而每个验证配置 的格式如下:

表单参数名称: 必填选项 . 指向输入的表单控件的名称(input的name);

表单参数中文提示信息: 可选 . 如果为空, 则和表单参数名称相同. 不为空时, 则显示在出错时的信息提示的开头位置;

规则1 规则2…: 可选. 理论上可加入任意多个验证规则, 以单个空格 隔开. 在验证开始后, 依次进行每个规则的验证并加入提示信息. 需要注意的是, 除required规则之外的所有规则只有当用户输入的字段值非空时, 才进行有效性验证, 如此便可避免所有字段都成为必填字段的问题发生.

每个规则 本身则由两部分组成: 规则名-规则子名-参数1-参数2-参数3-….

规则名和规则子名是固定名称, 不能任意填写, 这两个名称对应一个具体的规则实现类.

其中参数 是必填选项 , 参数的意义则需要参考下一节的验证规则表达式 中的说明. 下面举例说明若干验证规则:

required 这是特殊规则, 不带规则子名;

float-range-1-20 其中float-range分别是规则名和规则子名, 而1和20则分别是两个参数.

特别需要注意的是有负数时的情况此时参数列表变为: float-range--1 --20, 此时参数值分别为-1和-20.

如果需要给另一字段加入验证规则, 则以分号 隔开.

下面是若干验证的示例及其解释:

规则

解释

@FormValidator

空的验证规则, 不进行任何操作

@FormValidator("username,用户名,required min-length-5")

对username字段进行验证, 规则为 必填, 最小长度为5; 出错时分别提示:

用户名不能为空

用户名的长度不能小于5, 当前长度为1.

由于没有指定input参数, 所以当验证失败时, 仍然会继续进入到业务逻辑处理, 相关的错误信息则存入request的attribute中.

@FormValidator("username, ,required min-length-5")

由于没有指定字段的中文提示, 因此出错时将提示:

username的长度不能小于5, 当前长度为1.

@FormValidator(input="index" ,value=" username,用户名,required min-length-5”)

这大概是最常用格式的验证规则的写法了. 此例和上例的区别为: 所以当验证失败时, 将进入input参数所指定的出错信息显示页面.

@FormValidator(input="index",enabled=false, value=" username,用户名,required min-length-5”)

忽略所有验证规则处理, 常用于调试阶段.

@FormValidator(input="index",value=" username,用户名,required min-length-5;password2,重复密码 ,required equals-password-原始密码 ;”)

此规则加入了对重复密码字段的验证, 出错时将提示:

重复密码 和原始密码 的输入不一致

@FormValidator(input="index",value="username,用户名,required min-length-5;password2,重复密码 ,required equals-password;”)

此规则省略了另一字段的中文描述, 出错时将提示:

重复密码 和前面 的输入不一致

以下为一个完整的Action类示例代码:

4. 修改前台显示验证结果.

根据Action的不同, 前台的显示划分为两类:

普通的错误显示:

所有错误信息: ${validationErrors}

返回的内容是一个字符串, 显示了所有的出错信息, 而出错字体的颜色则需要用户自己去设置.

出错信息的显示格式是以<br>分开的, 例如:

用户名不能为空<br>密码不能为空<br>重复密码不能为空<br>性别必须至少选中一项<br>

另一种推荐的做法是让Action继承自Struts2中的ActionSupport, 此时则可用Struts 2的标签来显示出错信息, 可定位到具体的字段:

或者使用纯JSP来编写页面来定位到单条错误:

用户名: <input name=username value=${param.username}> ${errors.username[0]}

下面给出这两种写法的完整示例:

<%@ page pageEncoding="UTF-8"%>
<%@ taglib prefix="s" uri="/struts-tags" %>
<html>
<head>
<mce:style><!--
.errorMessage {color:red;}
.errorLabel {font-weight:bold}
--></mce:style><style mce_bogus="1">.errorMessage {color:red;}
.errorLabel {font-weight:bold}</style>
<title>测试页面</title>
</head>
<body>
<s:actionerror />
<form action="helloworld.action" method=post enctype="multipart/form-data">
用户名: <input name=username value=${param.username}> ${errors.username[0]} <br>
年龄: <input name=age value=${param.age}><br>
密码: <input name=password><br>
密码重复: <input name=password2><br>
邮件: <input name=email><br>
性别: <input type=checkbox name=a>男 <input type=checkbox name=a>女<br>
IP地址: <input name=ip><br>
数字1: <input name=num1> 数字2: <input name=num2> <br>
日期:<input name=date><br>
附件: <input name=file type=file><br>
<input type=submit value="提交">
</form>
<span class="errorMessage">
${validationErrors}
</span>
Struts 2表单标签示例:
<s:fielderror/>
<s:form action="helloworld.action" method="post">
<s:textfield name="username" label="用户名" />
<s:password name="password" label="密码" />
<s:submit/>
</s:form>
</body>
</html>

验证规则表达式详解
说明: 加红色背景的部分是目前尚不支持的验证规则; 加黄色背景的是增加了第二个可选参数的规则.

验证表达式

描述

示例

required

非空域,全部空格也算空

validate-number

一个有效数

validate-digits

只能包含0-9任意个数字

validate-alpha

只能是字母a-z, A-Z

validate-alphanum

只能是字母和数字的组合

validate-email

只能是有效的email

validate-url

只能是有效的url地址

validate-one-required

至少有一个被选中,例如一组checkbox, radiobutton,它们最好包含在一个div和span中

validate-integer

只能是整数,可以有正负号

validate-ip

有效的IP地址

min-length-$number

最小长度是$number ( 此处$some表示一个特定的值)

最小长度为8: min-length-8

max-length-$number

最大长度是$number

最大长度为8: max-length-8

max-value-$number

输入域的最大值是$number

最大值为8.1: max-value-8.1

min-value-$number

输入域的最小值是$number

最大值为-8.1: max-value--8.1

equals-$otherInputId-$otherInputLabel

必须和某个input field相等,用于密码两次输入验证等,$otherInputLabel是可选项,用来描述另一字段信息

equals-password

重复密码和原始密码输入不一致:

equals-password-原始密码

less-than-$otherInputId-$otherInputLabel

小于某个input field less-than-otherInputId,多用于结束日期不能小于开始日期的需求,$otherInputLabel是可选项,用来描述另一字段信息

注:相等时也不能通过

great-than-$otherInputId-$otherInputLabel

大于某个input field less-than-otherInputId,$otherInputLabel是可选项,用来描述另一字段信息

validate-date-$dateFormat

只能是日期,$dateFormat为日期格式,$dateFormat的可选,默认格式为yyyy-MM-DD

validate-date-yyyy年MM月dd日

validate-file-$type1-$type2-$typeX

验证文件输入域选择的文件类型只能为声明的$type1 – $typeX中的一种

validate-file-png-jpeg

float-range-$minValue-$maxValue

必须是$minValue到$maxValue的一个浮点数

1至20: float-range-1-20

int-range-$minValue-$maxValue

必须是$minValue到$maxValue的一个整数

length-range-$minLength-$maxLength

输入字符串的长度必须在$minLength到$maxLength之间

validate-pattern-$RegExp

通过自定义正则表达式$RegExp来验证输入域的正确性

vaidate-pattern-/a/gi

validate-chinese

只能是中文(以下为中国的相关验证)

validate-phone

有效的电话

validate-mobile-phone

有效的手机号

validate-id-number

验证是否有效的身份证号码

validate-zip

验证邮政编码

validate-qq

验证QQ号码

和RapidValidation 配合实现前后台一致验证
RapidValidation是专注于前台的验证框架, 例如下面的例子:

<!-- 为form增加required-validate class,标识需要验证form -->
<form id='helloworld' action="#" class='required-validate'>
helloworld:</br>
<!--通过class添加验证: required表示不能为空,min-length-15表示最小长度为15 -->
<textarea name='content' class='required min-length-15'>

其对应的后台验证规则为:

@FormValidator(input="index" ,value=" content ,helloworld ,required min-length-15 ”)

请注意比较异同, 不同部分已经以红色粗体 进行了区分, 相同部分则以绿色粗体 标识.

大家可以看到, 两者很容易就实现了一致的前后台验证规则.

如何扩展验证规则?
要扩展验证只需要实现IValidator即可即可, 并将实现类放入包 common.quickvalid.validators 下. 下面是IValidator 接口定义:

package common.quickvalid.validators;
import java.util.Map;
/**
* 验证器接口.
* @author beansoft
* 日期: 2009-12-20
*/
public interface IValidator {
/**
* 实现验证方法.
* @param fieldName 字段name
* @param fieldDescription 出错时的字段描述信息
* @param params 参数列表 <String key, String[] values> 表单参数Map
* @param args 参数列表
* @return 验证信息, 为空时表示没有任何出错信息, 通过验证
*/
public String doValidation(String fieldName, String fieldDescription, Map<String, String[]> params, String... args) ;
public String[] getArgs();
/**
* 设置参数列表
* @param args
*/
public void setArgs(String[] args);
public String getExpression();
/**
* 设置原始表达式, 用于日期, 正则等验证方式, 避免和 - 号冲突.
* @param Expression
*/
public void setExpression(String expression);
}

类名有一定规则, 将第一个减号替换为下划线即可, 例如:

length-range-$minLength-$maxLength 对应的类名是: length_range .

下面则给出一个实现类, 供参考:

package common.quickvalid.validators;
import java.util.Map;
/**
* 单个表单域验证
*
* 非空域时才进行字符串验证.
* 最大长度验证
* @author beansoft
*
*/
public class max_length implements IValidator {
public String doValidation(String fieldName, String fieldDescription,
Map<String, String[]> params, String... args) {
super.setParams(params);
String value = params.getValue(fieldName)[0];
int length = 0;
try {
length = Integer.parseInt(args[0]);
} catch(Exception ex) {}
if(value != null && value.length() > 0 && value.trim().length() > 0) {
if(value.trim().length() > length) {
return fieldDescription + "的长度不能大于" + length + ", 当前长度为" + value.trim().length();
}
}
return null;
}
/**
忽略getter和setter,和普通Java类无区别.
getXx();
setXxx();
*/
}

Struts2快速后台验证 使用的更多相关文章

  1. (5)表单Action后台验证

    /day31/src/cn/itcast/web/struts2/user/UserAction.java package cn.itcast.web.struts2.user; import com ...

  2. (转)Struts2快速入门

    http://blog.csdn.net/yerenyuan_pku/article/details/66187307 Struts2框架的概述 Struts2是一种基于MVC模式的轻量级Web框架, ...

  3. 【转】Struts2 表单验证与验证框架

    版权声明:好笔头不如烂记性 https://blog.csdn.net/zsbgood/article/details/81114038 表单数据验证是很常见的功能,通常前端页面会有一次 js验证,但 ...

  4. SpringMVC学习系列-后记 结合SpringMVC和Hibernate-validator,根据后台验证规则自动生成前台的js验证代码

    在SpringMVC学习系列(6) 之 数据验证中我们已经学习了如何结合Hibernate-validator进行后台的数据合法性验证,但是通常来说后台验证只是第二道保险,为了更好的用户体验会现在前端 ...

  5. ASP.NET开发中主要的字符验证方法-JS验证、正则表达式、验证控件、后台验证

    ASP.NET开发中主要的字符验证方法-JS验证.正则表达式.验证控件.后台验证 2012年03月19日 星期一 下午 8:53 在ASP.NET开发中主要的验证方法收藏 <1>使用JS验 ...

  6. Struts2的输入验证

    一.概述: ① Struts2的输入验证 –基于 XWorkValidation Framework的声明式验证:Struts2提供了一些基于 XWork Validation Framework的内 ...

  7. c#后台验证

    #region 后台验证 panda /// 验证电话号码的主要代码如下: public bool IsTelephone(string str_telephone) { return System. ...

  8. (转)jquery.validate.js 的 remote 后台验证

    之前已经有一篇关于jquery.validate.js验证的文章,还不太理解的可以先看看:jQuery Validate 表单验证(这篇文章只是介绍了一下如何实现前台验证,并没有涉及后台验证remot ...

  9. 表单数据验证方法(二)——ASP.NET后台验证

    昨天写了一下关于如何在前台快捷实现表单数据验证的方法,今天接着昨天的,把后台实现数据验证的方法记录一下.先说明一下哈,我用的是asp.net,所以后台验证方法也是基于.net mvc来做的. 好了,闲 ...

随机推荐

  1. spring c3po 连接mysql,sqlserver

    1  连接mysql (1) http://wenku.it168.com/d_000096351.shtml 2  连接sqlserver (1)http://blog.csdn.net/vinep ...

  2. thinkCMF----导航高亮显示

    导航高亮显示,有多种方法,这里给出一个简单的表示下: <a href="__ROOT__"> <span class="text db"> ...

  3. python3+socket搭建简易服务器

    踩了一上午的坑之后,终于对网络编程有了一点大致的.基本的了解.真的是0基础,之前对socket网络编程一点都不知道.(感觉自己与时代脱轨....) 首先我想对这些美妙的专业术语进行一番搜索: 服务器: ...

  4. Spring Framework核心概念之Bean生命周期管理

    目录 Spring Bean的生命周期 相关接口的分类 测试SpringBean生命周期的Demo程序 小结 Spring Bean的生命周期 Spring容器既Application或者WebApp ...

  5. BC32206 错误

    出现这种情况的话 排除代码引入dll版本的原因 看下是不是 你之前用net reflector 生成了pdb文件 导致项目引入的版本都是他生成的文件 处理方案就是 用everything 找到这个dl ...

  6. Zabbix显示乱码解决办法

    Zabbix在web页面会显示乱码,如下图所示 在windows下面文件夹C:\Windows\Fonts找一个简体字文件例如simkai.ttf 复制到zabbix server的文件夹/usr/s ...

  7. HTML的常用总结

    <!DOCTYPE html> <html lang="en"> <head> <meta charset="UTF-8&quo ...

  8. ArcEngine创建要素类_线类型

    public ESRI.ArcGIS.Geodatabase.IFeatureClass CreateFeatureClassForLine(ESRI.ArcGIS.Geodatabase.IWork ...

  9. Mybatis插入数据后返回主键id

    有时候使用mybatis插入数据后,需要用到记录在数据库中的自增id,可以利用keyProperty来返回,赋值给实体类中的指定字段. 单条记录插入并返回 First, if your databas ...

  10. 多线程-interrupt(),isInterrupted(),interrupted()

    背景 由于使用stop方法停止线程非常暴力,可能会导致一系列问题.因此,提出一种温和的方式:请求另外一个先不要在执行了,这就是中断方式. 此外有这样的场景:编写 一个程序,需要暂停一段时间,于是调用T ...