Struts2入门(四)——数据输入验证

一、前言

1.1、什么是输入验证？为什么需要输入验证？

在上一篇文章中，我们学习了数据类型转换，我们提到了表示层数据处理的两个方法，也提到了用户输入数据需要进行类型转换才能得到我们想要的数据，那么，我们怎么确定类型转换后的数据，是我们想要的数据呢？这里有点绕。你可以这样想：一个成年男子年龄是18岁，你现在想要得到18这个数据，但是，用户输入32，经过类型转换也是对的，但是数据不是你想要的。这时候，我们要怎么办？所以输入验证在这里就有用处了。

类型转换和输入验证的关系是：类型转换是输入验证的前提，如果类型转换都出错了，那就不用再进行输入验证了。但是很多时候类型转换和输入验证是同时完成的。

输入验证有两种：

1、客户端验证;

2、服务端验证。这里主要讲解的是服务端验证（重写ValidateXxx方法和xml配置文件验证）

1.2、重写ValidateXxx方法的验证流程

1、类型转换器负责对字符串的请求参数进行类型转换，并将这些值设置成Action的属性值

2、在执行类型转换过程中可能出现异常，如果出现异常，异常信息会自动保存到ActionContext中，conversionError拦截器负责将其封装到fieldError中

3、通过反射调用ValidateXxx()方法，其中Xxx是即将处理用户请求的处理逻辑所对应的方法名

4、调用Action类的Validate方法

5、如果上面的步骤没有出现fieldError，将调用Action里处理用户请求的处理方法，如果出现fieldError，系统将转入input逻辑视图所指定的视图。

二、输入验证

2.1、输入验证这里讲解的有两种方式：

1、重写Validate方法或者自定义ValidateXxx方法(其中的Xxx是自己定义的名字，会先执行该方法，在执行Validate方法)

2、新建xml进行验证

2.2、重写Validate方法

在MVC框架，都会提供规范的数据验证部分，Struts2在这里提供的是一个Validate方法，我们重写Validate方法就可以进行输入验证，但是，重写Validate方法有两个点需要知道：1、Validate方法会在execute方法之前被执行；2、Validate方法对所有的Action都会执行校验规则，为了区别某一个Action，我们可以使用ValidateXxx方法。

注意：以下的例子是局部类型转换和输入验证一起使用的例子。

简单的注册验证例子：

新建实体类User：

package com.validatexxx;

public class User {

     private String username;

     private String password;

     private String repassword;

    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;

    }

    public String getRepassword() {

        return repassword;

    }

    public void setRepassword(String repassword) {

        this.repassword = repassword;

    }

}

User

新建视图：Register.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>注册用户</title>

</head>

<body>

    <h2>使用validateXXX()方法验证</h2>

    <form action="register_test">

        用户：<input type="text" name="user"><br/>

        密码：<input type="password" name="user"><br/>

        密码：<input type="password" name="user"><br/>

        <input type="submit" value="提交">

    </form>

</body>

</html>

新建RegisterAction类继承ActionSupport

package com.validatexxx;

import com.opensymphony.xwork2.ActionSupport;

//重写validate()和validateXXX指定方法进行验证

/*

 * 在struts.xml配置method方法为test(),会先调用ValidateTest()方法，

 * 然后在调用validate方法

 * 之后test方法被调用

 * */

public class RegisterAction extends ActionSupport {

    private User user;

    public User getUser() {

        return user;

    }

    public void setUser(User user) {

        this.user = user;

    }

    //

    @Override

    public void validate(){

     System.out.println("重写Validate方法");

     if (null == user.getPassword()  || "".equals(user.getPassword()) || null == user.getRepassword()  || "".equals(user.getRepassword())) {

             this.addFieldError("repassword", "repassword should be same password");

            return;

         }

     if (!user.getPassword().equals(user.getRepassword())) {

         //当FieldError中存在数据时，服务器会自动帮我们跳转到input的逻辑视图

         this.addFieldError("repassword", "repassword should be same password");

         }

    }

    //

    public void validateTest(){

        System.out.println("自定义校验方法：ValidateTest");

    }

    //

    public String test(){

        System.out.println("test：方法");

        return SUCCESS;

    }

}

注意：这里的属性是User，所以你jsp页面参数的名字要写实例的名字user，然后你还需要去创建一个类型转换器，返回一个填充好数据的类

新建struts.xml，存放在WEB-INF/classes/struts.xml

注意：这里的method必须是你ValudateXxx()方法后面你自己定义的，笔者这里是test。使用*的话，struts2还必须配置 strict-method-invocation="false",据说是因为版本太高了，它的安全性增加了，所有必须加才能够使用*

