struts2中Action对请求参数有效性的校验

最新推荐文章于 2021-02-16 01:42:11 发布

flysun3344

最新推荐文章于 2021-02-16 01:42:11 发布

阅读量425

点赞数 1

分类专栏： struts2

struts2 专栏收录该内容

13 篇文章 0 订阅

订阅专栏

校验的分类：客户端数据校验和服务器端数据校验

客户端数据校验，通过JavaScript 完成校验（改善用户体验，使用户减少出错）
服务器数据校验，使用框架内置校验功能（struts2 内置校验功能） ----- 必须的

struts2支持的校验方式有两种，一是代码校验，在服务器端通过编写java代码，完成数据校验。二是配置校验，XML配置校验（主流）和注解配置校验。下面分别介绍这两个校验方式。

一：手工校验（代码校验）

步骤一：封装数据
步骤二：实现校验Action ，必须继承ActionSupport 类
步骤三：覆盖validate方法，完成对Action的业务方法数据校验
通过代码逻辑判断参数是否有效，如果参数非法， this.addFieldError (ActionSupport提供)
workflow拦截器跳转回 input页面
步骤四：在jsp中通过 <s:fieldError/> 显示错误信息
* validate方法会对Action中所有业务方法进行校验，如果只想校验某一个方法： validate方法名()

<%@ page language="java" contentType="text/html; charset=UTF-8"
    pageEncoding="UTF-8"%>
<%@taglib uri="/struts-tags" prefix="s"%>    
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>Insert title here</title>
</head>
<body>
<s:fielderror />
<form action="${pageContext.request.contextPath }/login.action" method="post">
	用户 <input type="text" name="username" /> <br/>
	密码 <input type="password" name="password" /><br/>
	<input type="submit" value="登陆 " />
</form>
</body>
</html>

Action:

public class LoginAction extends ActionSupport {
	private String username;
	private String password;

	public void setUsername(String username) {
		this.username = username;
	}

	public void setPassword(String password) {
		this.password = password;
	}

	public String login() throws Exception {
		System.out.println("进行登陆...");
		return NONE;
	}

	@Override
	// 数据校验
	public void validate() { // 校验所有方法
		if (username == null || username.trim().length() == 0) {
			// 用户名为空
			this.addFieldError("username", "用户名不能为空");
		}
		if (password == null || password.trim().length() == 0) {
			// 密码为空
			this.addFieldError("password", "密码不能为空");
		} else {
			if (password.trim().length() < 3 || password.trim().length() > 12) {
				this.addFieldError("password", "密码长度必须为3到12位");
			}
		}
	}

	// 判断用户名不能少于5位
	public void validateLogin() { // 校验指定方法
		if (username.trim().length() < 5) {
			this.addFieldError("username", "用户名不能少于5位");
		}
	}

}

配置文件：

<action name="login" class="fly.sun.demo.LoginAction" method="login">
	<result name="input">/demo/login.jsp</result>
</action>

二：XML配置方式数据校验（企业主流校验）

代码校验不适用于大型项目，流程数据复杂时，开发量和维护量都会很大。xml配置校验原理：将很多校验规则代码已经写好，只需要在xml中定义数据所使用校验规则就可以了
步骤一：编写jsp
步骤二：编写Action 继承ActionSupport 或者实现 Validateable 接口
步骤三：封装请求参数
* 使用xml校验必须提供get方法
步骤四：编写校验规则xml文件
在Action所在包编写 Action类名-validation.xml 对Action所有业务方法进行校验
引入DTD
------ xwork-core-2.3.7.jar 中 xwork-validator-1.0.3.dtd
<!DOCTYPE validators PUBLIC
"-//Apache Struts//XWork Validator 1.0.3//EN"
"http://struts.apache.org/dtds/xwork-validator-1.0.3.dtd">
内置校验器定义文件
xwork-core-2.3.7.jar 中 /com/opensymphony/xwork2/validator/validators/default.xml
内建校验器
* required (必填校验器,要求被校验的属性值不能为null)
* requiredstring (必填字符串校验器,要求被校验的属性值不能为null，并且长度大于0,默认情况下会对字符串去前后空格)
* stringlength (字符串长度校验器，要求被校验的属性值必须在指定的范围内，否则校验失败,minLength参数指定最小长度，maxLength参数指定最大长度，trim参数指定校验field之前是否去除字符串前后的空格)
* regex (正则表达式校验器，检查被校验的属性值是否匹配一个正则表达式，expression参数指定正则表达式，caseSensitive参数指定进行正则表达式匹配时，是否区分大小写,默认值为true)
* int(整数校验器，要求field的整数值必须在指定范围内，min指定最小值，max指定最大值)
* double(双精度浮点数校验器,要求field的双精度浮点数必须在指定范围内,min指定最小值,max指定最大值)
* fieldexpression (字段OGNL表达式校验器,要求field满足一个ognl表达式，expression参数指定ognl表达式,该逻辑表达式基于ValueStack进行求值,返回true时校验通过，否则不通过)
* email(邮件地址校验器，要求如果被校验的属性值非空，则必须是合法的邮件地址)
* url(网址校验器,要求如果被校验的属性值非空,则必须是合法的url地址)
* date(日期校验器,要求field的日期值必须在指定范围内,min指定最小值,max指定最大值)
eg:

