企业官网建设流程全解析

1.二者区别于配合方式

代码对比如下

@RestController @RequestMapping("/api/user") @Validated // 1. 类级别注解：开启整个类的简单参数校验能力 public class UserController { // 简单参数：不需要在参数前加 @Valid，直接生效 @GetMapping("/sendCaptcha") public BaseResponse<String> sendCaptcha( @NotBlank @Email @RequestParam String targetEmail ) { ... } // 对象参数：必须加 @Valid，否则 UserRegisterRequest 内部的 @NotBlank 等注解统统会被忽略！ @PostMapping("/register") public BaseResponse<LoginAndRegisterResponse> register( @Valid @RequestBody UserRegisterRequest userRegisterRequest ) { ... } }

2.常用校验注解

在基于JSR-303 / Jakarta Bean Validation（如spring-boot-starter-validation）做接口参数校验时，除了你前面看到的@NotBlank和@Email，常用校验注解主要分为以下几类：

--字符串判空类（最容易混淆，需特别注意）

-- 字符串格式与长度类

-- 数值与范围限制类

---时间与日期限制类

---布尔值类

💡 生产环境最佳搭配方案

在实际写代码（如 DTO 请求类）时，这些注解经常做组合搭配：

public class UserRegisterRequest { // 1. 非空 + 邮箱格式 @NotBlank(message = "邮箱不能为空") @Email(message = "邮箱格式不正确") private String email; // 2. 非空 + 长度限制 + 正则（要求必须包含字母和数字） @NotBlank(message = "密码不能为空") @Size(min = 8, max = 20, message = "密码长度必须在 8-20 位之间") @Pattern(regexp = "^(?=.*[A-Za-z])(?=.*\\d)[A-Za-z\\d]{8,20}$", message = "密码必须包含字母和数字") private String password; // 3. 嵌套校验对象（如果 DTO 里面还包着另一个实体/DTO，必须加上 @Valid 才会触发深层校验） @NotNull(message = "扩展信息不能为空") @Valid private UserExtInfo extInfo; }