spring boot 11 - 技术栈

一、分组校验（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);
}

时间字段自动维护
- 新增时 createTime 和 updateTime 都设置为当前时间
- 更新时仅修改 updateTime 字段，createTime 保持不变