Struts2数据输入验证教程详解

程序员文章站 2024-03-31 20:34:58

一、前言 1.1、什么是输入验证？为什么需要输入验证？在上一篇文章中，我们学习了数据类型转换，我们提到了表示层数据处理的两个方法，也提到了用户输入数据需要进行类型转换...

一、前言

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：

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;
  }
  //2
  @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"); 
     } 
  }
  //1
  public void validatetest(){
    system.out.println("自定义校验方法：validatetest");
  }
  //3
  public string test(){
    system.out.println("test：方法");
    return success;
  }
}

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

新建struts.xml，存放在web-inf/classes/struts.xml

Struts2数据输入验证教程详解

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

Struts2数据输入验证教程详解

新建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，放在同级目录下

Struts2数据输入验证教程详解

该文件的内容有：

Struts2数据输入验证教程详解

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

新建成功视图：success.jsp

success.jsp

新建错误视图：input.jsp

input.jsp

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

Struts2数据输入验证教程详解

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

Struts2数据输入验证教程详解

控制台测试结果为：

Struts2数据输入验证教程详解

数据跳转到usertypeconverter进行类型转换，之后跳转到registeraction，执行validatetest方法()，validate，test之后返回success，然后执行result的视图。

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

Struts2数据输入验证教程详解

input.jsp页面

Struts2数据输入验证教程详解

控制台测试效果：

Struts2数据输入验证教程详解

在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中进行配置：

Struts2数据输入验证教程详解

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

之后我们需要新建employee-validation.xml，路径放在与employee同级目录下，注意：-validation.xml是固定不变的

Struts2数据输入验证教程详解

内容为：

<?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]

Struts2数据输入验证教程详解