基于java反射的验证框架(一)

2014-11-24 02:04:00 · 作者: · 浏览: 0

写在前面

相信很多经历了项目的人,会发现几乎没有哪个项目不需要验证的。在经历过多个项目之后,有感于项目中使用最多的验证方式,这里写了一个基于java反射机制的验证框架。该框架适用于对javabean中的属性通过java反射机制获取对应的值和用户直接传入的值来进行各种规则的验证。由于其几乎不依赖任何第三方jar包,因此可以适用所有java项目中。

开始使用


1、由于这些代码是在jdk1.5环境下编写的,用到了jdk1.5中的一些高级特性(如泛型等),因此使用该框架的项目最好是基于jdk1.5及以上版本的。
2、使用方式。
在这个框架中,整个使用的入口就是一个工具类:com.cloudframework.validation.validatorutils。具体使用示例如下(示例代码在com.cloudframework.validation.sample.demo):
Java代码
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"));

其运行结果为:
Java代码
不能为空!这里是指定验证信息示范!不能为空! || 不能为空!不能为空!;邮箱格式不正确!不能为空!;邮箱格式不正确! || 不能为空!;邮箱格式不正确!

3、 需要注意的是,有时候,我们需要验证一个单独的字符串或数字是否符合某个规则,这时候,这样的值并不是javabean中的值,在这样的情况下,validatorutils中的validateva lue方法正是解决这样的单独验证的,它是可以直接验证给定的内容的。示例如下:
Java代码
// 注意下面方法的返回值,是string类型。system.out.println(validatorutils.validateva lue("hello",notemptyrule.class,singleemail.class)); system.out.println(validatorutils.validateva lue("",notemptyrule.class,singleemail.class)); system.out.println(validatorutils.validateva lue(null,notemptyrule.class,singleemail.class)); system.out.println(validatorutils.validateva lue("hello",notemptyrule.class));

其运行结果如下:
Java代码
邮箱格式不正确!不能为空!;邮箱格式不正确!不能为空!;邮箱格式不正确!

自定义规则


在上面的使用中,我们用到了这些规则:notemptyrule、notnullrule、singleemailrule。这些规则是我已经在框架中提供的仅有的三种规则!对于业务复杂、规则众多的情况下,用户可以自己扩展这些规则。扩展的方式为:新建一个类,并实现自com.cloudframework.validation.rules.validaterule接口。该接口代码如下:
Java代码
package com.cloudframework.validation.rules;/** * 验证规则的接口。所有的具体验证规则都实现自这个接口。 * * @author taofucheng * */public interface validaterule { /** * 进行具体规则的验证逻辑。 * * @param value * 具体的验证内容。 * @return true:验证通过;false:验证不通过 */ public boolean validate(object value); /** * 获取验证不通过时的报错信息。如果用户指定的验证信息为空,则返回默认的报错信息。 * * @return 返回验证的报错信息 */ public string getvalidateinfo();}

具体实现和规则的使用的示例可以参考现有的这三个规则类(notemptyrule、notnullrule、singleemailrule)。

设计


在整个框架的设计中,其设计思路很简单:调用入口到反射取值,调用规则验证。其uml图可示例如下(使用staruml作图):
https://www.cppentry.com/upload_files/article/76/1_eaqwu__.jpg" alt="uml图" width="901" height="695">
设计思想与各关系上图中已经详细表明了,这里就不赘述了。

后记


现有的不足


字段名称不宜控制。现在的使用方式为:validatorutils.validateentity(entity, "field1", notemptyrule.class),其中字段名称是用户传入的字符串,如果该实体中的字符串名称发生改变,则这里是无法知晓的!也就是说,这里会因为实体中的字段名称变化而形成一个极隐蔽的隐患!


可扩展为注解

在现在这个年头,注解(annotation)似乎已经很被大众接受,同时也流行开了,从spring到hibernate,再到struts……
在注解风靡的现在,如果这个验证框架没有注解使用方式估计会少了一席战场吧。由于本人急于使用,再加上最近也一直很忙,静不下心来完善,所以上面提到的注解功能就一直没写。其实,注解的实现很简单,建议大家