Struts2 Validation学习

Every input is evil!

------------------------------华丽的分割线-----------------------------------

客户端提交的数据验证的方式有很多，可以在前段使用JS验证，可以在服务器端进行验证等，本文主要讲使用Struts2 Validation框架进行验证

假定已经存在一个ValidationAction接受前端数据

ValidationAction，代码如下：

package com.huohuo.action;

import com.opensymphony.xwork2.ActionSupport;

public class ValidationAction extends ActionSupport{
    private String requiredString ;
    private int num;
    public int getNum() {
        return num;
    }

    public void setNum(int num) {
        this.num = num;
    }

    public String getRequiredString() {
        return requiredString;
    }

    public void setRequiredString(String requiredString) {
        this.requiredString = requiredString;
    }
    
    public String execute()
    {
        return SUCCESS;
    }
}

显而易见，要验证核实前段提交的两个数据，num和requiredString.重点放在Validation的配置和使用

步骤一：在和ValidaitonAction同一个包下建立名为ValidationAction-validation.xml文件（默认起名为YourActionName-validation.xml，加载时会自动检测XMl）

注意dtd，老版本的会提示你找不到dtd，你要使用最新的dtd，

ValidationAction-validation.xml，代码如下：

<?xml version="1.0" encoding="UTF-8"?>
<!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="requiredString">    <!--要验证的数据字段名字-->
    <field-validator type="requiredstring">    <!--验证的类型-->
    <message>This need a String!</message>
    </field-validator>
</field>

<field name="num">            <!--要验证的数据字段名字-->

 <field-validator type="int"> 　　 <!--验证的类型-->
　　<param name="min">5</param> 　　
　　<param name="max">10</param> 
　　<message>betweend 5-10</message> 
</field-validator> 
</field>

</validators>

 注意：如果要接受的参数是user.name,user.password，那么你需要在上面ValidationAction-validation.xml加入以下代码：

<field name="user">
　　<field-validator type="visitor">
　　<param name="context">visitorContext</param>
　　<param name="appendPrefix"> true </param>
　　<message>修改提示：</message>
　　</field-validator>
</field>

需要在User的同一个包下建立一个xml文件,User-visitorContext-validation.xml，加入以下的代码：

<?xml version="1.0" encoding="UTF-8"?>
<!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="email">
    <field-validator type="requiredstring">
    <message>请输入合法的邮箱名</message>
    </field-validator>
</field> 

    <field name="name">
    <field-validator type="requiredstring">
    <message>用户名不能为空</message>
    </field-validator>
</field>

<field name="password">
    <field-validator type="requiredstring">
    <message>密码不能为空</message>
    </field-validator>
</field>

</validators>

亲测之后发现:

在User-visitorContext-validation.xml文件设定的email类型为type="email"的数据字段不会给我验证，倒腾了几个小时我才发现，要在User中设为requiredstring,同时还需要在ValidationAction-validation.xml文件中添加email这个field

<field name="user.email">
    <field-validator type="email">
    <message>请填写合法邮箱</message>
    </field-validator>
    </field> 

这样，如果User-visitorContext-validation.xml设定的验证器不起作用，还可以触发ValidationAction-validation.xml设定的触发器，这两个要同时设定，如果只设定后者的不设定前者的还是不会触发。

这样改过就会验证里面的数据了，估计是个bug，没搞明白，搞的脑袋到都大了。

----第二天报错了----------------------

查到原因是因为我有3个ActionValidation.xml文件，里面都用到了user visitor，那么里面的参数 <param name="context">visitorContext</param>里面visitorContext名字要不一样，否则会出BUG

 ---------第三天报错了--------------

我在页面加入token之后，validation居然失效了，然后我又把每个XML配置文件的<param name="context">visitorContext</param>改成一致的就好使了，妈的，要怎样！

步骤二：

Struts2 Validation机制如果检测到输入不合法，那么会自动返回一个名为result名字为"input"，供用户二次输入，所以你要设计好"input"，result，本文设置这个JSP为Input.jsp.所以你需要在struts.xml配置这个Input.jsp文件

struts.xml代码如下：

<?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>
 
     <constant name="struts.devMode" value="true" />
     <!--Action配置  -->
     <package name="default" namespace="/" extends="struts-default">
        <action name="validationAction" class="com.huohuo.action.ValidationAction">
            <result > /Output.jsp </result > 
            <result name ="input" > /Input.jsp </result >              //如果检测到错误，validation将会返回这个jsp
            <result name="fail">/fail.jsp</result>
        </action>
    </package>
    <!-- Add packages here -->
</struts>

步骤三：

写你的Input.jsp文件进行测试，Struts2 validation要配合<s:form>标签，所以你要了解一下<s:form>标签的使用方法

Input.jsp代码如下：

<%@ page language="java" import="java.util.*" pageEncoding="ISO-8859-1"%>

<%@taglib prefix = "s" uri ="/struts-tags" %>

<%
String path = request.getContextPath();
String basePath = request.getScheme()+"://"+request.getServerName()+":"+request.getServerPort()+path+"/";
%>
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
  <head>
    <base href="<%=basePath%>">
    
    <title>My JSP 'index.jsp' starting page</title>
    <meta http-equiv="pragma" content="no-cache">
    <meta http-equiv="cache-control" content="no-cache">
    <meta http-equiv="expires" content="0">    
    <meta http-equiv="keywords" content="keyword1,keyword2,keyword3">
    <meta http-equiv="description" content="This is my page">
    <!--
    <link rel="stylesheet" type="text/css" href="styles.css">
    -->
    　　    <s:head/>                                                   //这句代码是让出错的时候，message信息为红色的警告信息，如果不加，就是黑色的字体
  </head>
  
  <body>
    <s:form  action="validationAction">
       <s:textfield name ="requiredString" label ="Required String" /> 
       <s:textfield name ="num" label ="Required Number" /> 
    <s:submit />

</s:form>
  </body>
</html>

为了测试，你可以再加一个Output.jsp，我put核心的显示代码如下，别忘了加<%@ s:tag blablabla%>那句话

Output.jsp

 Required String: <s:property value ="requiredString" />
 Required number: <s:property value ="num" />   

好了，结束，你可以使用Struts2 Validation framework进行输入测试了，是不是很简单，当然还有一些其他的验证类型，如email,date,double,url...查官方文档，穿一手鞋。

--------------------------华丽的分割线--------------------------------------------------------------------------------------------

使用Annotaion进行Validation注解

只需要在ValidationAction需要验证的参数的set方法上面加上一句注释就OK

像上面的例子，验证requiredString，只需要改为

 @RequiredStringValidator(message = "请输入关键字")

public void setRequiredString(String requiredString) {
        this.requiredString = requiredString;
    }
这样就可以直接使用Struts2 Validation了，不需要ValidationAction-validation.xml文件配置
Struts2提供了集中注解：
1.@RequiredFieldValidator
2.@RequiredStringValidator
3.@EmailValidator
4.@UrlValidator
5.@StringLengthFieldValidator
6.@IntRangeFieldValidator
7.@DateRangeFieldValidator
PS:在一个Action中被validation annotaion标注的属性，会被应用到每一个Action中的方法，如果不想让其他的方法被验证，需要在该方法名上加入@SkipValidation注释