Struts2学习笔记之输入校验

Struts2学习笔记

第十一记：struts2输入校验

注：action内针对所有方法或指定方法名的校验。如果有验证方法必须在struts.xml中设置input视图,当未通过验证返回名称为input的视图

1、struts2的输入校验方式

  方式一：采用手工编码实现

  方式二：基于XML配置实现

2、采用手工编码实现 

  2-1、编写JSP表单输入:change.jsp

  <from action="${pageContext.request.contextPath}/person/person_save.action"method="post">

   用户名：<input name="username" type="text"/>

  手机号：<input name="mobile"type="text"/>

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

  </from>

  2-2、编写Action的方法

    该action继承自ActionSupport类，并且需要重写validate方法。

   public  class PersonAction extends ActionSupport{

           private  String username;

           private  String mobile;

           public String getUsername(){
                  return this.message;
           }
          public void setUsername(String username){
                 this.username=username;
          }

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

         publicString  save( ){
                    ActionContext.getContext.put("message","保存成功！");

                    return "message";
          }

         public String  update( ){
                    ActionContext.getContext.put("message","更新成功！");

                     return "message";
          }

        @override//此方法会对action中的所有方法进行校验

         public  void   validate(){

                 if(this.username==null||"".equals(this.username.trim())){

                      this.addFieldError("username","用户名不能为空");

                }

                if(this.mobile==null||"".equals(this.username.trim())){

                       this.addFieldError("mobile","手机号不能为空");

               }else{

                      if(!Pattern.compile("^1[358]\\d${9}")).matcher(this.mobile).method()){

                                this.addFieldError("mobile","手机号格式不正确");

                      }

               }

         }

  }

   2-3、导入struts标签库并设置错误结果显示标签

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

   在表单外部或者内部添加错误显示标签：<s:fielderror />

  2-4、修改struts.xml文件

<package name="person" namespace="/person" extends="struts default">

    <action   name="person_*" class="com.struts.action.PersonAction">

             <result  name="input">/WEB-INF/page/change.jsp</result>

             <result  name="message">/WEB-INF/page/message.jsp</result>

    </action>

    </package>

  2-5、控制指定方法的校验

    规则：名称如validateXxx的方法表示对xxx方法的校验。

   如果将validate方法改为validateSave则只能对save方法进行校验。

  2-6、校验过程梳理

      2-6-1、类型转换：对action对象的属性赋值

      2-6-2、检测类型转换异常，如果发现则通过ActionContext和ConversionError对象添加异常信息到fieldErrors对象

      2-6-3、执行validateXxx()方法。

      2-6-4、执行validate()方法。

      2-6-5、读取fieldErrors对象，如果不为空则转到Input视图，否则执行action操作。

  注：这里发生的错误多半是类型转换。

3、XML配置校验

3-1、验证文件的命名和验证规则

实现action类同样需要继承自ActionSupport，需要验证的action的配置文件于struts.xml都在src目录下，并且该xml验证文件的名称是ActionName-validation.xml

"*-validation.xml"是固定写法；*是action的名称，如PersonAction的验证文件是PersonAction-validation.xml.

xwork目录下路径;com.opensymphony.xwork2.validator.validators有个default.xml文件提供了基本数据验证的默认验证。

default.xml的配置如下所示:

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE validators PUBLIC
"-//OpenSymphony Group//XWork Validator Config 1.0//EN"
  "http://www.opensymphony.com/xwork/xwork-validator-config-1.0.dtd">
<!-- 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 -->

-校验规则：
required:必填校验器
requiredstring:必填字符串校验器
int:整数校验器
double:双精度浮点数校验器
date:日期校验器
expression:表达式校验器
fieldexpression:字段表达式校验器
email:电子邮件校验器
url:网址校验器
visitor:Visitor校验器
conversion:转换校验器
stringlength:字符串长度校验器
  regex:正则表达式校验器

3-2、struts2例子提供的配置校验的编写示例
路径：/struts_2.2.1.1/apps/blank/src/main/resources/example/login-validation.xml
<!DOCTYPE validators PUBLIC
"-//OpenSymphony Group//XWork Validator 1.0.2//EN"
         "http://www.opensymphony.com/xwork/xwork-validator-1.0.2.dtd"> 
<validators>
      <field name="username"> 
            <field-validator type="requiredstring"> 
                <message key="requiredstring"/> 
         </field-validator> 
       </field> 
       <field name="password"> 
              <field-validator type="requiredstring"> 
                   <message key="requiredstring"/> 
           </field-validator> 
        </field> 
