当前位置：首页 > news >正文

关于 javax.validation.constraints的详细说明

news 来源：原创 2025/7/4 21:39:17

以下是关于 javax.validation.constraints（现为 Jakarta Bean Validation）的详细说明，涵盖核心注解、使用场景、代码示例及最佳实践：

一、`javax.validation.constraints` 是什么？

作用：提供一组标准注解，用于对 Java Bean 的字段或方法参数进行数据校验（如非空、长度、范围等）。
规范演进：
- Java EE 时期：包名为 javax.validation.constraints。
- Jakarta EE 9+：包名迁移为 jakarta.validation.constraints（需注意依赖兼容性）。

二、核心注解列表及用法

1. 常用注解

注解	校验规则	支持类型
`@NotNull`	值不能为 `null`	任意类型
`@NotBlank`	字符串不能为空或纯空格	`String`
`@NotEmpty`	集合/数组/字符串不能为空（长度 > 0）	`Collection`, `String` 等
`@Size(min, max)`	元素数量或字符串长度在指定范围内	集合、数组、字符串
`@Min(value)`	数值必须 ≥ 指定最小值	数值类型（`int`, `long` 等）
`@Max(value)`	数值必须 ≤ 指定最大值	同上
`@DecimalMin(value)`	数值必须 ≥ 指定最小值（字符串形式，支持精度）	`BigDecimal`, `String` 等
`@DecimalMax(value)`	数值必须 ≤ 指定最大值（字符串形式，支持精度）	同上
`@Digits(integer, fraction)`	数值整数部分最多 `integer` 位，小数部分最多 `fraction` 位	数值类型
`@Pattern(regexp)`	字符串必须匹配正则表达式	`String`
`@Email`	字符串必须是合法邮箱格式	`String`
`@Positive` / `@PositiveOrZero`	数值必须为正数或零	数值类型
`@Negative` / `@NegativeOrZero`	数值必须为负数或零	数值类型
`@Future` / `@FutureOrPresent`	日期必须在未来（或包含当前）	`Date`, `LocalDate` 等
`@Past` / `@PastOrPresent`	日期必须在过去（或包含当前）	同上

2. 注解示例代码

public class User {@NotBlank(message = "用户名不能为空")private String username;@Email(message = "邮箱格式无效")private String email;@Size(min = 6, max = 20, message = "密码长度需在6-20位之间")private String password;@Min(value = 18, message = "年龄必须≥18岁")@Max(value = 100, message = "年龄必须≤100岁")private Integer age;@Pattern(regexp = "^1[3-9]\\d{9}$", message = "手机号格式无效")private String phone;
}

三、集成到 Spring Boot 中的步骤

1. 添加依赖

<!-- Spring Boot 2.x 使用 javax.validation -->
<dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-validation</artifactId>
</dependency><!-- Jakarta EE 9+ 使用 jakarta.validation -->
<dependency><groupId>jakarta.validation</groupId><artifactId>jakarta.validation-api</artifactId><version>3.0.2</version>
</dependency>

2. 在 Controller 中触发校验

使用 @Valid 或 @Validated 注解触发校验：

@PostMapping("/users")
public ResponseEntity<?> createUser(@RequestBody @Valid User user) {// 校验通过后执行业务逻辑return ResponseEntity.ok("用户创建成功");
}

3. 处理校验异常

通过 @ExceptionHandler 捕获 MethodArgumentNotValidException：

@RestControllerAdvice
public class GlobalExceptionHandler {@ExceptionHandler(MethodArgumentNotValidException.class)public ResponseEntity<Map<String, String>> handleValidationException(MethodArgumentNotValidException ex) {Map<String, String> errors = new HashMap<>();ex.getBindingResult().getAllErrors().forEach(error -> {String fieldName = ((FieldError) error).getField();String errorMessage = error.getDefaultMessage();errors.put(fieldName, errorMessage);});return ResponseEntity.badRequest().body(errors);}
}

四、高级用法

1. 分组校验

通过分组接口实现不同场景下的差异化校验：

