Struts(二十五)：自定义验证器

• 编程验证

Struts2提供了一个Validateable接口，可以使用Action类实现这个接口以提供编程验证；

ActionSupport类已经实现了Validateable接口。

public class MyAction extends ActionSupport{
    private String age;

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

    public String getAge() {
        return age;
    }

    @Override
    public void validate() {
        if (age == null || age.equals("")) {
            addFieldError("age", getText("age.null"));
        }
        super.validate();
    }
}

• 如何定义验证器？

1）自定义验证器必须实现Validator接口；

2）ValidatorSupport和FieldValidatorSupport实现了Validator接口；

　　如需要实现普通的验证程序，可以继承ValidatorSupport类；

　　如果要实现字段的验证程序，可以继承FieldValidatorSupport类；

　　如果验证器需要接受一个输入参数，需要为这个参数增加一个相应的属性。

3）注册验证器：自定义验证器需要在类路径里的某个validators.xml文件里注册，验证框架首先在根目录下找validators.xml文件，如果没有找到validators.xml文件，验证框架将调用默认的验证设置，即xwork-core.jar下com.opensymphony.xwork2.validator.validators包下default.xml文件里的配置信息。

• 以身份证验证器为例，展示如何定义验证器。

1、自定义filed验证器com.dx.strtuts2.validators.IDCardValidator.java

package com.dx.strtuts2.validators;

import java.text.ParseException;

import com.opensymphony.xwork2.validator.ValidationException;
import com.opensymphony.xwork2.validator.validators.FieldValidatorSupport;

public class IDCardValidator extends FieldValidatorSupport {

    @Override
    public void validate(Object object) throws ValidationException {
        // 1、获取请求字段名称及值
        String fieldName = getFieldName();
        Object fieldValue = getFieldValue(fieldName, object);

        // 2、验证参数值是否合法
        IDCardValidate validate = new IDCardValidate();
        Boolean result = false;
        try {
            result = validate.validate((String) fieldValue);
        } catch (ParseException e) {
            result = false;
            e.printStackTrace();
        }

        // 3、如果验证事变，返回失败信息
        if (!result) {
            addFieldError(fieldName, object);
        }
    }
}