</validators>

3-3、编写自己的验证文件

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE validators PUBLIC "-//OpenSymphony Group//XWork Validator 1.0.2//EN"
"http://www.opensymphony.com/xwork/xwork-validator-1.0.2.dtd">
 <validators>

  <!-- 验证用户名是否合法 -->
     <field name="username">
         <field-validator type="requiredstring">
         <param name="trim">true</param>
         <message>请填写用户名</message>
      </field-validator>
     <field-validator type="stringlength"> 
          <param name="minLength">4</param>
         <param name="maxLength">32</param> 
         <message>用户名长度应在4到32个字符间</message> 
   </field-validator>
</field>

<!-- 验证密码是否合法 -->
   <field name="password">
      <field-validator type="requiredstring">
          <message>请填写密码</message>
    </field-validator>
     <field-validator type="stringlength"> 
        <param name="minLength">6</param>
        <param name="maxLength">32</param> 
         <message>为了您账号的安全，请设置6个字母以上的密码（最长可设置32个字母）</message> 
    </field-validator>
</field>

<!-- 验证手机号是否合法 -->
<validators>
   <field name="user">
     <field-validator type="regex">
        <param name="expression_r"><![CDATA[^1[358]\d{9}$]]></param>
        <message>不是合法的手机号</message>
    </field-validator>
   </field>
</validators>

</validators>

3-4、常用的验证配置
3-4-1、必填检验
<validators>
     <field name="username">
       <field-validator type="required">
             <message>指定检验失败的提示信息</message>
       </field-validator>
    </field>
</validators>

3-4-2、必填字符串检验
<validators>
   <field name="username">
         <field-validator type="requiredstring">
                <param name="trim">true</param>
              <message>指定检验失败的提示信息</message>
        </field-validator>
    </field>
</validators>
3-4-3、整数检验器/浮点检验
<validators>
    <field name="age">
       <field-validator type="int">
           <param name="min">1</param>
          <param name="max">150</param>
          <message>年纪必须在1到150之间</message>
       </field-validator>
    </field>
</validators>
3-4-4、日期检验
<validators>
 <field name="birth">
     <field-validator type="date">
         <param name="min">1900-01-01</param>
         <param name="max">2050-02-21</param>
        <message key="birth.range"/>
    </field-validator>
 </field>
</validators>
3-4-5、字段表达式检验器(要求指定字段满足一个逻辑表达式

<validators>
    <field name="re_pass">
        <field-validator type="fieldexpression">
        <!--指定逻辑表达式 -->
             <param name="expression"> (pass eq re_pass)</param>
             <message>密码必须和确认密码相等</message>
       </field-validator>
     </field>
</validators>
3-4-6、邮件地址校验
<validators>
  <field name="email">
       <field-validator type="email">
          <message>你的电子邮件地址必须是一个有效的电邮地址</message>
        </field-validator>
   </field>
</validators>
3-4-7、网址检验
<validators>
    <field name="url">
        <field-validator type="url">
             <message>你的主页地址必须是一个有效的网址</message>
       </field-validator>
    </field>
</validators>
3-4-8、字符串长度检验
<validators>
   <field name="user">

       <field-validator type="stringlength">
          <param name="minlength">4</param>
         <param name="maxlength">20</param>
         <message>你的用户名长度必须在4到20之间</message>
      </field-validator>
   </field>
</validators>
3-4-9、正则表达式检验
<validators>
   <field name="user">
     <field-validator type="regex">
        <param name="expression_r"><![CDATA[(\w{4,25})]]></param>
        <message>您输入的用户名只能是字母和数组，且长度必须在4到25之间</message>
    </field-validator>
   </field>
</validators>

3-5、配置指定方法的校验
文件命名规则：ActionClassName-ActonName-validation.xml
如在PersionAction中访问update的方法验证,则可以写成:
PersonAction-person_update-validation.xml
struts.xml的配置如下：
<action name="person_*" class="com.struts.action.PersonAction">
<result name="input">/WEB-INF/page/change.jsp</result><!-- 验证失败返回该页面 -->
<result name="message">/WEB-INF/page/message.jsp</result><!-- 成功转到页面 -->
...</action>

注意：所有方法的校验和指定方法的校验同时存在的时候，方法验证会合并然后执行，对于同样的方法
执行后面那个，前面的被覆盖。