- Java锁的逻辑(结合对象头和ObjectMonitor)
- 还在用饼状图?来瞧瞧这些炫酷的百分比可视化新图形(附代码实现)⛵
- 自动注册实体类到EntityFrameworkCore上下文,并适配ABP及ABPVNext
- 基于Sklearn机器学习代码实战
java 开发中,参数校验是非常常见的需求。但是 hibernate-validator 在使用过程中,依然会存在一些问题.
validator 在 hibernate-validator 等校验工具之上,做了一些改进,使其使用更加便捷优雅,进一步提升工作效率.
变更日志 。
支持 fluent-validation 。
支持 jsr-303 注解 。
支持 i18n 。
支持用户自定义策略 。
支持用户自定义注解 。
支持针对属性的校验 。
支持过程式编程与注解式编程 。
支持指定校验生效的条件 。
如今 java 最流行的 hibernate-validator 框架,但是有些场景是无法满足的.
比如:
验证新密码和确认密码是否相同。(同一对象下的不同属性之间关系) 。
当一个属性值满足某个条件时,才进行其他值的参数校验.
多个属性值,至少有一个不能为 null 。
其实,在 对于多个字段的关联关系处理时,hibernate-validator 就会比较弱 .
本项目结合原有的优点,进行这一点的功能强化.
validation-api 提供了丰富的特性定义,也同时带来了一个问题.
实现起来,特别复杂.
然而我们实际使用中,常常不需要这么复杂的实现.
validator-api 提供了一套简化很多的 api,便于用户自行实现.
hibernate-validator 在使用中,自定义约束实现是基于注解的,针对单个属性校验不够灵活.
本项目中, 将属性校验约束和注解约束区分开,便于复用和拓展 .
hibernate-validator 核心支持的是注解式编程,基于 bean 的校验.
一个问题是针对属性校验不灵活,有时候针对 bean 的校验,还是要自己写判断.
本项目支持 fluent-api 进行过程式编程,同时支持注解式编程.
尽可能兼顾灵活性与便利性.
JDK1.7+ 。
Maven 3.X+ 。
<dependency>
<groupId>com.github.houbb</groupId>
<artifactId>validator-core</artifactId>
<version>0.4.0</version>
</dependency>
第一步,我们定义一个常见的 java bean 对象,可以指定内置的注解.
支持 jsr-303 注解和 hibernate-validator 的注解.
public class User {
/**
* 名称
*/
@HasNotNull({"nickName"})
private String name;
/**
* 昵称
*/
private String nickName;
/**
* 原始密码
*/
@AllEquals("password2")
private String password;
/**
* 新密码
*/
private String password2;
/**
* 性别
*/
@Ranges({"boy", "girl"})
private String sex;
/**
* 失败类型枚举
*/
@EnumRanges(FailTypeEnum.class)
private String failType;
//getter & setter
}
ValidHelper 作为统一封装的工具类,提供了 java bean 校验常见的方法.
方法列表:
序号 | 方法 | 返回值 | 说明 |
---|---|---|---|
1 | failOver(Object object) | IResult | 全部验证后返回 |
2 | failFast(Object object) | IResult | 快速验证后返回 |
3 | failOverThrow(Object object) | void | 全部验证后返回-未通过抛出 ValidRuntimeException 异常 |
4 | failFastThrow(Object object) | void | 快速验证后返回-未通过抛出 ValidRuntimeException 异常 |
使用起来很简单,我们以 failFast 为例:
// 对象定义
User user = new User();
user.sex("what").password("old").password2("new");
// 调用方法
IResult result = ValidHelper.failFast(user);
结果:
DefaultResult{pass=false, notPassList=[DefaultConstraintResult{pass=false, message='name: 值 <null> 不是预期值', value=null, constraint='HasNotNullConstraint', expectValue='', fieldName='name'}], allList=null}
返回值实现默认为 DefaultResult,接口 IResult 属性如下:
public interface IResult {
/**
* 是否全部通过验证
* @return 是否
* @since 0.1.0
*/
boolean pass();
/**
* 未通过的列表信息
* @return 验证结果
* @since 0.1.0
*/
List<IConstraintResult> notPassList();
/**
* 所有的验证结果列表
* @return 所有的验证结果
* @since 0.1.0
*/
List<IConstraintResult> allList();
/**
* 输出信息到控台
* (1)主要是为了方便调整
* (2)该功能其实可以做增强,比如输出到文件/数据库等等。
* @return this
* @since 0.0.6
*/
IResult print();
/**
* 对于未通过的信息,
* (1)未通过的界定。
* {@link IConstraintResult#pass()} 为 false
*
* (2)内容信息
* 抛出运行时异常 {@link com.github.houbb.validator.api.exception.ValidRuntimeException},异常信息为 {@link IConstraintResult#message()} 消息
* (3)内容限定
* 为了避免异常内容过多,只抛出第一条即可。
* (4)改方法的增强空间
* 4.1 可以指定什么情况下抛出异常
* 4.2 抛出异常的信息和类别
*
* @return this
* @since 0.0.6
*/
IResult throwsEx();
}
java bean 的校验,基于注解是比较方便的。和 hibernate-validator 使用类似,这里介绍下常见的注解.
内置注解如下:
序号 | 注解 | value() | 说明 |
---|---|---|---|
1 | @AllEquals |
String[] |
当前字段及其指定的字段 全部相等 |
2 | @EnumRanges |
Class<? extends Enum> |
当前字段必须在枚举值指定的范围内 |
3 | @HasNotNull |
String[] |
当前字段及其指定的字段 至少有一个不为 null |
4 | @Ranges |
String[] |
当前字段必须在指定的范围内 |
序号 | 注解 | 说明 |
---|---|---|
1 | @AssertTrue |
为 true 约束条件 |
2 | @AssertFalse |
为 false 约束条件 |
3 | @Null |
为 null 约束条件 |
4 | @NotNull |
不为 null 约束条件 |
5 | @Past |
是否在当前时间之前约束条件 |
6 | @Future |
是否在当前时间之后约束条件 |
7 | @Pattern |
正则表达式约束条件 |
8 | @Size |
在指定范围内的约束条件 |
9 | @Digits |
数字位数的约束条件 |
10 | @DecimalMax |
最大数字的约束条件 |
11 | @DecimalMin |
最小数字的约束条件 |
12 | @Min |
最小的约束条件 |
13 | @Max |
最大的约束条件 |
13 | @NotBlank |
不能为空格的约束条件 |
14 | @NotEmpty |
不能为空的约束条件 |
15 | @Length |
长度的约束条件 |
16 | @CNPJ |
CNPJ 约束条件 |
17 | @CPF |
CPF 约束条件 |
18 | @URL |
URL 约束条件 |
18 | @Email |
Email 约束条件 |
19 | @UniqueElements |
元素唯一约束条件 |
20 | @Range |
指定范围元素约束条件 |
有时候我们需要根据不同的参数,进行不同的限制条件.
比如新建时用户 id 不需要传入,但是修改时 id 必填.
如果是传统的 hibernate-validator 处理就会比较麻烦,此处引入条件注解.
序号 | 注解 | 说明 |
---|---|---|
1 | @EqualsCondition |
等于指定值的条件 |
2 | @NotEqualsCondition |
不等于指定值的条件 |
3 | @AlwaysTrueCondition |
永远生效的条件 |
4 | @AlwaysFalseCondition |
永远不生效的条件 |
使用起来也不难,下面的效果如下:
其他使用方式保持不变.
public class ConditionUser {
/**
* 操作类型
*/
@Ranges({"create", "edit"})
private String operType;
/**
* 新建时,name 必填
*/
@EqualsCondition(value = "create", fieldName = "operType")
@Size(min = 3)
@NotNull
private String name;
/**
* 不是新建时, id 字段必填
*/
@NotEqualsCondition(value = "create", fieldName = "operType")
@Size(min = 16)
private String id;
//getter & setter
}
日常开发中,我们都很喜欢使用注解对 java bean 进行校验.
但是这回导致我们定义的单个属性校验无法复用.
所以项目中的单个属性校验和注解是一一对应的,为了便于复用.
ValidHelper 作为统一封装的工具类,提供单个方法校验常见的方法.
和 java bean 类似,方法列表:
序号 | 方法 | 返回值 | 说明 |
---|---|---|---|
1 | failOver(Object object, IConstraint constraint) | IResult | 全部验证后返回 |
2 | failFast(Object object, IConstraint constraint) | IResult | 快速验证后返回 |
3 | failOverThrow(Object object, IConstraint constraint) | void | 全部验证后返回-未通过抛出 ValidRuntimeException 异常 |
4 | failFastThrow(Object object, IConstraint constraint) | void | 快速验证后返回-未通过抛出 ValidRuntimeException 异常 |
用法和 bean 的类似,只是入参多了第二个约束条件.
IResult result = ValidHelper.failFast("", Constraints.notEmptyConstraint());
注解和常见的接口方法一一对应,所有的约束方法在 Constraints 工具类中.
序号 | 注解 | 说明 | 对应方法 |
---|---|---|---|
1 | @AssertTrue |
为 true 约束条件 | assertTrueConstraint |
2 | @AssertFalse |
为 false 约束条件 | assertFalseConstraint |
3 | @Null |
为 null 约束条件 | nullConstraint |
4 | @NotNull |
不为 null 约束条件 | notNullConstraint |
5 | @Past |
是否在当前时间之前约束条件 | pastConstraint |
6 | @Future |
是否在当前时间之后约束条件 | futureConstraint |
7 | @Pattern |
正则表达式约束条件 | patternConstraint |
8 | @Size |
在指定范围内的约束条件 | sizeConstraint |
9 | @Digits |
数字位数的约束条件 | digitsConstraint |
10 | @DecimalMax |
最大数字的约束条件 | decimalMaxConstraint |
11 | @DecimalMin |
最小数字的约束条件 | decimalMinConstraint |
12 | @Min |
最小的约束条件 | minConstraint |
13 | @Max |
最大的约束条件 | maxConstraint |
13 | @NotBlank |
不能为空格的约束条件 | notBlankConstraint |
14 | @NotEmpty |
不能为空的约束条件 | notEmptyConstraint |
15 | @Length |
长度的约束条件 | lengthConstraint |
16 | @CNPJ |
CNPJ 约束条件 | cnpjConstraint |
17 | @CPF |
CPF 约束条件 | cpfConstraint |
18 | @URL |
URL 约束条件 | urlConstraint |
18 | @Email |
Email 约束条件 | emailConstraint |
19 | @UniqueElements |
元素唯一约束条件 | uniqueElementsConstraint |
20 | @Range |
指定范围元素约束条件 | rangeConstraint |
21 | @AllEquals |
当前字段及其指定的字段 全部相等 | allEqualsConstraint |
22 | @EnumRanges |
当前字段必须在枚举值指定的范围内 | enumRangesConstraint |
23 | @HasNotNull |
当前字段及其指定的字段 至少有一个不为 null | hasNotNullConstraint |
24 | @Ranges |
当前字段必须在指定的范围内 | rangesConstraint |
注解和常见的接口方法一一对应,所有的约束方法在 Conditions 工具类中.
序号 | 注解 | 说明 | 对应方法 |
---|---|---|---|
1 | @EqualsCondition |
等于指定值的条件 | equalsCondition |
2 | @NotEqualsCondition |
不等于指定值的条件 | notEqualsCondition |
3 | @AlwaysTrueCondition |
永远生效的条件 | alwaysTrueCondition |
4 | @AlwaysFalseCondition |
永远不生效的条件 | alwaysFalseCondition |
内置的注解,自然无法满足所有的场景.
本项目中,约束和条件注解都是支持自定义的.
所有系统的内置注解都可以作为学习的例子.
以 @AllEquals 为例,核心的部分在 @Constraint(AtAllEqualsConstraint.class) .
我们在 AtAllEqualsConstraint 中实现具体的约束逻辑.
@Target(ElementType.FIELD)
@Retention(RetentionPolicy.RUNTIME)
@Constraint(AtAllEqualsConstraint.class)
public @interface AllEquals {
/**
* 当前字段及其指定的字段 全部相等
* 1. 字段类型及其他字段相同
* @return 指定的字段列表
*/
String[] value();
/**
* 提示消息
* @return 错误提示
*/
String message() default "";
/**
* 分组信息
* @return 分组类
* @since 0.1.2
*/
Class[] group() default {};
}
推荐直接继承 AbstractAnnotationConstraint<A> ,实现对应的逻辑即可.
public class AtAllEqualsConstraint extends AbstractAnnotationConstraint<AllEquals> {
@Override
protected IConstraint buildConstraint(AllEquals annotation) {
return Constraints.allEqualsConstraint(annotation.value());
}
}
所有系统的内置注解都可以作为学习的例子.
以 @AlwaysTrueCondition 为例,核心的部分在 @Condition(AtAlwaysTrueCondition.class) .
我们在 AtAlwaysTrueCondition 中实现具体的约束逻辑.
@Target(ElementType.FIELD)
@Retention(RetentionPolicy.RUNTIME)
@Condition(AtAlwaysTrueCondition.class)
public @interface AlwaysTrueCondition {
}
推荐直接继承 AbstractAnnotationCondition<A> ,实现对应的逻辑即可.
public class AtAlwaysTrueCondition extends AbstractAnnotationCondition<AlwaysTrueCondition> {
@Override
protected ICondition buildCondition(AlwaysTrueCondition annotation) {
return Conditions.alwaysTrueCondition();
}
}
为了便于大家学习使用,目前校验框架已开源.
欢迎大家 fork+star,鼓励一下老马~ 。
validator 。
最后此篇关于改进hibernate-validator,新一代校验框架validator使用介绍v0.4的文章就讲到这里了,如果你想了解更多关于改进hibernate-validator,新一代校验框架validator使用介绍v0.4的内容请搜索CFSDN的文章或继续浏览相关文章,希望大家以后支持我的博客! 。
晚上在 QQ 上看到昵称为“乱码”的好友回答了搜搜问问里一个问题: 在VBS中有办法定义字节数组么? 在VBS中有办法定义字节数组么?就是字节子类型数组(VarType是8209的那种)注意不是V
例如,员工管理应用程序可能包括一个EmPloyee 类。然后可以用这个类来创建和维护特定实例,比如Gonn和Sally。 根据预定义的类创建对象常称为类的实例化(class insta
在自然语言中,我们理解抽象的概念是,一个物体的一种大的描述,这种描述对某类物体来说是共有的特性。那么在PHP中也是一样的,我们把一个类进行抽象,可以指明类的一般行为,这个类应该是一个模板,它指示它的
DBA_2PC_PENDING Oracle会自动处理分布事务,保证分布事务的一致性,所有站点全部提交或全部回滚。一般情况下,处理过程在很短的时间内完成,根本无法察觉到。但是,如果在commit或
目录 计算过程 投影分量计算 假设你有一家理发店,已经记录了过去一年中所有顾客的头发长度和发型偏好的数据。现在你想从这些数据中提取一些主要的信息,比如顾客最常
Object.defineProperty函数会直接在一个对象上定义一个新的属性,或者修改一个对象的现有属性,并返回此对象。 一、简单使用 const obj = {} Object.defineP
SPL官网 http://www.scudata.com.cn/ 介绍 业务逻辑经常包含较复杂的流程和计算,同时涉及数据库的读写。由于授权麻烦、影响数据库安全、无法迁移、技术要求高、编写困难等原因,很
SPL官网 http://www.scudata.com.cn/ 介绍 业务逻辑经常包含较复杂的流程和计算,同时涉及数据库的读写。由于授权麻烦、影响数据库安全、无法迁移、技术要求高、编写困难等原因,很
一 点睛 Thrift 是一歀基于 CS 架构的 RPC 框架,最初由 Facebook 研发,2008 年转入 Apache 组织。开发人员可以使用 Thrift 提供的 IDL(接口定义语言)来定
数据库应用程序与主应用程序分开存在,并存储数据集合。 每个数据库都使用一个或多个API来创建,访问,管理,搜索和复制其包含的数据。 数据库还使用非关系数据源,例如对象或文件。 然而,数据库证明是大数
介绍 Ant是一个 Apache 基金会下的跨平台的基于 Java 语言开发的构件工具。在我们详细了解 Apache Ant 之前, 让我们来讲解为什么构建工具是需要最先了解的。 构建工具的需求
我现在正在尝试学习ocaml,并希望从一个小程序开始,生成所有位组合: [“0”,“0”,“0”] [“0”,“0”,“1”] [“0”,“1”,“0”] ... 等等 我的想法是下面的代码: let
我正在做我的介绍 C 类(class)作业,我的任务是执行以下任务...... 为一个函数编写代码,该函数通过值接收两个参数(a 和 b)并通过引用具有另外两个参数(c 和 d)。所有参数都是双倍的。
我希望提供有关我网站内容的快速演示,以及如何在用户访问我的页面后立即以正确的方式使用它们。我希望使用顶部的弹出式窗口进行演示。 我的意思是小信息框,一个接一个地通知用户各个步骤。任何人都可以帮助我如何
与C、Java等语言一样,JavaScript中可以用&&、||、!三个逻辑判断符来对boolean值进行逻辑判断。与C、Java不同的是,JavaScript中逻辑与(&&
JavaScript中,==与===操作符均可用于判断两个值是否相等;不同之处在于,如果进行判断的两个值类型不一致,===操作符会直接返回false,而==操作符则会在类型转换后再进行判断。详细的判
JavaScript中,object转换为boolean的操作非常简单:所有的object转换成boolean后均为true;即使是new Boolean(false)这样的object在转换为bo
在android开发中,当不满足触发条件就按返回键的时候,就要对此进行检测。尤其是当前Activity需要往前一个Activity传送消息时。即Activity1跳转到Activity3如果采用的是
背景 当要求系统启动一个应用程序时,系统会先查找当前命令是否是内部命令,若不是,则在当前目录下查找,如果仍没有找到,则在系统变量 Path 指定的路径去查找。JDK(Java Developmen
概述 想做一个微信的公众平台,阅读了微信官方给的网址接入的示例代码,发现有个问题好像一直都是半知半解的,就是在类里边直接使用$_GET。仔细查了下关于这方面的知识,发现PHP中这部分的基础知识掌握
我是一名优秀的程序员,十分优秀!