com.dx.strtuts2.validators.IDCardValidate.java

 package com.dx.strtuts2.validators;

 import java.text.ParseException;
 import java.text.SimpleDateFormat;
 import java.util.GregorianCalendar;
 import java.util.Hashtable;
 import java.util.regex.Matcher;
 import java.util.regex.Pattern;
 import java.util.Calendar;

 public class IDCardValidate {
     /**
      * 1、号码的结构 公民身份号码是特征组合码，由十七位数字本体码和一位校验码组成。排列顺序从左至右依次为：六位数字地址码，八位数字出生日期码，
      * 三位数字顺序码和一位数字校验码。
      *
      * 2、地址码(前六位数） 表示编码对象常住户口所在县(市、旗、区)的行政区划代码，按GB/T2260的规定执行。
      *
      * 3、出生日期码（第七位至十四位） 表示编码对象出生的年、月、日，按GB/T7408的规定执行，年、月、日代码之间不用分隔符。
      *
      * 4、顺序码（第十五位至十七位）
      * 表示在同一地址码所标识的区域范围内，对同年、同月、同日出生的人编定的顺序号，顺序码的奇数分配给男性，偶数分配给女性。
      *
      * 5、校验码（第十八位数） （1）十七位数字本体码加权求和公式 S = Sum(Ai * Wi), i = 0, ... , 16
      * ，先对前17位数字的权求和 Ai:表示第i位置上的身份证号码数字值 Wi:表示第i位置上的加权因子 Wi: 7 9 10 5 8 4 2 1 6
      * 3 7 9 10 5 8 4 2 （2）计算模 Y = mod(S, 11) （3）通过模得到对应的校验码 Y: 0 1 2 3 4 5 6 7
      * 8 9 10 校验码: 1 0 X 9 8 7 6 5 4 3 2
      *
      * 所以我们就可以大致写一个函数来校验是否正确了。
      */

     /**
      * 功能：身份证的有效验证
      *
      * @param IDStr
      *            身份证号
      * @return 有效：true 无效：false
      * @throws ParseException
      */
     public boolean validate(String IDStr) throws ParseException {
         String errorInfo = "";// 记录错误信息
         String[] ValCodeArr = { "1", "0", "x", "9", "8", "7", "6", "5", "4", "3", "2" };
         String[] Wi = { "7", "9", "10", "5", "8", "4", "2", "1", "6", "3", "7", "9", "10", "5", "8", "4", "2" };
         // String[] Checker = {"1","9","8","7","6","5","4","3","2","1","1"};
         String Ai = "";

         // ================ 号码的长度 15位或18位 ================
         if (IDStr.length() != 15 && IDStr.length() != 18) {
             errorInfo = "号码长度应该为15位或18位。";
             System.out.println(errorInfo);
             return false;
         }
         // =======================(end)========================

         // ================ 数字 除最后以为都为数字 ================
         if (IDStr.length() == 18) {
             Ai = IDStr.substring(0, 17);
         } else if (IDStr.length() == 15) {
             Ai = IDStr.substring(0, 6) + "19" + IDStr.substring(6, 15);
         }
         if (isNumeric(Ai) == false) {
             errorInfo = "15位号码都应为数字 ; 18位号码除最后一位外，都应为数字。";
             System.out.println(errorInfo);
             return false;
         }
         // =======================(end)========================

         // ================ 出生年月是否有效 ================
         String strYear = Ai.substring(6, 10);// 年份
         String strMonth = Ai.substring(10, 12);// 月份
         String strDay = Ai.substring(12, 14);// 月份

         if (this.isDate(strYear + "-" + strMonth + "-" + strDay) == false) {
             errorInfo = "生日无效。";
             System.out.println(errorInfo);
             return false;
         }

         GregorianCalendar gc = new GregorianCalendar();
         SimpleDateFormat s = new SimpleDateFormat("yyyy-MM-dd");
         if ((gc.get(Calendar.YEAR) - Integer.parseInt(strYear)) > 150
                 || (gc.getTime().getTime() - s.parse(strYear + "-" + strMonth + "-" + strDay).getTime()) < 0) {
             errorInfo = "生日不在有效范围。";
             System.out.println(errorInfo);
             return false;
         }
         if (Integer.parseInt(strMonth) > 12 || Integer.parseInt(strMonth) == 0) {
             errorInfo = "月份无效";
             System.out.println(errorInfo);
             return false;
         }
         if (Integer.parseInt(strDay) > 31 || Integer.parseInt(strDay) == 0) {
             errorInfo = "日期无效";
             System.out.println(errorInfo);
             return false;
         }
         // =====================(end)=====================

         // ================ 地区码时候有效 ================
         Hashtable<String, String> h = GetAreaCode();
         if (h.get(Ai.substring(0, 2)) == null) {
             errorInfo = "地区编码错误。";
             System.out.println(errorInfo);
             return false;
         }
         // ==============================================

         // ================ 判断最后一位的值 ================
         int TotalmulAiWi = 0;
         for (int i = 0; i < 17; i++) {
             TotalmulAiWi = TotalmulAiWi + Integer.parseInt(String.valueOf(Ai.charAt(i))) * Integer.parseInt(Wi[i]);
         }
         int modValue = TotalmulAiWi % 11;
         String strVerifyCode = ValCodeArr[modValue];
         Ai = Ai + strVerifyCode;

         if (IDStr.length() == 18) {
             if (Ai.equals(IDStr) == false) {
                 errorInfo = "身份证无效，最后一位错误";
                 System.out.println(errorInfo);
                 return false;
             }
         } else {
             System.out.println("所在地区:" + h.get(Ai.substring(0, 2).toString()));
             System.out.println("新身份证号:" + Ai);
             return true;
         }
         // =====================(end)=====================
         System.out.println("所在地区:" + h.get(Ai.substring(0, 2).toString()));
         return true;
     }

     /**
      * 功能：设置地区编码
      *
      * @return Hashtable 对象
      */
     private Hashtable<String, String> GetAreaCode() {
         Hashtable<String, String> hashtable = new Hashtable<String, String>();
         hashtable.put("11", "北京");
         hashtable.put("12", "天津");
         hashtable.put("13", "河北");
         hashtable.put("14", "山西");
         hashtable.put("15", "内蒙古");
         hashtable.put("21", "辽宁");
         hashtable.put("22", "吉林");
         hashtable.put("23", "黑龙江");
         hashtable.put("31", "上海");
         hashtable.put("32", "江苏");
         hashtable.put("33", "浙江");
         hashtable.put("34", "安徽");
         hashtable.put("35", "福建");
         hashtable.put("36", "江西");
         hashtable.put("37", "山东");
         hashtable.put("41", "河南");
         hashtable.put("42", "湖北");
         hashtable.put("43", "湖南");
         hashtable.put("44", "广东");
         hashtable.put("45", "广西");
         hashtable.put("46", "海南");
         hashtable.put("50", "重庆");
         hashtable.put("51", "四川");
         hashtable.put("52", "贵州");
         hashtable.put("53", "云南");
         hashtable.put("54", "西藏");
         hashtable.put("61", "陕西");
         hashtable.put("62", "甘肃");
         hashtable.put("63", "青海");
         hashtable.put("64", "宁夏");
         hashtable.put("65", "新疆");
         hashtable.put("71", "台湾");
         hashtable.put("81", "香港");
         hashtable.put("82", "澳门");
         hashtable.put("91", "国外");
         return hashtable;
     }

     /**
      * 功能：判断字符串是否为数字
      *
      * @param str
      * @return
      */
     private boolean isNumeric(String str) {
         Pattern pattern = Pattern.compile("[0-9]*");
         Matcher isNum = pattern.matcher(str);
         if (isNum.matches()) {
             return true;
         } else {
             return false;
         }
     }

     /**
      * 功能：判断字符串是否为日期格式
      *
      * @param str
      * @return
      */
     public boolean isDate(String strDate) {
         Pattern pattern = Pattern.compile(
                 "^((\\d{2}(([02468][048])|([13579][26]))[\\-\\/\\s]?((((0?[13578])|(1[02]))[\\-\\/\\s]?((0?[1-9])|([1-2][0-9])|(3[01])))|(((0?[469])|(11))[\\-\\/\\s]?((0?[1-9])|([1-2][0-9])|(30)))|(0?2[\\-\\/\\s]?((0?[1-9])|([1-2][0-9])))))|(\\d{2}(([02468][1235679])|([13579][01345789]))[\\-\\/\\s]?((((0?[13578])|(1[02]))[\\-\\/\\s]?((0?[1-9])|([1-2][0-9])|(3[01])))|(((0?[469])|(11))[\\-\\/\\s]?((0?[1-9])|([1-2][0-9])|(30)))|(0?2[\\-\\/\\s]?((0?[1-9])|(1[0-9])|(2[0-8]))))))(\\s(((0?[0-9])|([1-2][0-3]))\\:([0-5]?[0-9])((\\s)|(\\:([0-5]?[0-9])))))?$");
         Matcher m = pattern.matcher(strDate);
         if (m.matches()) {
             return true;
         } else {
             return false;
         }
     }
 }