<%@ page language="java" contentType="text/html; charset=UTF-8"
    pageEncoding="UTF-8"%>
<%@taglib uri="/struts-tags" prefix="s"%>    
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>Insert title here</title>
</head>
<body>
<s:fielderror />
<form action="${pageContext.request.contextPath }/login2.action" method="post">
	用户 <input type="text" name="username" /> <br/>
	密码 <input type="password" name="password" /><br/>
	<input type="submit" value="登陆 " />
</form>
</body>
</html>

Action:

public class LoginAction2 extends ActionSupport {
	private String username;
	private String password;

	// 实现Validateable接口类，才可以进行校验,ActionSupport中已经实现了
	@Override
	public String execute() throws Exception {
		System.out.println("登陆成功！");
		return NONE;
	}

	// 使用xml方式校验，必须针对数据 提供get方法

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

}

Action配置文件：

<action name="login2" class="fly.sun.demo.LoginAction2" >
	<result name="input">/demo/login.jsp</result>
</action>

fly.sun.demo的包下的参数校验的配置文件LoginAction2-validation.xml：

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE validators PUBLIC
  		"-//Apache Struts//XWork Validator 1.0.3//EN"
  		"http://struts.apache.org/dtds/xwork-validator-1.0.3.dtd">
<!-- 使用struts2 内置校验器 完成校验  -->
<validators> <!-- 校验规则 -->
	<field name="username"> <!-- 针对表单中哪个字段进行校验 -->
		<field-validator type="requiredstring">  <!-- 使用的校验规则 -->
			<!-- 调用 setTrim方法  -->
			<param name="trim">false</param>
			<message>用户名不能为空 ！</message>
		</field-validator>
		<!-- 一个字段可以 使用 多个校验规则 -->
		<field-validator type="stringlength">
			<param name="maxLength">12</param>
			<param name="minLength">3</param>
			<message>用户名必须3到12位之间</message>
		</field-validator>
	</field>
	<!-- 判断密码 非空 ，长度 -->
</validators>

下面为常用的校验器的使用例子：

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE validators PUBLIC
  		"-//Apache Struts//XWork Validator 1.0.3//EN"
  		"http://struts.apache.org/dtds/xwork-validator-1.0.3.dtd">
<validators>
	<field name="name">
		<field-validator type="requiredstring">
			<message>姓名不能为空！</message>
		</field-validator>
	</field>
	<field name="password">
		<field-validator type="requiredstring">
			<message>密码不能为空！</message>
		</field-validator>
		<field-validator type="stringlength">
			<param name="minLength">6</param>
			<message>密码长度不能小于6位</message>
		</field-validator>
	</field>
	<field name="repassword">
		<field-validator type="fieldexpression">
			<param name="expression">
				<![CDATA[(password==repassword)]]>
			</param>
			<message>两次密码输入不一致</message>
		</field-validator>
	</field>
	<field name="age">
		<field-validator type="int">
			<param name="min">18</param>
			<param name="max">70</param>
			<message>年龄必须在18到70之间</message>
		</field-validator>
	</field>
	<field name="birthday">
		<field-validator type="date">
			<param name="min">1980-10-10</param>
			<param name="max">2050-10-10</param>
			<message>生日必须在指定范围！</message>
		</field-validator>
	</field>
	<field name="phone">
		<field-validator type="regex">
			<param name="expression">
				<![CDATA[^18\d{9}$]]>
			</param>
			<message>手机号必须18开头！</message>
		</field-validator>
	</field>
	<field name="email">
		<field-validator type="email">
			<message>邮箱格式非法！</message>
		</field-validator>
	</field>
</validators>

上面的校验规则配置文件是对Action中所有业务方法的校验。如何对指定的方法校验呢？
格式 Action类名-ActionName(<action>元素name属性)-validation.xml

eg:校验LoginAction2中的excute方法，校验文件名字： LoginAction2Action-login2-validation.xml

三：自定义校验规则

步骤一：自定义校验器必须实现 Validator 接口
通常自定义校验器继承 ValidatorSupport 和 FieldValidatorSupport
* ValidatorSupport 针对不是一个输入字段 (两个密码一致)
* FieldValidatorSupport 针对是一个输入字段 (用户名非空)
步骤二：注册校验器
在工程的src下新建validators.xml文件
引入 xwork-core-2.3.7.jar 中 xwork-validator-config-1.0.dtd
步骤三：使用校验器
在Action所有包创建Action类名-validation.xml
*** 实际开发中很少用到自定义校验器