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

spring boot 11

news 2026/5/23 7:00:21

一、分组校验（Spring Validation）

1. 核心概念

分组校验是 Spring Validation 提供的功能，用于在不同业务场景（新增 / 更新）下，对同一个实体类执行不同的校验规则，避免重复定义实体类。

2. 分组校验实现步骤

① 定义分组接口

在Category实体类内部定义分组接口（Add、Update）：

java

运行

public class Category { // 新增分组 public interface Add {} // 更新分组 public interface Update {} // 后续字段定义... }

② 给校验注解指定分组

在字段上的校验注解中，通过groups属性指定归属的分组：

java

运行

@Data public class Category { public interface Add {} public interface Update {} // 更新操作必须校验ID非空，新增操作不需要 @NotNull(groups = Update.class, message = "分类ID不能为空") private Integer id; // 新增和更新操作都需要校验分类名称 @NotEmpty(groups = {Add.class, Update.class}, message = "分类名称不能为空") @Pattern(regexp = "^\\S{1,10}$", groups = {Add.class, Update.class}, message = "分类名称长度为1-10位非空字符") private String categoryName; // 新增和更新操作都需要校验分类别名 @NotEmpty(groups = {Add.class, Update.class}, message = "分类别名不能为空") @Pattern(regexp = "^\\S{1,10}$", groups = {Add.class, Update.class}, message = "分类别名长度为1-10位非空字符") private String categoryAlias; private Integer createUser; private LocalDateTime createTime; private LocalDateTime updateTime; }

③ 接口校验时指定分组

在 Controller 接口的@Validated注解中，指定要校验的分组：

java

运行

// 新增接口：校验Add分组的规则 @PostMapping public Result add(@RequestBody @Validated(Category.Add.class) Category category) { categoryService.add(category); return Result.success(); } // 更新接口：校验Update分组的规则 @PutMapping public Result update(@RequestBody @Validated(Category.Update.class) Category category) { categoryService.update(category); return Result.success(); }

3. 关键补充说明

默认分组：如果校验注解没有指定groups属性，默认属于javax.validation.groups.Default分组
分组继承：分组接口可以继承，例如public interface Add extends Default {}，此时Add分组会继承Default分组的所有校验规则

二、文章分类详情接口

1. Controller 层

java

运行

@GetMapping("/detail") public Result<Category> detail(Integer id) { Category category = categoryService.findById(id); return Result.success(category); }

2. Service 层

java

运行

@Override public Category findById(Integer id) { return categoryMapper.findById(id); }

3. Mapper 层（SQL）

java

运行

@Select("select * from category where id = #{id}") Category findById(Integer id);

三、更新文章分类接口

1. Controller 层

java

运行

@PutMapping public Result update(@RequestBody @Validated(Category.Update.class) Category category) { categoryService.update(category); return Result.success(); }

2. Service 层

java

运行

@Override public void update(Category category) { // 设置更新时间 category.setUpdateTime(LocalDateTime.now()); categoryMapper.update(category); }

3. Mapper 层（SQL）

java

运行

@Update("update category set category_name = #{categoryName}, " + "category_alias = #{categoryAlias}, update_time = #{updateTime} " + "where id = #{id}") void update(Category category);

四、关键注意事项

分组校验生效条件
- 实体类中定义了分组接口（Add、Update）
- 校验注解通过groups属性指定了归属分组
- Controller 接口的@Validated注解中指定了要校验的分组

更新接口安全校验

确保更新的分类是当前登录用户创建的，避免越权修改
可以在 Service 层增加校验逻辑：

java

运行

@Override public void update(Category category) { // 从 ThreadLocal 获取当前用户ID Map<String, Object> claims = ThreadLocalUtil.get(); Integer userId = (Integer) claims.get("id"); // 查询原分类信息，校验创建人是否为当前用户 Category oldCategory = categoryMapper.findById(category.getId()); if (!oldCategory.getCreateUser().equals(userId)) { throw new RuntimeException("无权限修改该分类"); } category.setUpdateTime(LocalDateTime.now()); categoryMapper.update(category); }