码迷,mamicode.com
首页 > 其他好文 > 详细

Struts2快速后台验证 使用

时间:2018-12-24 19:49:11      阅读:139      评论:0      收藏:0      [点我收藏+]

标签:exp   port   显示出错   div   标识   erro   输出   问题   用户   

为了和前台基于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快速后台验证 使用

标签:exp   port   显示出错   div   标识   erro   输出   问题   用户   

原文地址:https://www.cnblogs.com/klb561/p/10170341.html

(0)
(0)
   
举报
评论 一句话评论(0
登录后才能评论!
© 2014 mamicode.com 版权所有  联系我们:gaon5@hotmail.com
迷上了代码!