对Action中所有方法、指定方法进行校验

来源：互联网发布：金融类英语翻译软件编辑：程序博客网时间：2024/06/06 00:59

传智播客struts2.1.8视频教程(十六)：对Action中所有方法、指定方法进行校验

在struts2中，我们可以实现对action的所有方法进行校验或者对action的指定方法进行校验。

对于输入校验struts2提供了两种实现方法:
1. 采用手工编写代码实现。
2. 基于XML配置方式实现。

下面创建测试环境：
web.xml与以前一样，存在WEB-INF目录下：
<?xml version="1.0" encoding="UTF-8"?>
<web-app version="3.0" xmlns="http://java.sun.com/xml/ns/javaee" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://java.sun.com/xml/ns/javaeehttp://java.sun.com/xml/ns/javaee/web-app_3_0.xsd">

<display-name>Struts Blank</display-name>

    <filter>
        <filter-name>struts2</filter-name>
        <filter-class>org.apache.struts2.dispatcher.ng.filter.StrutsPrepareAndExecuteFilter</filter-class>
    </filter>

    <filter-mapping>
        <filter-name>struts2</filter-name>
        <url-pattern>/*</url-pattern>
    </filter-mapping>

    <welcome-file-list>
        <welcome-file>index.jsp</welcome-file>
    </welcome-file-list>

</web-app>

strtus.xml，存在src目录下：
<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE struts PUBLIC
    "-//Apache Software Foundation//DTD Struts Configuration 2.0//EN"
    "http://struts.apache.org/dtds/struts-2.0.dtd">

<struts>

<package name="global" extends="struts-default">
    <global-results>
      <result name="success">/WEB-INF/page/success.jsp</result>
      <result name="failed">/WEB-INF/page/failed.jsp</result>
      <result name="message">/WEB-INF/page/message.jsp</result>
    </global-results>
</package>
<package name="person" namespace="/person" extends="global">
  <action name="manage_*" class="cn.itcast.action.PersonAction" method="{1}">
  </action>
</package>
</struts>

PersonAction.java：
package cn.itcast.action;

import com.opensymphony.xwork2.ActionContext;

public class PersonAction {
private String username;
private String mobile;

下面是几个显示用的页面，保存在WEB-INF/page下：
message.jsp：
<%@ page language="java" contentType="text/html; charset=UTF-8"
pageEncoding="UTF-8"%>

<!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>message</title>
</head>
<body>
${message}
</body>
</html>

success.jsp：
<%@ page language="java" contentType="text/html; charset=UTF-8"
pageEncoding="UTF-8"%>
<!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>
success page
</body>
</html>

failed.jsp：
<%@ page language="java" contentType="text/html; charset=UTF-8"
pageEncoding="UTF-8"%>
<!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>
failed page
</body>
</html>

下面是需要校验的页面：
index.jsp：
<%@ page language="java" contentType="text/html; charset=UTF-8"
    pageEncoding="UTF-8"%>
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<title>Insert title here</title>
</head>
<body>
<form action="${pageContext.request.contextPath }/person/manage_save.action" method="post">
  用户名：<input type="text" name="username"/>(要求：不能为空)<br>
  手机号：<input type="text" name="mobile"/>(要求：不能为空，并且要符合手机号的格式：1,3/5/8,后面是9个数字)<br>
  <input type="submit" value="提交">
</form>
</body>
</html>

1. 采用手工编写代码方式实现对action的所有方法进行校验

通过重写validate() 方法实现， validate()方法会校验action中所有与execute方法签名相同的方法。当某个数据校验失败时，我们应该调用addFieldError()方法往系统的fieldErrors添加校验失败信息（为了使用addFieldError()方法，action可以继承ActionSupport ），如果系统的fieldErrors包含失败信息，struts2会将请求转发到名为input的result。在input视图中可以通过<s:fielderror/>显示失败信息。

validate()使用例子：
public void validate() {
       if(this.mobile==null || "".equals(this.mobile.trim())){ this.addFieldError("username", "手机号不能为空");
        }else{ if(!Pattern.compile("^1[358]\\d{9}$").matcher(this.mobile.trim()).matches()){
  this.addFieldError(“mobile", "手机号的格式不正确"); }
       }
}

验证失败后，请求转发至input视图：
<result name="input">/WEB-INF/page/addUser.jsp</result>
在addUser.jsp页面中使用<s:fielderror/>显示失败信息。

下面是示例：
PersonAction.java修改如下：
package cn.itcast.action;

import java.util.regex.Pattern;

import com.opensymphony.xwork2.ActionContext;
import com.opensymphony.xwork2.ActionSupport;

public class PersonAction extends ActionSupport{
private String username;
private String mobile;

public String getUsername() {
  return username;
}
public void setUsername(String username) {
  this.username = username;
}
public String getMobile() {
  return mobile;
}
public void setMobile(String mobile) {
  this.mobile = mobile;
}

public String update() {
  ActionContext.getContext().put("message", "更新成功");
  return "message";
}
public String save() {
  ActionContext.getContext().put("message", "保存成功");
  return "message";
}

@Override
public void validate() {
  // validate方法会对action中的所有方法进行校验
  // 校验失败会转向名为input的视图
  if (this.username==null || "".equals(this.username.trim())) {
   this.addFieldError("username", "用户名不能为空");
  }
  if(this.mobile==null || "".equals(this.mobile.trim())){
   this.addFieldError("mobile", "手机号不能为空");
        }else{
        if(!Pattern.compile("^1[358]\\d{9}$").matcher(this.mobile.trim()).matches()){
          this.addFieldError("mobile", "手机号的格式不正确");
        }
        }
  //super.validate();
}
}

在struts.xml中增加名为input的视图，在本例中，input视图为输入的界面，即index.jsp：
<package name="person" namespace="/person" extends="global">
  <action name="manage_*" class="cn.itcast.action.PersonAction" method="{1}">
   <result name="input">/index.jsp</result>
  </action>
</package>

在index.jsp页面中使用struts标签显示错误信息：
<%@ 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>
<title>Insert title here</title>
</head>
<body>
<s:fielderror/>
<form action="${pageContext.request.contextPath }/person/manage_save.action" method="post">
  用户名：<input type="text" name="username"/>(要求：不能为空)<br>
  手机号：<input type="text" name="mobile"/>(要求：不能为空，并且要符合手机号的格式：1,3/5/8,后面是9个数字)<br>
  <input type="submit" value="提交">
</form>
</body>
</html>

-----------------------------------------------------------

2. 采用手工编写代码方式实现对action的指定方法进行校验

通过validateXxx()方法实现， validateXxx()只会校验action中方法名为Xxx的方法。其中Xxx的第一个字母要大写。当某个数据校验失败时，我们应该调用addFieldError()方法往系统的fieldErrors添加校验失败信息（为了使用addFieldError()方法，action可以继承ActionSupport ），如果系统的fieldErrors包含失败信息，struts2会将请求转发到名为input的result。在input视图中可以通过<s:fielderror/>显示失败信息。

validateXxx()方法使用例子：
public String add() throws Exception{ return "success";}
public void validateAdd(){
if(username==null && "".equals(username.trim())) this.addFieldError("username", "用户名不能为空");
}

验证失败后，请求转发至input视图：
<result name="input">/WEB-INF/page/addUser.jsp</result>

在addUser.jsp页面中使用<s:fielderror/>显示失败信息。

-----------------------------------------------------------

3. 基于XML配置方式实现对action的所有方法进行输入校验

使用基于XML配置方式实现输入校验时，Action也需要继承ActionSupport，并且提供校验文件，校验文件和action类放在同一个包下，文件的取名格式为：ActionClassName-validation.xml，其中ActionClassName为action的简单类名，-validation为固定写法。如果Action类为cn.itcast.UserAction，那么该文件的取名应为：UserAction-validation.xml。下面是校验文件的模版：

<field>指定action中要校验的属性，<field-validator>指定校验器，上面指定的校验器requiredstring是由系统提供的，系统提供了能满足大部分验证需求的校验器，这些校验器的定义可以在xwork-2.x.jar中的com.opensymphony.xwork2.validator.validators下的default.xml中找到。
<message>为校验失败后的提示信息,如果需要国际化，可以为message指定key属性，key的值为资源文件中的key。
在这个校验文件中，对action中字符串类型的username属性进行验证，首先要求调用trim()方法去掉空格，然后判断用户名是否为空。

可以在下面这个文件中查看已经定义的validator：
xwork-core-2.2.1.jar\com\opensymphony\xwork2\validator\validators\default.xml

举例如下：
注释掉PersonAction.java中的validateXxx()函数。
在PersonAction.java相同包下增加PersonAction-validation.xml文件，内容如下：

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE validators PUBLIC "-//OpenSymphony Group//XWork Validator 1.0.3//EN" "http://www.opensymphony.com/xwork/xwork-validator-1.0.3.dtd">
<validators>
    <field name="username">
        <field-validator type="requiredstring">
            <param name="trim">true</param>
            <message>用户名不能为空!</message>
        </field-validator>
    </field>
    <field name="mobile">
        <field-validator type="requiredstring">
            <message>手机号不能为空!</message>
        </field-validator>
        <field-validator type="regex">
            <param name="expression"><![CDATA[^1[358]\d{9}$]]></param>
            <message>手机号格式不正确!</message>
        </field-validator>
    </field>
</validators>

传智播客struts2.1.8视频教程(十七)：输入校验的流程

传智播客struts2.1.8视频教程(十八)：编写校验文件时，不能出现帮助信息

传智播客struts2.1.8视频教程(十九)：struts2提供的校验器列表、校验器的使用例子

-----------------------------------------------------------

4. 基于XML配置方式对指定action方法实现输入校验

当校验文件的取名为ActionClassName-validation.xml时，会对 action中的所有处理方法实施输入验证。如果你只需要对action中的某个action方法实施校验，那么，校验文件的取名应为:ActionClassName-ActionName-validation.xml，其中ActionName为struts.xml中action的名称。例如：在实际应用中，常有以下配置：
<action name="user_*" class="cn.itcast.action.UserAction" method="{1}“ >
<result name="success">/WEB-INF/page/message.jsp</result>
<result name="input">/WEB-INF/page/addUser.jsp</result>
</action>
UserAction中有以下两个处理方法：
public String add() throws Exception{
....
}
public String update() throws Exception{
....
}
要对add()方法实施验证，校验文件的取名为： UserAction-user_add-validation.xml
要对update()方法实施验证，校验文件的取名为： UserAction-user_update-validation.xml

-----------------------------------------------------------

基于XML校验的一些特点：

当为某个action提供了ActionClassName-validation.xml和ActionClassName-ActionName-validation.xml两种规则的校验文件时，系统按下面顺序寻找校验文件：
1。AconClassName-validation.xml
2。ActionClassName-ActionName-validation.xml
系统寻找到第一个校验文件时还会继续搜索后面的校验文件，当搜索到所有校验文件时，会把校验文件里的所有校验规则汇总，然后全部应用于action方法的校验。如果两个校验文件中指定的校验规则冲突，则只使用后面文件中的校验规则。

当action继承了另一个action，父类action的校验文件会先被搜索到。

假设UserAction继承BaseAction：
<action name="user" class="cn.itcast.action.UserAction" method="{1}">
</action>

访问上面action，系统先搜索父类的校验文件：BaseAction-validation.xml， BaseAction-user-validation.xml，接着搜索子类的校验文件： UserAction-validation.xml， UserAction-user-validation.xml。应用于上面action的校验规则为这四个文件的总和。