基于java反射的验证框架_JAVA_编程开发_程序员俱乐部

    <h1>写在前面</h1>相信很多经历了项目的人，会发现几乎没有哪个项目不需要验证的。在经历过多个项目之后，有感于项目中使用最多的验证方式，这里写了一个基于java反射机制的验证框架。该框架适用于对javabean中的属性通过java反射机制获取对应的值和用户直接传入的值来进行各种规则的验证。由于其几乎不依赖任何第三方jar包，因此可以适用所有java项目中。
<h1>开始使用</h1><br>1、由于这些代码是在jdk1.5环境下编写的，用到了jdk1.5中的一些高级特性（如泛型等），因此使用该框架的项目最好是基于jdk1.5及以上版本的。<br>2、使用方式。<br>在这个框架中，整个使用的入口就是一个工具类：com.cloudframework.validation.validatorutils。具体使用示例如下（示例代码在com.cloudframework.validation.sample.demo）：

demoentity de = new demoentity();//demoentity是一个javabean。  // 普通使用  cloudbindingresult result = validatorutils.validateentity(de, "str", notemptyrule.class);  system.out.println(result.getfielderrormessage("str"));  // 自定义验证信息  result = validatorutils.validateentity(de, "str", new notemptyrule("这里是指定验证信息示范！"));  system.out.println(result.getfielderrormessage("str"));  // 同时验证两个属性  result = validatorutils.validateentity(de, "num,date", notnullrule.class);  system.out.println(result.getfielderrormessage("num") + " || " + result.getfielderrormessage("date"));  // 使用多个验证规则  result = validatorutils.validateentity(de, "str", notemptyrule.class, singleemailrule.class);  system.out.println(result.getfielderrormessage("str"));// 这里注意其打印出来的验证信息！  // 多个属性同时使用多个规则  result = validatorutils.validateentity(de, "str,col", notemptyrule.class, singleemailrule.class);  system.out.println(result.getfielderrormessage("str") + " || " + result.getfielderrormessage("col"));

?<br>其运行结果为：

不能为空！这里是指定验证信息示范！不能为空！ || 不能为空！不能为空！；邮箱格式不正确！不能为空！；邮箱格式不正确！ || 不能为空！；邮箱格式不正确！

?<br>3、 需要注意的是，有时候，我们需要验证一个单独的字符串或数字是否符合某个规则，这时候，这样的值并不是javabean中的值，在这样的情况下，validatorutils中的validatevalue方法正是解决这样的单独验证的，它是可以直接验证给定的内容的。示例如下：

// 注意下面方法的返回值，是string类型。system.out.println(validatorutils.validatevalue("hello",notemptyrule.class,singleemail.class)); system.out.println(validatorutils.validatevalue("",notemptyrule.class,singleemail.class)); system.out.println(validatorutils.validatevalue(null,notemptyrule.class,singleemail.class)); system.out.println(validatorutils.validatevalue("hello",notemptyrule.class));

?<br>其运行结果如下：

邮箱格式不正确！不能为空！；邮箱格式不正确！不能为空！；邮箱格式不正确！

?
<h1>自定义规则</h1><br>在上面的使用中，我们用到了这些规则：notemptyrule、notnullrule、singleemailrule。这些规则是我已经在框架中提供的仅有的三种规则！对于业务复杂、规则众多的情况下，用户可以自己扩展这些规则。扩展的方式为：新建一个类，并实现自com.cloudframework.validation.rules.validaterule接口。该接口代码如下：

package com.cloudframework.validation.rules;/** * 验证规则的接口。所有的具体验证规则都实现自这个接口。 *  * @author taofucheng *  */public interface validaterule { /**  * 进行具体规则的验证逻辑。  *   * @param value  *            具体的验证内容。  * @return true：验证通过；false：验证不通过  */ public boolean validate(object value); /**  * 获取验证不通过时的报错信息。如果用户指定的验证信息为空，则返回默认的报错信息。  *   * @return 返回验证的报错信息  */ public string getvalidateinfo();}

?<br>具体实现和规则的使用的示例可以参考现有的这三个规则类（notemptyrule、notnullrule、singleemailrule）。
<h1>设计</h1><br>在整个框架的设计中，其设计思路很简单：调用入口到反射取值，调用规则验证。其uml图可示例如下（使用staruml作图）：<br><img src="/Upload/Images/2011082408/BCC372A1B29BB7D4.jpg" alt="uml图" width="901" height="695">
设计思想与各关系上图中已经详细表明了，这里就不赘述了。
<h1>后记</h1><h2><br>现有的不足</h2><br>字段名称不宜控制。现在的使用方式为：validatorutils.validateentity(entity, "field1", notemptyrule.class)，其中字段名称是用户传入的字符串，如果该实体中的字符串名称发生改变，则这里是无法知晓的！也就是说，这里会因为实体中的字段名称变化而形成一个极隐蔽的隐患！
<h2><br>可扩展为注解</h2>在现在这个年头，注解（annotation）似乎已经很被大众接受，同时也流行开了，从spring到hibernate，再到struts……<br>在注解风靡的现在，如果这个验证框架没有注解使用方式估计会少了一席战场吧。由于本人急于使用，再加上最近也一直很忙，静不下心来完善，所以上面提到的注解功能就一直没写。其实，注解的实现很简单，建议大家可以参考一下hibernate validator框架，我觉得这个验证框架很不错，它是完全基于注解的。我也会在后面的某一天将注解的内容补充完整。
<h2>补充</h2><br>1、?对于验证中的字段名称随实体改变而不会留下隐患，我一直找不到一个好的办法解决。想想除了用注解的方式，还真没找到一个合适的方式。<br>2、?对于注解的使用，我个人认为对于代码的侵入性比较强。我想这也许就是为什么很多人对注解有一定的抵触情绪吧。<br>3、?这个验证框架，只是依赖于commons-lang.jar包，但只用到了其中的stringutils类，如果将该类中用到的功能自己实现的话，可以不依赖于任何jar包了！