[原创]java WEB学习笔记70：Struts2 学习之路-- 输入验证，声明式验证，声明是验证原理

本博客的目的：①总结自己的学习过程，相当于学习笔记 ②将自己的经验分享给大家，相互学习，互相交流，不可商用

内容难免出现问题，欢迎指正，交流，探讨，可以留言，也可以通过以下方式联系。

本人互联网技术爱好者，互联网技术发烧友

微博：伊直都在0221

QQ：951226918

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

1.概述

　　1）一个健壮的 web 应用程序必须确保用户输入是合法、有效的.

　　2）Struts2 的输入验证

　　　　> 基于 XWork Validation Framework 的声明式验证：Struts2 提供了一些基于 XWork Validation Framework 的内建验证程序. 使用这些验证程序不需要编程, 只要在一个 XML 文件里对验证程序应该如何工作作出声明就可以了. 需要声明的内容包括:

　　　　　　　　　哪些字段需要进行验证  : 对 哪个Action 或者 model 的哪个字段进行验证

　　　　　　　　　使用什么验证规则 : 使用的验证规则

　　　　　　　　　　　　　　　

　　　　　　　  　在验证失败时应该把什么样的出错消息发送到浏览器端 : 如果验证失败，转向哪一个页面，显示什么错误消息

　　

　　　　

　　　　　　

　　　　

　　　　> 编程验证：通过编写代码来验证用户输入

2.声明式的 helloword

　　　　

　　1）明确对哪一个Action 的那一个 字段进行验证：age

　　2）关于配置文件：\struts-2.3.15.3-all\struts-2.3.15.3\apps\struts2-blank\WEB-INF\classes\example\ 下的 Login-validation.xml 文件，复制到验证的action 所在的包下

　　3）将配置文件名改为：把Login 改为当前的Action 的名字。如 TestValidation-validation.xml

　　4）验证规则的编写：参照 /struts-2.3.15.3-all/struts-2.3.15.3/docs/WW/docs/int-validator.html

　　

　　5）若验证失败，则转向 input 的那个result ，所以需要配置 nama = input 的result。<result name="input">/validation/validation.jsp</result>

　　6）如何显示错误消息：　　　　

  <!-- 针对于 age 属性进行验证 。基于字段的验证-->
      <field name="age">
          <field-validator type="int">
              <param name="min">20</param>
              <param name="max">50</param>
              <message>Age needs to be between ${min} and ${max}</message>
          </field-validator>
      </field>

> 若使用的是非simple 主题，则自动显示错误消息

　　  > 若使用的是非 simple 主题，则需要s:fiederror 标签或直接使用 EL 表达式

　　　　　　${fieldErrors.age[0]}  或者 <s:fieldError fieldName="age" ></s:fielderror>

　　　 > 错误消息可以使用国际化

　　　　　　<message  key="error.int" ></message>

　　　     　i18n.properties

　　　　　　error.int= 自定义

　　7） 问题：若一个Action 类可以应答多个action 请求，多个action 请求使用不同的验证规则，怎么办？

　　　　　　> 为每一个不同的Action 请求定义其对应的验证文件：ActionClassName-AliasName-validation.xml

　　　　　　> 不带别名的配置文件：ActionClassName-validation.xml 中的验证规则依然发生作用。可以把各个action 公有的验证规则配置在其中。需要注意：只适用于某一个Action 请求的验证规则，就不采取这种方法

3.声明式验证框架的原理：

　　　> Struts2 默认的拦截器中提供了一个 validation 的拦截器

　　　> 每一个具体的验证规则都会对应具体的一个验证器。有一个配置文件，就是把验证规则名称和验证器关联起来了。实际验证的是那个验证器。该文件位于com.opensymphony.xwork2.validator.validators 下的default.xml

