Struts2数据验证机制

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>

示例运行后，用户注册界面如下所示：

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

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

例4.2 应用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，如下所示：

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

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