新建Usertypeconverter类继承StrutsTypeConverter(创建一个类型转换器)

package com.validatexxx;

import java.util.Map;

import org.apache.struts2.util.StrutsTypeConverter;

//类型转换的类

public class Usertypeconverter extends StrutsTypeConverter {

    @Override

    public Object convertFromString(Map arg0, String[] arg1, Class arg2) {

        System.out.println("Usertypeconverter：类型转换！");

        User user = new User();

        user.setUsername(arg1[0]);

        user.setPassword(arg1[1]);

        user.setRepassword(arg1[2]);

        return user;

    }

    @Override

    public String convertToString(Map arg0, Object arg1) {

        User u = (User)arg1;

        return u.getUsername()+"!";

    }

}

注意：该类型转换器创建好之后还需新建一个RegisterAction-conversion.properties，放在同级目录下

该文件的内容有：

前面是你在RegisterAction的属性名，后面是类型转换器的具体路径。

新建成功视图：success.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>Success</title>

</head>

<body>

      <h2>服务端使用validate方法验证</h2>

      成功

</body>

</html>

success.jsp

新建错误视图：input.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>

    Error：<s:fielderror/>

</body>

</html>

input.jsp

代码执行成功的效果如下：

成功跳转的页面为：success.jsp

控制台测试结果为：

数据跳转到Usertypeconverter进行类型转换，之后跳转到RegisterAction，执行ValidateTest方法()，Validate，test之后返回SUCCESS，然后执行result的视图。

我们看代码执行失败的顺序：

input.jsp页面

控制台测试效果：

在Validate方法里面，笔者代码为：this.addFieldError()，在前面有说过，如果添加错误的话，那么服务器会自动帮我们跳转到错误的界面。它会返回input，而input在struts.xml中就有配置，会返回到input.jsp界面。

2.3、新建xml进行输入验证

新建视图界面：Test.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>使用XML校验</title>

</head>

<body>

    <s:form action="empinfo" method="post">

      <s:textfield name="name" label="Name" size="20" />

      <s:textfield name="age" label="Age" size="20" />

      <s:submit name="submit" label="Submit" align="center" />

   </s:form>

</body>

</html>

新建Employee类继承ActionSupport

该类有使用重写Validate方法和Xml配置，我们可以选择其中一种进行验证就可以

package com.validatexxx;

import com.opensymphony.xwork2.ActionSupport;

//使用validate()方法验证，这是服务端验证！

public class Employee extends ActionSupport {

    private String name;

    private int age;

    public String getName() {

        return name;

    }

    public void setName(String name) {

        this.name = name;

    }

    public int getAge() {

        return age;

    }

    public void setAge(int age) {

        this.age = age;

    }

    //第二步再执行该方法

    public String execute(){

        System.out.println("execute："+this.age);

        return SUCCESS;

    }

/*    使用服务端的校验：重写validate方法();

    //第一步先执行该方法

    //重写validate方法有缺陷：每次都会使用validate方法验证，造成极大的资源浪费。

    public void validate(){

        System.out.println("validate");

          if (name == null || name.trim().equals(""))

          {

             //当往该方法添加数据的时候，服务器会返回input，之后跳转到input.jsp页面中。

             addFieldError("name","The name is required");

          }

          if (age < 28 || age > 65)

          {

              addFieldError("age","Age must be in between 28 and 65");

           }

    }

*/

}

在Struts.xml中进行配置：

这里的success.jsp和input.jsp还是使用上面的。

之后我们需要新建Employee-validation.xml，路径放在与Employee同级目录下，注意：-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">

 <validators>

   <field name="name">

      <field-validator type="required">

         <message>

            The name is required.

         </message>

      </field-validator>

   </field>

   <field name="age">

     <field-validator type="int">

         <param name="min">29</param>

         <param name="max">64</param>

         <message>

            Age must be in between 28 and 65

         </message>

      </field-validator>

   </field>

</validators>

重点：该文件的dtd限制必须有，不然回报错误：

ERROR DefaultDispatcherErrorHandler Exception occurred during processing request: [Connection timed out: connect - [unknown location], null]

接下来我们使用http://localhost:8080/LearStruts2/ValidateJSP/Test.jsp进行访问。

测试成功：

Test.jsp界面：

success.jsp

测试失败例子：

input.jsp界面：

说明例子是正确的。

其实在Struts2中有多个内置验证器：必填验证器，必填字符串验证器，整数验证器，日期验证器，表达式验证器，字符长度验证器，正则表达式验证器...等等，这个有需要的话，笔者在一一述说。

以上就是输入验证的两种方式。不足之处请下方留言，我会改正，谢谢！