Struts2数据验证机制

时间:2020-11-29 05:24:05

1. 手动验证的实现

只需要在继承ActionSupport类的情况下,直接重写validate()方法即可。使用validate()方法可以对用户请求的多个Action方法进行验证,但其验证的逻辑是相同的。如果在一个Action类中编写了多个请求处理方法,而此Action重写了validate()方法,那么,默认情况下,在执行每个请求方法的过程中,都会经过validate()方法的验证处理。

2. 验证文件的命名规则

使用Struts2验证框架,验证文件的名称需要遵循一定的命名规则,其验证文件的名称必须为ActionName-validation.xml或ActionName-AliasName-validation.xml的形式。其中ActionName是Action对象的名称,AliasName为Action配置中的名称,也就是struts.xml配置文件中Action元素对应name属性的名称。

  • 以ActionName-validation.xml方式命名

  在这种命名的方式中,数据的验证会作用于整个Action对象中,并验证Action对象的请求业务处理方法。如果Action对象中只存在单一的处理方法,或在多个请求处理的方法中,验证处理的规则都相同,可以应用此种命名方式。

  • 以ActionName-AliasName-validation.xml方式命名

  与上一种命名方式相比较,以ActionName-AliasName-validation.xml方式命名更加灵活。如果一个Action对象中包含多个请求处理方法,而又没有必要对每一个方法进行验证处理,值需要对Action对象中的特定方法进行处理,就可以使用此种命名方式。

3. 验证文件的编写风格

在Struts2框架中使用数据验证框架,其验证文件的编写有两种风格,也就是两种编写方法,分别为字段验证器编写风格与非字段验证器编写风格,它们各有优点。

4. Struts2高级技术典型应用

4.1 Struts2标签下的用户注册

例4.1 通过Struts2框架提供的表单标签编写用户注册表单,将用户的注册信息输出到JSP页面中。

(1)创建动态的Java Web项目,将Struts2的相关类包添加到项目的classpath,并在web.xml文件中注册Struts2提供的StrutsPrepareAndExecuteFilter过滤器,从而搭建Struts2的开发环境,具体代码如下:

<?xml version="1.0" encoding="GBK"?>
<web-app xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://java.sun.com/xml/ns/javaee" xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-app_3_0.xsd" id="WebApp_ID" version="3.0">
<display-name>java_struts2</display-name>
<welcome-file-list>
<welcome-file>index.html</welcome-file>
<welcome-file>index.htm</welcome-file>
<welcome-file>index.jsp</welcome-file>
<welcome-file>default.html</welcome-file>
<welcome-file>default.htm</welcome-file>
<welcome-file>default.jsp</welcome-file>
</welcome-file-list>
<!-- Struts2过滤器 -->
<filter>
<!-- 过滤器名称 -->
<filter-name>struts2</filter-name>
<!-- 过滤器类 -->
<filter-class>org.apache.struts2.dispatcher.ng.filter.StrutsPrepareAndExecuteFilter</filter-class>
</filter>
<!-- Struts2过滤器映射 -->
<filter-mapping>
<!-- 过滤器名称 -->
<filter-name>struts2</filter-name>
<!-- 过滤器映射 -->
<url-pattern>/*</url-pattern>
</filter-mapping>
</web-app>

(2)创建程序中的主页index.jsp,在主页面中通过Struts2框架提供的表单标签编写用户注册的表单。关键代码如下:

<%@ 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>
<h2>用户注册</h2>
<s:form action="userAction" method="post">
<s:textfield name="name" label="用户名" required="true" requiredposition="left"></s:textfield>
<s:password name="password" label="密码" required="true" requiredposition="left"></s:password>
<s:radio name="sex" list="#{1:'男',0:'女'}" label="性别" required="true" requiredposition="left"></s:radio>
<s:select list="{'请选择省份','吉林','广东','山东','河南'}" name="province" label="省份"></s:select>
<s:checkboxlist list="{'足球','羽毛球','乒乓球','篮球'}" name="hobby" label="爱好"></s:checkboxlist>
<s:textarea name="description" cols="30" rows="5" label="描述"></s:textarea>
<s:submit value="注册"></s:submit>
<s:reset value="重置"></s:reset>
</s:form>
</body>
</html>

在应用表单时,如果使用Struts2标签生成表单元素,可以用标签中的label属性,来定义表单元素前面的标签文字;如果表单中的元素属于一个必填的元素,那么可以使用required属性进行标记,其标记的效果会在元素的边缘显示一个字符“*”,同时这个字符“*”的位置也可以控制,通过requiredposition设置即可。

(3)创建用户注册后的返回页面success.jsp,在该页面中,通过Struts2的数据标签将用户注册信息输出到页面中。关键代码如下:

<%@ 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>
<div>
<h2>用户注册信息</h2>
<ul>
<li>用户名:<s:property value="name"/></li>
<li>密&nbsp;&nbsp;码:<s:property value="passward"/></li>
<li>性&nbsp;&nbsp;别:<s:if test="sex==0">女</s:if><s:else>男</s:else></li>
<li>省&nbsp;&nbsp;份:<s:property value="province"/></li>
<li>爱&nbsp;&nbsp;好:<s:property value="hobby"/></li>
<li>描&nbsp;&nbsp;述:<s:property value="description"/></li>
</ul>
</div>
</body>
</html>

(4)创建名称为UserAction的类,该类继承于ActionSupport类,是一个Action对象,它的作用是对用户注册请求以及用户信息编辑请求进行处理。关键代码如下:

package com.cn.action;

import com.opensymphony.xwork2.ActionSupport;

public class UserAction1 extends ActionSupport {
private static final long serialVersionUID = 1L;
private String name; //用户名
private String password; //密码
private String description; //描述
private int sex=1; //性别
private String province; //省份
private String[] hobby; //爱好
public String execute() throws Exception { //用户注册
return SUCCESS;
}
public String getName() {
return name;
}
public void setName(String name) {
this.name = name;
}
public String getPassword() {
return password;
}
public void setPassword(String password) {
this.password = password;
}
public String getDescription() {
return description;
}
public void setDescription(String description) {
this.description = description;
}
public int getSex() {
return sex;
}
public void setSex(int sex) {
this.sex = sex;
}
public String getProvince() {
return province;
}
public void setProvince(String province) {
this.province = province;
}
public String[] getHobby() {
return hobby;
}
public void setHobby(String[] hobby) {
this.hobby = hobby;
} }

(5)创建Struts2框架的配置文件struts.xml,在该文件中配置UserAction对象。关键代码如下:

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE struts PUBLIC
"-//Apache Software Foundation//DTD Struts Configuration 2.3//EN"
"http://struts.apache.org/dtds/struts-2.3.dtd">
<struts>
<!-- 声明常量(开发模式) -->
<constant name="struts.devMode" value="true"></constant>
<!-- 声明常量(在Struts的配置文件修改后,自动加载) -->
<constant name="struts.configuration.xml.reload" value="true"></constant>
<!-- 声明包 -->
<package name="myPackage" extends="struts-default" namespace="/">
<!-- 定义action -->
<action name="userAction" class="com.cn.action.UserAction">
<!-- 注册成功的返回页面 -->
<result>success.jsp</result>
</action>
</package>
</struts>

示例运行后,用户注册界面如下所示:

Struts2数据验证机制

若注册后的页面出现中文乱码,把所有网页的编码方式设为"UTF-8"即可。

4.2  使用验证框架对数据校验

例4.2 应用Struts2验证框架对用户登录页面进行输入验证。

(1)创建动态的Java Web项目,将Struts2的相关类包添加到项目的classpath,并在web.xml文件中注册Struts2提供的StrutsPrepareAndExecuteFilter过滤器,从而搭建Struts2的开发环境,具体代码如下:

<?xml version="1.0" encoding="GBK"?>
<web-app xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://java.sun.com/xml/ns/javaee" xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-app_3_0.xsd" id="WebApp_ID" version="3.0">
<display-name>java_struts2</display-name>
<welcome-file-list>
<welcome-file>index.html</welcome-file>
<welcome-file>index.htm</welcome-file>
<welcome-file>index.jsp</welcome-file>
<welcome-file>default.html</welcome-file>
<welcome-file>default.htm</welcome-file>
<welcome-file>default.jsp</welcome-file>
</welcome-file-list>
<!-- Struts2过滤器 -->
<filter>
<!-- 过滤器名称 -->
<filter-name>struts2</filter-name>
<!-- 过滤器类 -->
<filter-class>org.apache.struts2.dispatcher.ng.filter.StrutsPrepareAndExecuteFilter</filter-class>
</filter>
<!-- Struts2过滤器映射 -->
<filter-mapping>
<!-- 过滤器名称 -->
<filter-name>struts2</filter-name>
<!-- 过滤器映射 -->
<url-pattern>/*</url-pattern>
</filter-mapping>
</web-app>

(2)创建用户登录的Action对象UserAction,并将UserAction配置到struts.xml配置文件中,具体代码如下:

UserAction.java

package com.cn.action;

import com.opensymphony.xwork2.ActionSupport;

public class UserAction2 extends ActionSupport {
private static final long serialVersionUID = 1L;
private String username; //用户名
private String password; //密码
//用户登录
@Override
public String execute() throws Exception {
return SUCCESS;
}
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;
} }

在struts.xml中的配置如下:

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE struts PUBLIC
"-//Apache Software Foundation//DTD Struts Configuration 2.3//EN"
"http://struts.apache.org/dtds/struts-2.3.dtd">
<struts>
<!-- 声明常量(开发模式) -->
<constant name="struts.devMode" value="true"></constant>
<!-- 声明常量(在Struts的配置文件修改后,自动加载) -->
<constant name="struts.configuration.xml.reload" value="true"></constant>
<!-- 声明包 -->
<package name="myPackage" extends="struts-default" namespace="/">
<!-- 定义action -->
<action name="userAction" class="com.cn.action.UserAction">
<!-- 用户登录页面 -->
<result name="input">login.jsp</result>
<!-- 登录成功的返回页面 -->
<result>success.jsp</result>
</action>
</package>
</struts>

在struts.xml中配置文件中,请求处理成功的映射结果是success.jsp页面,验证失败返回用户登录页面login.jsp。

注意:默认情况下,Struts2的验证框架验证失败后会返回input对应的页面,所以需要指定input值对应的页面。

(3)创建用户登录页面login.jsp,在该页面中通过Struts2的表单标签创建用户登录表单。关键代码如下:

<%@ 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:form action="userAction" method="post">
<s:textfield name="username" label="用户名" required="true"></s:textfield>
<s:password name="password" label="密码" required="true"></s:password>
<s:submit key="submit" value="登录"></s:submit>
</s:form>
</body>
</html>

(4)创建名称为success.jsp的JSP页面,该页面是用户成功登录的返回页面。关键代码如下:

<%@ 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>
<h2>
<s:property value="username"/>,登录成功!
</h2>
</body>
</html>

(5)编写用户登录的验证文件,该文件的名称为UserAction-validation.xml。关键代码如下:

<?xml version="1.0" encoding="GBK"?>
<!DOCTYPE validators PUBLIC "-//Apache Struts//XWork Validator 1.0.2//EN"
"http://struts.apache.org/dtds/xwork-validator-1.0.2.dtd"> <validators>
<field name="username">
<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="maxLength">10</param>
<param name="minLength">5</param>
<message>密码长度应该在${minLength}--${maxLength}位之间</message>
</field-validator>
</field>
</validators>

注意:验证文件UserAction-validation.xml必须放置在UserAction所在的包中。

运行程序后,进入到用户登录页面login.jsp,如下所示:

Struts2数据验证机制

如果没有输入用户名、密码的情况下,单击”登录“按钮,页面会停留在login.jsp页面中,如下所示:

Struts2数据验证机制

如果密码输入的长度不对,页面显示如下内容:

Struts2数据验证机制