|
|
package com.aurora.controller;
|
|
|
|
|
|
import com.aurora.annotation.OptLog;
|
|
|
import com.aurora.model.dto.CategoryAdminDTO;
|
|
|
import com.aurora.model.dto.CategoryDTO;
|
|
|
import com.aurora.model.dto.CategoryOptionDTO;
|
|
|
import com.aurora.service.CategoryService;
|
|
|
import com.aurora.model.vo.CategoryVO;
|
|
|
import com.aurora.model.vo.ConditionVO;
|
|
|
import com.aurora.model.dto.PageResultDTO;
|
|
|
import com.aurora.model.vo.ResultVO;
|
|
|
import io.swagger.annotations.Api;
|
|
|
import io.swagger.annotations.ApiOperation;
|
|
|
import org.springframework.beans.factory.annotation.Autowired;
|
|
|
import org.springframework.web.bind.annotation.*;
|
|
|
|
|
|
import javax.validation.Valid;
|
|
|
import java.util.List;
|
|
|
|
|
|
import static com.aurora.constant.OptTypeConstant.*;
|
|
|
|
|
|
@Api(tags = "分类模块")
|
|
|
@RestController// 标识本类为RESTful控制器，组合了@Controller和@ResponseBody，所有方法返回值直接序列化为JSON响应
|
|
|
public class CategoryController {
|
|
|
|
|
|
@Autowired
|
|
|
private CategoryService categoryService; //用于处理分类相关的业务逻辑
|
|
|
|
|
|
@ApiOperation("获取所有分类")// Swagger注解描述API功能：获取所有分类（通常用于前台展示）
|
|
|
@GetMapping("/categories/all")
|
|
|
// 返回值ResultVO<List<CategoryDTO>>是统一的响应包装类（用来规范接口返回的格式，比如包含响应状态、提示信息、数据等）
|
|
|
//List<CategoryDTO>是分类数据的列表，CategoryDTO是分类相关的数据传输对象（用来封装分类的信息）
|
|
|
public ResultVO<List<CategoryDTO>> listCategories() {
|
|
|
// 调用Service层方法获取所有分类列表，并用ResultVO包装成成功响应
|
|
|
return ResultVO.ok(categoryService.listCategories());
|
|
|
}
|
|
|
|
|
|
@ApiOperation(value = "查看后台分类列表")// 查看后台分类列表（通常包含分页和查询条件）
|
|
|
@GetMapping("/admin/categories")
|
|
|
// 返回分页结果，包含CategoryAdminDTO列表（可能比前台DTO包含更多管理字段）
|
|
|
public ResultVO<PageResultDTO<CategoryAdminDTO>> listCategoriesAdmin(ConditionVO conditionVO) {
|
|
|
//ConditionVO是条件封装类，用来接收前端传递的查询条件（比如分类名称、分页信息等）
|
|
|
return ResultVO.ok(categoryService.listCategoriesAdmin(conditionVO));
|
|
|
}
|
|
|
|
|
|
@ApiOperation(value = "搜索文章分类")//后台管理的搜索文章分类的接口
|
|
|
@GetMapping("/admin/categories/search")
|
|
|
// 返回CategoryOptionDTO列表，通常用于下拉选择框等场景
|
|
|
//CategoryOptionDTO是适配“选项选择”场景的分类传输对象（比如下拉选择框里的分类选项，通常只封装分类ID和分类名称等）
|
|
|
//List<CategoryOptionDTO>是符合搜索条件的分类选项列表
|
|
|
public ResultVO<List<CategoryOptionDTO>> listCategoriesAdminBySearch(ConditionVO conditionVO) {
|
|
|
return ResultVO.ok(categoryService.listCategoriesBySearch(conditionVO));
|
|
|
}
|
|
|
|
|
|
@OptLog(optType = DELETE)
|
|
|
@ApiOperation(value = "删除分类")
|
|
|
@DeleteMapping("/admin/categories")
|
|
|
// @RequestBody接收前端以JSON格式传递的请求体数据，转换成要删除的分类ID列表，ResultVO<?>表示无具体返回数据，仅返回操作成功的状态提示
|
|
|
public ResultVO<?> deleteCategories(@RequestBody List<Integer> categoryIds) {
|
|
|
categoryService.deleteCategories(categoryIds);
|
|
|
return ResultVO.ok();
|
|
|
}
|
|
|
|
|
|
@OptLog(optType = SAVE_OR_UPDATE)
|
|
|
@ApiOperation(value = "添加或修改分类")
|
|
|
@PostMapping("/admin/categories")
|
|
|
public ResultVO<?> saveOrUpdateCategory(@Valid @RequestBody CategoryVO categoryVO) {
|
|
|
// Service层会通过CategorVO中是否包含分类ID等信息，判断是执行添加还是修改操作
|
|
|
categoryService.saveOrUpdateCategory(categoryVO);
|
|
|
return ResultVO.ok();
|
|
|
}
|
|
|
|
|
|
|
|
|
}
|
