BigEvent项目后端学习笔记（二）文章分类模块 | 文章分类增删改查全流程解析（含优化）

📖 模块概述

• 文章分类模块包括 新增文章分类、文章分类列表、获取文章分类详情、更新文章分类、删除文章分类 功能。
• 本篇对于原项目进行了代码优化，将原先写在 Controller 层的业务逻辑代码迁移至了 Service 层。

🛠️ 技术实现要点

• 分组校验
  • 定义分组：在实体类内部定义接口
  • 对校验项进行分组：通过 groups 属性指定
  • 校验时指定分组：给 @Validated 注解的 value 属性赋值
  • 校验项默认属于：Default 分组

⚙️ 各层职责与代码规范

🔗 Controller 层

@RestController
@RequiredArgsConstructor
@RequestMapping("/category")
public class CategoryController {...
}

🔗 Service 层

public interface CategoryService {...
}

@Service
@RequiredArgsConstructor
public class CategoryServiceImpl implements CategoryService {...
}

🔗 Mapper 层

@Mapper
public interface CategoryMapper {...
}

🔗 层间交互与依赖注入

@Service
@RequiredArgsConstructor
public class CategoryServiceImpl implements CategoryService {private final CategoryMapper categoryMapper;...
}

@RestController
@RequiredArgsConstructor
@RequestMapping("/category")
public class CategoryController {private final CategoryService categoryService;...
}

🔍 功能实现详解

🎯 新增文章分类

🧩 Controller 层

请求路径：/category
请求方式：POST
接口描述：该接口用于新增文章分类

@PostMapping
public Result addCategory(@RequestBody @Validated(Category.Add.class) Category category) {categoryService.addCategory(category);return Result.success();
}

🧩 Service 层

• 接口

// 新增分类
void addCategory(Category category);// 根据分类名称查询分类信息
Category findCategoryByName(String categoryName);// 根据分类别名查询分类信息
Category findCategoryByAlias(String categoryAlias);

• 实现

/*** 添加分类** @param category 分类对象*/
@Override
public void addCategory(Category category) {// 补充属性值category.setCreateTime(LocalDateTime.now());category.setUpdateTime(LocalDateTime.now());Map<String, Object> map = ThreadLocalUtil.get();Integer userId = (Integer) map.get("id");category.setCreateUser(userId);// 判断分类名称是否已存在Category categoryByName = findCategoryByName(category.getCategoryName());if (categoryByName != null) {throw new RuntimeException("分类名称已存在");}// 判断分类别名是否已存在Category categoryByAlias = findCategoryByAlias(category.getCategoryAlias());if (categoryByAlias != null) {throw new RuntimeException("分类别名已存在");}categoryMapper.addCategory(category);
}/*** 根据分类名称查询分类对象** @param categoryName 分类名称* @return 分类对象*/
@Override
public Category findCategoryByName(String categoryName) {return categoryMapper.findCategoryByName(categoryName);
}/*** 根据分类别名查询分类对象** @param categoryAlias 分类别名* @return 分类对象*/
@Override
public Category findCategoryByAlias(String categoryAlias) {return categoryMapper.findCategoryByAlias(categoryAlias);
}

Mapper 层

// 新增文章分类
@Insert("insert into category(category_name, category_alias, create_user, create_time, update_time) " +"values(#{categoryName}, #{categoryAlias}, #{createUser}, #{createTime}, #{updateTime})")
void addCategory(Category category);// 根据分类名称查询分类
@Select("select * from category where category_name = #{categoryName}")
Category findCategoryByName(String categoryName);// 根据分类别名查询分类
@Select("select * from category where category_alias = #{categoryAlias}")
Category findCategoryByAlias(String categoryAlias);

🎯 文章分类列表

🧩 Controller 层

请求路径：/category
请求方式：GET
接口描述：该接口用于获取当前已登录用户创建的所有文章分类

@GetMapping
public Result<List<Category>> getCategoryList() {List<Category> categoryList = categoryService.getCategoryList();return Result.success(categoryList);
}

🧩 Service 层

• 接口

// 列表查询
List<Category> getCategoryList();

• 实现

/*** 查询分类列表** @return 分类列表*/
@Override
public List<Category> getCategoryList() {Map<String, Object> map = ThreadLocalUtil.get();Integer userId = (Integer) map.get("id");return categoryMapper.getCategoryList(userId);
}

🧩 Mapper 层

// 查询某用户的所有文章分类
@Select("select * from category where create_user = #{userId}")
List<Category> getCategoryList(Integer userId);

🎯 获取文章分类详情

🧩 Controller 层

请求路径：/category/detail
请求方式：GET
接口描述：该接口用于根据ID获取文章分类详情

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

🧩 Service 层

• 接口

// 根据 id 查询分类信息
Category findCategoryById(Integer id);

• 实现

/*** 根据id查询分类对象** @param id 分类id* @return 分类对象*/
@Override
public Category findCategoryById(Integer id) {Category category = categoryMapper.findCategoryById(id);return category;
}

🧩 Mapper 层

// 根据 id 查询文章分类
@Select("select * from category where id = #{id}")
Category findCategoryById(Integer id);

🎯 更新文章分类

🧩 Controller 层

请求路径：/category
请求方式：PUT
接口描述：该接口用于更新文章分类

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

🧩 Service 层

• 接口

// 更新文章分类
void updateCategory(Category category);

• 实现

/*** 修改分类** @param category 分类对象*/
@Override
public void updateCategory(Category category) {category.setUpdateTime(LocalDateTime.now());categoryMapper.updateCategory(category);
}

🧩 Mapper 层

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

🎯 删除文章分类

请求路径：/category
请求方式：DELETE
接口描述：该接口用于根据ID删除文章分类

🧩 Controller 层

@DeleteMapping
public Result deleteCategory(Integer id){categoryService.deleteCategoryById(id);return Result.success();
}

🧩 Service 层

• 接口

// 删除文章分类
void deleteCategoryById(Integer id);

• 实现

/*** 根据id删除分类** @param id 分类id*/
@Override
public void deleteCategoryById(Integer id) {categoryMapper.deleteCategoryById(id);
}

🧩 Mapper 层

@Delete("delete from category where id = #{id}")
void deleteCategoryById(Integer id);