本章节将逐一实现系统的核心功能模块。我们将按照 **登录 -> 仪表盘 -> 分类 -> 商品 -> 客户 -> 订单** 的顺序进行开发。在实现过程中，我们会结合实际场景，适时讲解 **DTO/VO**、**MyBatis-Plus 分页**、**全局时间格式化** 以及 **常用注解** 等核心概念。 --- ## 一、登录模块登录是系统的入口，主要功能是验证用户身份并创建会话。我们首先通过这个模块来熟悉 Controller 的基本写法和常用注解。 ### 1.1 常用注解说明在下面的代码中，你会看到许多“陌生”的注解。为了让你不再困惑，这里整理了最常用的几个： #### 1. Knife4j (接口文档) 注解用于生成在线接口文档 (http://localhost:8080/doc.html)。 * `@Tag(name = "xxx")`: 用在 **Controller 类**上，表示这个类是关于“xxx”模块的（例如：登录模块）。 * `@Operation(summary = "xxx")`: 用在 **方法**上，说明这个接口是干什么的（例如：用户登录）。 * `@Schema(name = "SysUser",description="系统用户信息")`: 用在 **实体类**上，说明这个类是干什么的。 * `@Schema(name = "id",title = "主键",description = "自动生成用户唯一标识")`: 用在 **实体类属性**上，说明这个属性是干什么的。 #### 2. Spring MVC 注解 * `@RestController`: 标记这是一个控制器，并且所有方法返回 JSON 数据。 * `@PostMapping` / `@GetMapping`: 定义 HTTP 请求方式。 * `@RequestBody`: 接收前端传递的 JSON 参数。 ### 1.2 全局配置 (逻辑删除 & 时间格式) 为了简化开发，我们在 `application.yml` 中进行全局配置，解决两个常见问题： 1. **逻辑删除**：MyBatis-Plus 自动处理 `is_deleted` 字段，查询时自动过滤，删除时自动更新。 2. **时间格式化**：Jackson 自动将 `LocalDateTime` 格式化为 `yyyy-MM-dd HH:mm:ss`，无需在每个字段上加注解。 **配置文件 (`application.yml`)**： ```yaml spring: jackson: date-format: yyyy-MM-dd HH:mm:ss time-zone: GMT+8 mybatis-plus: global-config: db-config: logic-delete-field: isDeleted # 全局逻辑删除字段名 logic-delete-value: 1 # 删除状态的值 logic-not-delete-value: 0 # 未删除状态的值 ``` ### 1.3 接口实现 (`LoginController`) ```java @RestController @RequestMapping("/api") @Tag(name = "登录模块") // Knife4j: 模块名称 public class LoginController { @Autowired private SysUserMapper sysUserMapper; @PostMapping("/login") @Operation(summary = "用户登录") // Knife4j: 接口描述 public Result login(@RequestBody SysUser loginUser, HttpSession session) { // 1. 构建查询条件：WHERE username = ? QueryWrapper queryWrapper = new QueryWrapper<>(); queryWrapper.eq("username", loginUser.getUsername()); // 2. 查询数据库 SysUser user = sysUserMapper.selectOne(queryWrapper); // 3. 校验密码 if (user != null && user.getPassword().equals(loginUser.getPassword())) { // 登录成功，将用户信息存入 Session session.setAttribute("user", user); return Result.success("登录成功", user); } return Result.fail(401, "登录失败：用户名或密码错误"); } @GetMapping("/logout") @Operation(summary = "用户登出") public Result

05_进销存系统_功能实现