2、修改struts.xml

　　　　 <action name="myIdCardValidation" class="com.dx.struts2.myvalidations.MyValidationAction" method="idcardExecute">
            <result>/success.jsp</result>
            <result name="input">/index.jsp</result>
        </action>

3、在src根目录下创建validators.xml，并注册com.dx.strtuts2.validators.IDCardValidator.java到validators.xml中（注册规则参考:xwork-core.jar下com.opensymphony.xwork2.validator.validators包下default.xml文件里的配置信息）

 <?xml version="1.0" encoding="UTF-8"?>
 <!DOCTYPE validators PUBLIC
         "-//Apache Struts//XWork Validator Definition 1.0//EN"
         "http://struts.apache.org/dtds/xwork-validator-definition-1.0.dtd">

 <!-- START SNIPPET: validators-default -->
 <validators>
     <validator name="idcard"
         class="com.dx.strtuts2.validators.IDCardValidator" />
 </validators>

4、添加Action com.dx.struts2.myvalidations.MyValidationAction.java

package com.dx.struts2.myvalidations;

import com.opensymphony.xwork2.ActionSupport;

public class MyValidationAction extends ActionSupport {
    private static final long serialVersionUID = 1L;
    private String idCard;

    public String getIdCard() {
        return idCard;
    }

    public void setIdCard(String idCard) {
        this.idCard = idCard;
    }

    public String idcardExecute() {
        System.out.println("id card execute...");
        return SUCCESS;
    }
}

5、在包com.dx.struts2.myvalidations下添加验证规则文件:MyValidationAction-myIdCardValidation-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="idCard">
        <field-validator type="idcard">
            <message>error id card!!!</message>
        </field-validator>
    </field>
</validators>

6、添加index.jsp页面：

　　<s:debug></s:debug>

    <s:actionerror />
    <s:form action="myIdCardValidation" method="post">
        <s:textfield name="idCard" label="IdCard"></s:textfield>

        <s:submit label="Submit"></s:submit>
    </s:form>

7、验证输入一个错误id card,提交后页面信息

输入一个正确的id card，成功跳转到了success页面。