教育网站建设需求文档网站建设需要些什么

商品分类模块开发笔记

模块功能概述

• 实现分类数据的 增删改查 功能
• 核心难点：
  • 分类的父子级目录结构
  • 递归实现多级分类查找
  • 列表展示顺序控制（从父级向子级递归）

---

接口说明

后台接口

1. 添加分类

• 请求地址: /admin/category/add

• 请求方法: POST

• 参数:

  参数名	类型	说明
  name	String	分类名称（如：新鲜水果）
  type	Int	分类层级（1-3级）
  parentId	Int	父级ID（0表示无父级）
  orderNumber	Int	同级目录排序号

• 示例请求:

{"name": "进口水果","type": 2,"parentId": 1,"orderNumber": 2
}

2. 更新分类

• 请求地址: /admin/category/update
• 请求方法: POST
• 参数:
  • 包含id字段用于指定要修改的分类
  • 其他参数与添加接口相同

3. 删除分类

• 请求地址: /admin/category/delete
• 请求方法: POST
• 参数:

  参数名	类型	说明
  id	Int	分类ID

4. 分类列表（平铺分页）

• 请求地址: /admin/category/list
• 请求方法: GET
• 参数:

  参数名	类型	说明
  pageNumber	Int	当前页码
  pageSize	Int	每页显示条数

---

前台接口

递归分类列表

• 请求地址: /category/list
• 请求方法: GET
• 响应结构:

{"code": 200,"message": "成功","data": [{"id": 1,"name": "新鲜水果","childCategory": [{"id": 2,"name": "进口水果","childCategory": [{"id": 3,"name": "车厘子"}]}]}]
}

---

数据库设计

表名: category

字段名	类型	说明
id	int(11)	主键ID
name	varchar(64)	分类名称
type	int(11)	分类层级（1-3级）
parent_id	int(11)	父级分类ID
order_number	int(11)	排序号
create_time	datetime	创建时间
update_time	datetime	最后更新时间

---

关键实现点

1. 递归查询算法：

   • 通过parent_id字段建立层级关系
   • 使用深度优先搜索实现树形结构构建

2. 排序控制：

   • 同级分类通过order_number字段排序
   • 层级间展示顺序为父级->子级

3. 层级校验：

   • 新增分类时校验层级不超过3级
   • 更新操作时防止循环引用

商品分类模块开发笔记 - 接口实现篇

Controller层实现

1. 创建Controller

@RestController
public class CategoryController {@Autowiredprivate CategoryService categoryService;@Autowiredprivate UserService userService;
}

2. 添加分类接口实现

@PostMapping("/admin/category/add")
@ResponseBody
public ApiRestResponse addCategory(HttpSession session,@RequestBody AddCategoryRequest addCategoryRequest) {// 参数校验if (addCategoryRequest.getName() == null || addCategoryRequest.getType() == null|| addCategoryRequest.getParentId() == null|| addCategoryRequest.getOrderNumber() == null) {return ApiRestResponse.error(ExceptionEnum.PARAM_NOT_NULL);}// 用户登录校验User currentUser = (User) session.getAttribute(UserConstant.LOGIN_USER);if (currentUser == null) {return ApiRestResponse.error(ExceptionEnum.NEED_LOGIN);}// 管理员权限校验boolean isAdmin = userService.checkAdminRole(currentUser);if (!isAdmin) {return ApiRestResponse.error(ExceptionEnum.NEED_ADMIN);}// 创建分类对象Category category = new Category();BeanUtils.copyProperties(addCategoryRequest, category);// 调用Service层return categoryService.addCategory(category);
}

请求参数对象设计

public class AddCategoryRequest {private String name;private Integer type;private Integer parentId;private Integer orderNumber;// Getter & Setter// Lombok @Data 注解可替代
}

校验机制说明

1. 参数校验策略

• 必要性校验：所有必要字段的非空检查
• 安全校验：使用独立Request对象防止额外字段注入
• 层级校验：通过type字段控制分类层级（1-3级）

2. 权限校验流程