当前位置 : 主页 > 编程语言 > java >

改进 hibernate-validator,新一代校验框架 validator 使用介绍 0.4

来源:互联网 收集:自由互联 发布时间:2023-03-22
项目介绍 java 开发中,参数校验是非常常见的需求。但是 hibernate-validator 在使用过程中,依然会存在一些问题。 validator 在 hibernate-validator 等校验工具之上,做了一些改进,使其使用更

项目介绍

java 开发中,参数校验是非常常见的需求。但是 hibernate-validator 在使用过程中,依然会存在一些问题。

validator 在 hibernate-validator 等校验工具之上,做了一些改进,使其使用更加便捷优雅,进一步提升工作效率。

图片

变更日志

变更日志

特性

  • 支持 fluent-validation

  • 支持 jsr-303 注解

  • 支持 i18n

  • 支持用户自定义策略

  • 支持用户自定义注解

  • 支持针对属性的校验

  • 支持过程式编程与注解式编程

  • 支持指定校验生效的条件

创作目的

hibernate-validator 无法满足的场景

如今 java 最流行的 hibernate-validator 框架,但是有些场景是无法满足的。

比如:

  • 验证新密码和确认密码是否相同。(同一对象下的不同属性之间关系)

  • 当一个属性值满足某个条件时,才进行其他值的参数校验。

  • 多个属性值,至少有一个不能为 null

  • 其实,在对于多个字段的关联关系处理时,hibernate-validator 就会比较弱。

    本项目结合原有的优点,进行这一点的功能强化。

    validation-api 过于复杂

    validation-api 提供了丰富的特性定义,也同时带来了一个问题。

    实现起来,特别复杂。

    然而我们实际使用中,常常不需要这么复杂的实现。

    validator-api 提供了一套简化很多的 api,便于用户自行实现。

    自定义缺乏灵活性

    hibernate-validator 在使用中,自定义约束实现是基于注解的,针对单个属性校验不够灵活。

    本项目中,将属性校验约束和注解约束区分开,便于复用和拓展。

    过程式编程 vs 注解式编程

    hibernate-validator 核心支持的是注解式编程,基于 bean 的校验。

    一个问题是针对属性校验不灵活,有时候针对 bean 的校验,还是要自己写判断。

    本项目支持 fluent-api 进行过程式编程,同时支持注解式编程。

    尽可能兼顾灵活性与便利性。

    快速开始

    准备工作

    JDK1.7+

    Maven 3.X+

    maven 引入

    <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 工具方法

    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}
    • IResult 方法说明

    返回值实现默认为 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[] 当前字段必须在指定的范围内

    JSR-303 + hibernate-validator 约束注解支持

    序号 注解 说明 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 永远不生效的条件

    使用

    使用起来也不难,下面的效果如下:

  • operType == 'create' 时,name 的校验才会生效。
  • operType != 'create' 时,id 的校验才会生效。
  • 其他使用方式保持不变。

    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 方法

    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());

    IConstraint 对应关系

    注解和常见的接口方法一一对应,所有的约束方法在 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

    注解自定义

    说明

    内置的注解,自然无法满足所有的场景。

    本项目中,约束和条件注解都是支持自定义的。

    约束注解 @Constraint

    所有系统的内置注解都可以作为学习的例子。

    定义注解

    以 @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()); } }

    条件注解 @Condition

    所有系统的内置注解都可以作为学习的例子。

    定义注解

    以 @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

    网友评论