// 定义分组接口
public interface CreateGroup {}
public interface UpdateGroup {}public class User {@NotNull(groups = UpdateGroup.class)private Long id;@NotBlank(groups = {CreateGroup.class, UpdateGroup.class})private String name;
}// 在 Controller 中指定分组
@PostMapping("/users")
public ResponseEntity<?> createUser(@RequestBody @Validated(CreateGroup.class) User user) { ... }

2. 自定义校验注解

实现自定义校验逻辑（如密码强度校验）：

@Target({FIELD})
@Retention(RUNTIME)
@Constraint(validatedBy = PasswordValidator.class)
public @interface StrongPassword {String message() default "密码必须包含大小写字母和数字";Class<?>[] groups() default {};Class<? extends Payload>[] payload() default {};
}public class PasswordValidator implements ConstraintValidator<StrongPassword, String> {@Overridepublic boolean isValid(String password, ConstraintValidatorContext context) {return password.matches("^(?=.*[a-z])(?=.*[A-Z])(?=.*\\d).+$");}
}

3. 级联校验

校验对象内的嵌套对象：

public class Order {@Validprivate List<@Valid Product> products; // 校验每个 Product 的字段
}

五、校验失败的错误消息定制

1. 默认消息模板

每个注解的 message 属性支持占位符：

@Size(min = 6, max = 20, message = "密码长度需在{min}-{max}位之间")
private String password;

2. 国际化消息

在 messages.properties 或 ValidationMessages.properties 中定义：

user.email.invalid=邮箱格式无效

注解中使用：

@Email(message = "{user.email.invalid}")
private String email;

六、常见问题与解决方案

问题	解决方案
校验未生效	检查是否添加了 `@Valid` 或 `@Validated` 注解；确认依赖已正确引入
嵌套对象校验失败	在嵌套对象字段上添加 `@Valid` 注解
分组校验不生效	在 `@Validated` 注解中明确指定分组接口
自定义校验器未触发	确认 `@Constraint(validatedBy = MyValidator.class)` 并实现 `ConstraintValidator`

七、总结

核心价值：通过声明式注解简化数据校验逻辑，减少样板代码。
最佳实践：
- 优先使用标准注解，避免重复造轮子。
- 结合分组校验实现多场景复用。
- 统一处理校验异常，返回清晰的错误信息。
扩展性：通过自定义注解和校验器满足复杂业务需求。

关于 javax.validation.constraints的详细说明

以下是关于 javax.validation.constraints（现为 Jakarta Bean Validation）的详细说明，涵盖核心注解、使用场景、代码示例及最佳实践： 一、javax.validation.constraints 是什么？ 作用：提供一组标准注…...

编程日记 2025/7/4 21:39:17

linux系统如何将采集的串口数据存储到txt

步骤： 确认串口设备：通常为/dev/ttyS0（COM1）或/dev/ttyUSB0（USB转串口）。设置波特率等参数：使用stty命令，例如： bash stty -F /dev/ttyUSB0 9600 cs8 -icanon -ixon 实时…...

编程日记 2025/7/4 21:13:53

(顺序表、单链表、双链表)==＞一篇解决!(Java版)

文章目录一、线性表二、顺序表三、单链表四、双链表一、线性表线性表是最基本、最简单、也是最常用的一种数据结构。一个线性表是n个具有相同特性的数据元素的有限序列。线性表的特征：数据元素之间具有一种“一对一”的逻辑关系。线性表的分类： 线…...

编程日记 2025/7/4 20:32:10

大模型常用位置编码方式

深度学习中常见的位置编码方式及其Python实现： 一、固定位置编码（Sinusoidal Positional Encoding） 原理通过不同频率的正弦和余弦函数生成位置编码，使模型能够捕捉绝对位置和相对位置信息。公式为： 公式标准数学表达…...

编程日记 2025/7/4 20:11:45

【fastadmin开发实战】在前端页面中使用bootstraptable以及表格中实现文件上传

先看效果： 1、前端页面中引入了表格 2、表格中实现文件上传 3、增加截止时间页面难点在哪呢？ 1、这是前端页面，并不支持直接使用btn-dialog的类属性实现弹窗； 2、前端页面一般绑定了layout模板，如何实现某个页面不…...

编程日记 2025/6/28 23:29:38

IO、存储、硬盘、文件系统相关常识

