基于 Hibernate validator 扩展框架

210 阅读1分钟

Hibernate Validator Plus


github.com/carpcap/hib…

Hibernate Validator Plus 是基于 Hibernate Validator 的增强工具包,提供了更丰富、实用的校验注解、分组校验机制以及统一的校验工具类,让 Java 对象与请求参数验证更加简洁、高效。

📦 特性:

  • 内置常用校验注解(账号、密码、邮箱、身份证、IPv4 等)
  • 内置多种数据分组校验方案
  • 精简依赖,架构轻量
  • 支持 Spring MVC 自动校验与工具类手动调用

📘 注解说明

目录位置:annotation

注解名称功能说明详细描述
@CAccount账号格式验证默认:字母开头,5–16 字符,允许字母数字下划线
@CPassword密码强度验证默认:字母开头,6–18 位,仅限字母/数字/下划线
@CIdCard身份证号验证默认:适配中国大陆身份证格式
@CPhone手机号验证默认:中国手机号
@CEmail邮箱格式验证RFC 标准校验
@CFile文件校验默认:最大 1 MB;可指定后缀 fileNameSuffix
@CPlateNumber车牌号验证默认:中国车牌
@CIPv4IPv4 验证合法 IPv4 地址格式
@CDateRange日期范围验证min 最小日期、max 最大日期

📂 分组(Groups)

目录位置:groups

分组名称场景说明
@CCreate创建数据校验
@CCreateDef创建 + 默认校验
@CQuery查询数据校验
@CQueryDef查询 + 默认校验
更多请看源码............

🛠 使用示例

示例项目地址:
🔗 github.com/carpcap/hib…

1. Maven 依赖

<dependency>
    <groupId>com.carpcap</groupId>
    <artifactId>hibernate-validator-plus</artifactId>
    <version>1.1.1</version>
</dependency>

根据不同分组来分别校验场景(内置5类分组)

声明分组类别

通过Spring Mvc自动校验

调用提供的工具类进行手动校验 校验失败会抛出ValidationException