验证规则和验证器

 <!-- START SNIPPET: validators-default -->
 <validators>
     <validator name="required" class="com.opensymphony.xwork2.validator.validators.RequiredFieldValidator"/>
     <validator name="requiredstring" class="com.opensymphony.xwork2.validator.validators.RequiredStringValidator"/>
     <validator name="int" class="com.opensymphony.xwork2.validator.validators.IntRangeFieldValidator"/>
     <validator name="long" class="com.opensymphony.xwork2.validator.validators.LongRangeFieldValidator"/>
     <validator name="short" class="com.opensymphony.xwork2.validator.validators.ShortRangeFieldValidator"/>
     <validator name="double" class="com.opensymphony.xwork2.validator.validators.DoubleRangeFieldValidator"/>
     <validator name="date" class="com.opensymphony.xwork2.validator.validators.DateRangeFieldValidator"/>
     <validator name="expression" class="com.opensymphony.xwork2.validator.validators.ExpressionValidator"/>
     <validator name="fieldexpression" class="com.opensymphony.xwork2.validator.validators.FieldExpressionValidator"/>
     <validator name="email" class="com.opensymphony.xwork2.validator.validators.EmailValidator"/>
     <validator name="url" class="com.opensymphony.xwork2.validator.validators.URLValidator"/>
     <validator name="visitor" class="com.opensymphony.xwork2.validator.validators.VisitorFieldValidator"/>
     <validator name="conversion" class="com.opensymphony.xwork2.validator.validators.ConversionErrorFieldValidator"/>
     <validator name="stringlength" class="com.opensymphony.xwork2.validator.validators.StringLengthFieldValidator"/>
     <validator name="regex" class="com.opensymphony.xwork2.validator.validators.RegexFieldValidator"/>
     <validator name="conditionalvisitor" class="com.opensymphony.xwork2.validator.validators.ConditionalVisitorFieldValidator"/>
 </validators>
 <!--  END SNIPPET: validators-default -->

　　> 时序图

　　　　

　　>对应关系

　　

4.代码结构：

　　

 package com.jason.struts2.validation.app;

 import com.opensymphony.xwork2.ActionSupport;

 public class TestValidation  extends ActionSupport{

         /**
      *  @Fields:serialVersionUID
      */
     private static final long serialVersionUID = 1L;
         int age;

         public int getAge() {
             return age;
         }

         public void setAge(int age) {
             this.age = age;
         }

         @Override
         public String execute() throws Exception {
             System.out.println("age:" + age );
             return SUCCESS;
         }

 }

TestValidation

 <%@ page language="java" contentType="text/html; charset=UTF-8"
     pageEncoding="UTF-8"%>
 <%@ taglib prefix="s" uri="/struts-tags" %>
 <!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="testValidation">
         <s:textfield  name="age" label="Age"></s:textfield>
         <s:submit></s:submit>
     </s:form>

 </body>
 </html>

validation.jsp

 <?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="strut2.custom.i18n.resouce" value="i18n"></constant>

      <constant name="struts.action.extension" value="action,do,"></constant>
      <package name="default" namespace="/" extends="struts-default">
  <action name="testValidation" class="com.jason.struts2.validation.app.TestValidation">
               <result>/validation/success.jsp</result>
               <!-- 若验证失败，转向input -->
               <result name="input">/validation/validation.jsp</result>
           </action>

      </package>

struts.xml

 <%@ 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>

     <h4> sucecess page</h4>

 </body>
 </html>

success.jsp

 <!DOCTYPE validators PUBLIC
         "-//Apache Struts//XWork Validator 1.0.2//EN"
         "http://struts.apache.org/dtds/xwork-validator-1.0.2.dtd">

 <validators>

     <!-- 针对于 age 属性进行验证 。基于字段的验证-->
      <field name="age">
          <field-validator type="int">
              <param name="min">20</param>
              <param name="max">50</param>
              <message>Age needs to be between ${min} and ${max}</message>
          </field-validator>
      </field>
 </validators>

TestValidation-validation.xml