目录 1. IO（输入输出）基础概念 1.1 IO的定义 1.2 流 1.3 IO流 2.存储 2.1 存储技术 2.2 存储介质的分类（机械硬盘、固态硬盘、光盘、磁带） 2.2.1 机械硬盘 2.2.2 固态硬盘 2.2.3 光盘 2.2.4 磁盘 2.3 存储管理 2.4 存…...

编程日记 2025/7/4 20:49:16

修改本机使用镜像仓库地址 vim /etc/docker/daemon.json { “experimental”: true, “registry-mirrors”: [ “https://docker.m.daocloud.io”, “https://docker.1panel.live”, “http://mirrors.ustc.edu.cn/”, “http://mirror.azure.cn/”, “https://docker.hpcloud.…...

编程日记 2025/7/4 21:25:50

日志链路ID配置，traceId多线程不打印什么鬼？

logback.xml 关键配置 [traceId:%X{traceId}] <property name"log.pattern.color"value"%green(%d{yyyy-MM-dd HH:mm:ss.SSS}) [%thread] %highlight(%-5level){FATALred, ERRORred, WARNyellow, INFOgreen, DEBUGcyan, TRA…...

编程日记 2025/7/4 21:23:37

InfluxDB-数据看板实现流程：从数据采集到可视化展示

数据看板的实现涉及到多个步骤和技术组件，以下是基于提供的知识库内容，详细解释数据看板（特别是30日活跃用户数趋势）的实现过程： 1. 数据来源所有用户行为数据通过网关进行数据埋点，并通过消息队列&…...

编程日记 2025/7/4 20:49:17

Git基本操作命令

文章目录 Git基本操作命令创建仓库命令提交与修改提交日志版本回退分支切换删除文件.gitignore文件远程操作 Git分支管理创建分支查看分支合并分支删除分支保存当前文件未提交更改并切换分支 Git提交历史恢复和回退 Git标签标签推送删除标签附注标签查看标签信息删除标签 Git基…...

编程日记 2025/6/29 0:34:07

JavaScript实践（三）JavaScript序列化与反序列化深度解析

JavaScript中的序列化与反序列化是数据存储、网络传输和跨系统交互的核心技术之一。本文将从底层原理、核心方法、复杂场景处理、安全风险及工程实践等多个维度，系统性地解析这一技术体系，并附完整的代码实现示例。一、序列化与反序列化的核心价值序列…...

编程日记 2025/7/4 21:22:07

大模型—— FastGPT 知识库无缝集成到 n8n 工作流 (基于 MCP 协议)

大模型—— FastGPT 知识库无缝集成到 n8n 工作流 (基于 MCP 协议) 背景：n8n 与 RAG 知识库集成的挑战 n8n 作为一款强大的开源自动化工作流工具，正获得越来越多用户的青睐。它由前《加勒比海盗》视觉设计师 Jan Oberhauser 于 2019 年创立，旨在提供比 Zapier 等工具更灵活…...

编程日记 2025/6/28 23:00:10

安卓刷机模式详解：Fastboot、Fastbootd、9008与MTK深刷

安卓刷机模式详解：Fastboot、Fastbootd、9008与MTK深刷一、刷机模式对比 1. Fastboot模式简介：传统安卓底层刷机模式，通过USB连接电脑操作优点：支持大多数安卓设备，操作相对简单缺点：需要设备进入特定…...

编程日记 2025/6/29 0:36:40

深入浅出MySQL 8.0：新特性与最佳实践

MySQL作为开源关系型数据库的佼佼者，近年来持续更新迭代，尤其是在8.0版本中引入了一系列令人兴奋的新特性。本文将介绍一些MySQL 8.0的关键新功能，并提供最佳实践，旨在帮助开发人员和DBA更好地利用这一强大的数据库管理系统。一…...

编程日记 2025/6/28 23:00:01

【登录认证】JWT令牌

一、概述 JWT全称:**JSON Web Token **(https://jwt.io/)定义了一种简洁的、自包含的格式，用于通信双方以json数据格式安全的传输信息。组成: ①第一部分:Header(头)，记录令牌类型、签名算法等。例如: (“alg”:" HS256"," type":“…...

编程日记 2025/6/29 0:04:00

coco数据集mAP评估

0 coco数据集划分说明 1 用yolo自带的评估 from ultralytics import YOLOmodel YOLO("../spatial-perception/checkpoints/yolo11n.pt")metrics model.val(data"./coco.yaml", save_jsonTrue) ## save_json为True,可以把预测结果存成json文件&#xff…...

编程日记 2025/6/28 22:59:48

C++23 ranges::range_adaptor_closure：程序定义的范围适配器闭包的辅助类

文章目录一、背景介绍二、ranges::range_adaptor_closure 的定义与要求三、使用示例四、编译器支持情况五、总结一、背景介绍 C23 引入了 std::ranges::range_adaptor_closure，这是一个辅助类模板，用于定义用户自定义的范围适配器闭包对象。这一特性主…...

编程日记 2025/6/28 23:00:21

滑动窗口——水果成篮

根据题意我们转化一下，在数组中求一个最长的子数组，数组中的数字种类不超过2种。借助暴力思想，我们定义双指针进行进窗口、判断、出窗口、更新结果的流程。我们需要借助hash表来记录不同数字出现的种类以及每个数字出现的次数。然后先让r…...

编程日记 2025/6/29 0:20:07

论文精读：YOLO-UniOW: Efficient Universal Open-World Object Detection

文章目录前言1、出发点2、方法2.1.符号说明2.2.Efficient Adaptive Decision Learning2.3.Open-World Wildcard Learning 3、实验结果总结前言本文介绍一篇来自Tencent的开放词汇和世界检测结合的论文：Yolo-uniow，开源地址。 1、出发点本篇论文相当…...

编程日记 2025/6/29 0:46:31

网络协议分析实验四 ICMPv4与ICMPv6

文章目录实验4.1 ICMP协议练习一利用仿真编辑器编辑ICMP回显请求报文练习二 ICMP差错报文1.目的端不可达2.超时练习三仿真发送ICMP时间戳请求报文实验4.2 IPV6与ICMPV6实验设计题：设计一个能产生ICMPV6超时类型差错报文实验，并截图记录实验结果。实…...

编程日记 2025/6/28 23:52:13

《100天精通Python——基础篇 2025 第18天：正则表达式入门实战，解锁字符串处理的魔法力量》

目录一、认识正则表达式二、正则表达式基本语法2.1 行界定符2.2 单词定界符2.3 字符类2.4 选择符2.5 范围符2.6 排除符2.7 限定符2.8 任意字符2.9 转义字符2.10 反斜杠2.11 小括号2.11.1 定义独立单元2.11.2 分组 2.12 反向引用2.13 特殊构造2.14 匹配模式三、re模块3.1 comp…...

编程日记 2025/6/28 23:00:24

nginx配置反向代理支持CORS跨域请求

nginx配置反向代理支持CORS跨域请求 1. 环境2. 配置Nginx反向代理和CORS添加的响应头包括： 1. 环境后端springboot,项目端口8080前端vue,项目端口8088 2. 配置Nginx反向代理和CORS server {listen 8088;server_name your_domain.com;location / {root /path/to/…...

编程日记 2025/6/28 22:59:47

英语学习5.13

take the place of 【短语】 👉 关键词：代替、取代、顶替 ✅ 释义： 代替，取代某人或某物的位置或作用指一个人或事物代替另一个人或事物，履行相同的职责、功能或占据原有的位置。 ✅ 例句： Nothing c…...

编程日记 2025/6/28 23:00:35

NY182NY183美光固态颗粒NY186NY188

NY182NY183美光固态颗粒NY186NY188 在存储技术的竞技场上，美光科技（Micron）始终扮演着革新者的角色。其NY系列固态颗粒凭借前沿的3D NAND架构和精准的工艺控制，成为企业级存储和数据中心的关键支柱。本文将围绕NY182、NY183、NY1…...

编程日记 2025/6/28 23:00:00

数据库--处理模型（Processing Model）

本文将介绍数据库处理模型，处理模型定义了系统如何执行一个查询计划。三种处理模型：迭代器模型、物化模型、向量化模型。向量化模型是现代OLAP系统所使用的处理模型，它结合了迭代器模型和物化模型的优点。另外还介绍了查询执行的两种方向：自顶向下（Pull模式），自底向…...

编程日记 2025/6/29 1:07:04

TikTok矩阵运营干货：从0到1打造爆款矩阵

在TikTok的流量浪潮中，运营TikTok矩阵是提升影响力、扩大受众群体的有效策略。无论是品牌推广还是个人IP打造，一个成功的TikTok矩阵都能带来意想不到的收获。下面就为大家分享一些TikTok矩阵运营的实用干货。一、为什么要做TikTok矩阵 TikTok矩阵就像是…...

编程日记 2025/6/28 22:59:56

如何访问云相关的api

问题预研访问国外厂商云api相关的代码，发现请求国外厂商云获取token时，发生了下面的错误： com.google.auth.oauth2.GoogleAuthException: Error getting access token for service account: connect timed out, iss: testmanagebucketesot…...

编程日记 2025/6/29 0:10:53

数字IC后端实现教程 | Early Clock Flow和Useful skew完全不是一个东西

数字后端零基础入门系列 | Innovus零基础LAB学习Day10 Q: Early clock flow和useful skew都是做短某段路径，这两个有什么区别呢，既然这样还用useful skew是不是有点多余了? Useful Skew技术在不使用useful skew技术，第一级FF到第二级FF的…...

编程日记 2025/6/28 23:01:09

用AI制作黑神话悟空质感教程，3D西游记裸眼效果，西游人物跳出书本

目录一、前言二、作图步骤1.DeepSeek 生成画面场景2.AI作图3.下载高清无码图一、前言你是否也想打造这种立体效果？让人物仿佛从纸上跃然而出，质感逼真。这里我以西游记为例，大家完全可以根据个人喜好，尝试创作三国、水浒等题材…...

编程日记 2025/6/28 23:44:44

C++模板

C<模板初阶> 这一集讲一下模板, 这东西理解起来不难, 用起来也很简单, 大家顺着看就ok. void Swap(int& left, int& right)//参数是引用 {int temp left;left right;right temp; }void Swap(double& left, double& right) {double temp left;left …...

编程日记 2025/6/28 23:00:20

系统平衡与企业挑战

在复杂的系统中，一切都在寻找平衡，而这个平衡从不静止。它在不断的变化与反馈中调整，以适应外界环境的变动。就像一个企业，它无法完全回避变化，但却总是在挑战中寻找新的平衡点。最近遇到一家企业，引入了…...

编程日记 2025/6/29 0:12:52

【AI News | 20250513】每日AI进展

AI Repos 1、iap-diffusion-labs 从零开始带我们构建完整的扩散模型。通过三个精心设计的实验练习，循序渐进地引导我们实现流匹配和扩散模型，从基础 SDE 到条件图像生成，每一步都有详尽指导和完整代码，让复杂理论简单易懂。主要内…...

编程日记 2025/6/28 22:59:49

upload-labs通关笔记-第3关文件上传之黑名单绕过

目录一、实验准备 1.构造脚本 2.打开靶场第三关 3.源码分析 4.修改配置使支持php后缀 （1）切换php ts版本 （2）定位httpd.conf文件 （3）修改AddType application字段 （4）重启…...

编程日记 2025/6/28 23:00:14

【Redis】RedLock实现原理

Redis的RedLock是一种分布式锁算法，旨在通过多节点协作解决传统单节点Redis锁的容错性问题。其核心原理如下： 1. 设计目标互斥性：同一时刻只有一个客户端持有锁。死锁避免：锁自动超时释放，防止客户端崩溃导致死锁。容…...

编程日记 2025/6/28 23:00:29

IPD流程实战：产品开发各阶段目标、关注点和交付

目录简介 1、概念阶段 2、计划阶段 3、开发阶段 4、验证阶段 5、发布阶段 6、生命周期阶段作者简介简介 IPD的产品开发是一个多阶段协同的过程，上一个环节的输出是下一个环节的输入，每个阶段的交替都体现出了用户思维。尽可能确保最终的输…...

编程日记 2025/6/28 23:00:11

植物大战僵尸杂交版v3.6最新版本（附下载链接）

B站游戏作者潜艇伟伟迷于5月13日更新了植物大战僵尸杂交版3.6.5版本！！！，有b站账户的记得要给作者三连关注一下呀！ 不多废话下载链接放上： 夸克网盘链接：：https://pan.quark.cn/s/037…...

编程日记 2025/6/29 1:20:02

激光打印机常见打印故障简单处理意见

一、问题描述： 给打印机更换新的硒鼓时拉开硒鼓封条时有微量碳粉带出； 原因： 出厂打印测试时，可能会有微量碳粉在磁辊上或者磁辊仓； 解决方法： 擦干净即可正常使用； 二、问题描述&…...

编程日记 2025/6/28 23:11:21

代码随想录算法训练营第60期第三十五天打卡

今天是我们贪心算法章节的最后一天，今天有三道题目需要讲解，但是最后又一道题目叫做监督二叉树的题目难度比较大，我打算二刷代码随想录的时候再来给大家讲解，因此我们今天就只讲解前两道题目，昨天的区间重叠问题是贪心…...

编程日记 2025/6/29 0:12:05

我的五周年创作纪念日

五年前的今天，我在CSDN发布了第一篇《基于VS2015的MFC学习笔记（常用按钮button）》，文末那句"欢迎交流"的忐忑留言，开启了这段充满惊喜的技术旅程。恍然发觉那些敲过的代码早已成长为参天大树。收获获得了…...

编程日记 2025/6/29 1:32:18

OpenCV特征处理全解析：从检测到匹配的完整指南

一、计算机视觉中的特征处理概述在计算机视觉领域，特征处理是指从图像中提取、描述和匹配具有辨识度的局部或全局特征的过程。一个完整的特征处理流程通常包括三个关键步骤： 特征检测：在图像中寻找具有独特性质的点或区域特征描述&#xf…...

编程日记 2025/6/28 23:00:08

C++11 ——右值引用和移动语义

目录一、基本概念左值 vs 右值左值引用 vs 右值引用二、右值引用使用场景和意义左值引用的使用场景左值引用的短板右值引用和移动语义右值引用引用左值右值引用的其他使用场景右值引用总结三、完美转发右值前置知识万能引用完美转发保持值的属性完美转发的使用场景四、总结…...

编程日记 2025/6/29 0:29:33

使用交互式半自动化标注工具制作语义分割数据集

参考的初始资源： GitHub项目文档 B站视频 1.安装工具打开Anaconda Prompt 1.创建虚拟环境 conda create -n isat_env python3.8 conda activate isat_env2.安装GPU版本pytorch 4070 Ti CUDN12.5 pip install torch torchvision torchaudio --index-url https:/…...

编程日记 2025/6/28 23:00:37

阿里二面：聊聊 MySQL 主从同步方案的优缺点

大家好，我是君哥。今天来聊一聊 MySQL 主从架构。 MySQL Replication 是 MySQL 官方提供的主从同步方案，用于将 MySQL 主库的数据同步到从库中，从库可以供应用程序读取数据。 1 简介 Replication 是目前 MySQL 使用最多的灾备方案&#xf…...

编程日记 2025/6/29 0:37:14

YOLO11解决方案之物体模糊探索

概述 Ultralytics提供了一系列的解决方案，利用YOLO11解决现实世界的问题，包括物体计数、模糊处理、热力图、安防系统、速度估计、物体追踪等多个方面的应用。物体模糊是指对图像或视频中的特定检测对象应用模糊处理，这可以利用YOLO11 模型…...

编程日记 2025/6/28 23:01:10

Elecron 相关介绍以及常见的面试问题

一、深入介绍 Electron Electron 是一个由 GitHub 开发和维护的免费开源软件框架，允许开发者使用 Web 技术（HTML、CSS 和 JavaScript）构建桌面应用程序。它将 Chromium 渲染引擎和 Node.js 运行时环境相结合，为开发者提供了一套…...

编程日记 2025/7/1 1:34:33

基于STM32、HAL库的ADAU1701JSTZ音频接口芯片驱动程序设计

一、简介： ADAU1701JSTZ 是 Analog Devices 公司推出的一款高性能、低功耗音频编解码器 (CODEC) 芯片。它专为便携式音频设备设计，集成了麦克风前置放大器、ADC、DAC、耳机放大器等功能模块，支持多种音频接口和采样率，非常适合与 STM32 微控制器配合使用。主要特性： 24…...

编程日记 2025/6/28 23:48:51