struts2视频学习笔记 22-23（基于XML配置方式实现对action的所有方法及部分方法进行校验）

课时22

• 基于XML配置方式实现对action的所有方法进行校验

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

<!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="username">  <!-- 指定action中要校验的属性 -->
        <field-validator type="requiredstring">   <!-- <field-validator>指定校验器，上面指定的校验器requiredstring是由系统提供的，系统提供了能满足大部分验证需求的校验器，这些校验器的定义可以在xwork-2.x.jar中的com.opensymphony.xwork2.validator.validators下的default.xml中找到。 -->
            <param name="trim">true</param> <!-- 为校验器requiredstring对应的类的属性注入了值，默认就是true，可不写 -->
            <message key="用户名不能为空"/>
        </field-validator>
    </field>
    <field name="phone">
        <field-validator type="requiredstring">
            <message key="手机号不能为空"/>
        </field-validator>
        <field-validator type="regex">
              <param name="expression"><![CDATA[^1[358]\\d{9}$]]></param>  <!--  CDATA 指的是不应由 XML 解析器进行解析的文本数据（Unparsed Character Data） -->
            <message key="手机号不能为空"/>
        </field-validator>
    </field>

</validators>

　　<message>为校验失败后的提示信息,如果需要国际化，可以为message指定key属性，key的值为资源文件中的key。
在这个校验文件中，对action中字符串类型的username属性进行验证，首先要求调用trim()方法去掉空格，然后判断用户名是否为空。

• 在编写ActionClassName-validation.xml校验文件时,如果出现不了帮助信息,可以按下面方式解决：
  windwos->preferences->myeclipse->files and editors->xml->xmlcatalog
  点“add”,在出现的窗口中的location中选“File system”,然后在xwork-2.1.2解压目录的src\java目录中选择xwork-validator-1.0.3.dtd,回到设置窗口的时候不要急着关闭窗口,应把窗口中的Key Type改为URI 。Key改为http://www.opensymphony.com/xwork/xwork-validator-1.0.3.dtd

• struts2提供的校验器列表
• 系统提供的校验器如下：
  required (必填校验器,要求field的值不能为null)
  requiredstring (必填字符串校验器,要求field的值不能为null,并且长度大于0,默认情况下会对字符串去前后空格)
  stringlength(字符串长度校验器,要求field的值必须在指定的范围内,否则校验失败,minLength参数指定最小长度,maxLength参数指定最大长度,trim参数指定校验field之前是否去除字符串前后的空格)
  regex(正则表达式校验器,检查被校验的field是否匹配一个正则表达式.expression参数指定正则表达式,caseSensitive参数指定进行正则表达式匹配时,是否区分大小写,默认值为true)
  int(整数校验器,要求field的整数值必须在指定范围内,min指定最小值,max指定最大值)
  double(双精度浮点数校验器,要求field的双精度浮点数必须在指定范围内,min指定最小值,max指定最大值)
  fieldexpression(字段OGNL表达式校验器,要求field满足一个ognl表达式,expression参数指定ognl表达式,该逻辑表达式基于ValueStack进行求值,返回true时校验通过,否则不通过)
  email(邮件地址校验器,要求如果field的值非空,则必须是合法的邮件地址)
  url(网址校验器,要求如果field的值非空,则必须是合法的url地址)
  date(日期校验器,要求field的日期值必须在指定范围内,min指定最小值,max指定最大值)
  conversion(转换校验器,指定在类型转换失败时,提示的错误信息)
  visitor(用于校验action中的复合属性,它指定一个校验文件用于校验复合属性中的属性)
  expression(OGNL表达式校验器,expression参数指定ognl表达式,该逻辑表达式基于ValueStack进行求值,返回true时校验通过,否则不通过,该校验器不可用在字段校验器风格的配置中)

  required  必填校验器
  <field-validator type="required">
         <message>性别不能为空!</message>
  </field-validator>
  
  requiredstring  必填字符串校验器
  <field-validator type="requiredstring">
         <param name="trim">true</param>
         <message>用户名不能为空!</message>
  </field-validator>
  
  stringlength：字符串长度校验器
  <field-validator type="stringlength">
      <param name="maxLength">10</param>
      <param name="minLength">2</param>
      <param name="trim">true</param>
      <message><![CDATA[产品名称应在2-10个字符之间]]></message>
  </field-validator>
  email：邮件地址校验器
  <field-validator type="email">
      <message>电子邮件地址无效</message>
  </field-validator>
  
  regex：正则表达式校验器
  <field-validator type="regex">
       <param name="expression"><![CDATA[^1[358]\d{9}$]]></param>
       <message>手机号格式不正确!</message>
  </field-validator>
  int：整数校验器
  <field-validator type="int">
      <param name="min">1</param>
      <param name="max">150</param>
      <message>年龄必须在1-150之间</message>
  </field-validator>
  
  字段OGNL表达式校验器
  <field name="imagefile">
      <field-validator type="fieldexpression">
          <param name="expression"><![CDATA[imagefile.length() <= 0]]></param>
          <message>文件不能为空</message>
      </field-validator>
  </field>

　　　　

required  必填校验器
<field-validator type="required">
       <message>性别不能为空!</message>
</field-validator>

requiredstring  必填字符串校验器
<field-validator type="requiredstring">
       <param name="trim">true</param>
       <message>用户名不能为空!</message>
</field-validator>

stringlength：字符串长度校验器
<field-validator type="stringlength">
    <param name="maxLength">10</param>
    <param name="minLength">2</param>
    <param name="trim">true</param>
    <message><![CDATA[产品名称应在2-10个字符之间]]></message>
</field-validator>

  
课时23

• 基于XML配置方式实现对指定action方法校验

　　  当校验文件的取名为ActionClassName-validation.xml时，会对 action中的所有处理方法实施输入验证。如果你只需要对action中的某个action方法实施校验，那么，校验文件的取名应为:ActionClassName-ActionName-validation.xml，其中ActionName为struts.xml中action的名称。（由路径决定）

　　 eg：Person-list_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的校验规则为这四个文件的总和。