这组笔记把课程 03 拆成可以跟着做、能够自查结果的练习。目标是理解一个 Java 后端从接收请求到保存数据的过程,并能自己解释失败原因。先读业务规则,再操作;不要把全部代码一次粘贴完就算学会。
当前进度与阅读方式
截至 2026-10-31,数据库、登录权限、取消、接单、完成已实现,历史测试和部分手工验证有记录。分页、统一错误响应与新增测试还需要本轮运行验证。前端按最新要求暂停;已有草稿不是交付验收依据。打包与新环境部署尚未验收。
代码位于 C:\xixl-study\java-labs\ticket-api。笔记在项目 docs 与 C:\obsidian-md\java快速转岗 各保留一份,使用复制同步。阅读顺序如下,每学完一模块至少提交一项可检查的结果。
| 模块 | 学完能做什么 | 应交出的结果 |
|---|---|---|
| [[03-01-Java项目结构与请求流程]] | 找到请求经过的代码,解释依赖注入 | 从 POST 跟到 INSERT 的调用链 |
| [[03-02-MySQL表结构与SQL练习]] | 看懂两张表,执行查询和条件更新 | 表结构及一次受影响行数记录 |
| [[03-03-MyBatis与环境配置]] | 配置 Java 连接数据库,解释字段映射 | 创建后重启仍查得到的证据 |
| [[03-04-登录权限与Session练习]] | 区分登录、角色、数据归属和 CSRF | 两账号隔离及错误状态码 |
| [[03-05-取消工单与事务回滚详解]] | 解释更新和事件为什么一起提交 | 失败后状态、事件都没改变 |
| [[03-06-接单并发与完成流程详解]] | 解释只有一人接单成功 | 并发结果与唯一 CLAIM 事件 |
| [[03-07-分页查询与统一错误响应]] | 查询分页并理解失败结构 | 分页边界、权限、requestId 检查 |
| [[03-08-测试排错与部署操作手册]] | 看测试报告,按步骤启停与部署 | 新报告、配置清单、部署记录 |
| [[03-09-授课提纲与课后练习]] | 独立讲解并完成改错练习 | 口述、代码定位和练习答案 |
| [[03-交接记录与明日检查清单]] | 知道明天先检查什么 | 逐项填写真实验收结果 |
操作地图:先弄清在哪个窗口执行
| 工具 | 用途 | 示例 | 不能替代什么 |
|---|---|---|---|
| IDE / 代码编辑器 | 修改 Java、XML、配置、测试 | TicketService.java | 保存文件不等于重新运行服务 |
| PowerShell A | 设置环境、运行测试或启动 Java | .\mvnw.cmd spring-boot:run | 启动成功不代表所有接口成功 |
| PowerShell B | 调用接口、运行验证脚本 | .\scripts\Test-TicketClaim.ps1 | HTTP 返回成功仍需核对数据库 |
| DBeaver SQL 编辑器 | 执行 SQL、查看字段与业务记录 | SELECT ... FROM tickets | DBeaver 连接成功不等于 Java 配置成功 |
A 启动服务后一直占用窗口是正常现象。不要为了继续输入命令再启动第二个服务;另开 B。停止时在 A 按 Ctrl+C。环境变量属于各自的终端,A 的设置不会自动出现在 B 或 IDE。
复制命令时只复制代码块内容,不复制 PS C:...>、日志中的 [INFO]、Markdown 星号或多余反斜杠。Wrapper 文件名是 mvnw.cmd,正确命令为 .\mvnw.cmd test。
先背下这个业务边界
OPEN ──接单──> IN_PROGRESS ──完成──> RESOLVED
└──取消──> CANCELLED
USER 创建、查询自己的工单,只能取消自己的 OPEN。AGENT 可以看到未被接走的 OPEN 与分配给自己的工单,只能完成自己负责的 IN_PROGRESS。不能重新打开、转派、批量改状态;当前没有用户表、注册和管理员模块。
登录用户来自 Session,不能靠传 creatorId 或 actorId 冒充。创建接口中的状态由服务端固定为 OPEN。查询返回的 id 是字符串,数据库存储的是 BIGINT,这两者并不矛盾。
每节课的固定学习动作
- 用一句话说出本节解决的问题,例如“服务一重启工单就没了”。
- 找到输入、业务规则、SQL、响应分别在哪个文件。
- 预测正常结果,再预测一个失败结果。
- 按本节步骤操作,保存 HTTP 状态和对应工单编号。
- 用 SQL 核对状态与事件;不要只看页面或控制台文字。
- 写下“为什么”,不是只抄最终代码。
验收记录可以使用:日期 / 当前代码版本或差异 / 环境 / 命令 / 预期 / 实际 / 工单编号 / 结论。编号 34、56、87 是历史练习数据,不是下次必须得到的编号。
原课程和阶段笔记怎么用
[[03 工单项目交付:数据库、权限、事务与部署]] 是总要求。原有“数据库接入操作步骤”等阶段笔记保留当时的演进过程,其中匿名调用、固定创建人等写法不是当前运行方式。当前操作先看本组模块笔记;历史证据看 [[03-项目实施与验收进度]]。
本组以仓库实际 Java、Mapper、测试和用户提供的运行记录为来源。示例输出标注为预期;没有执行的测试不会写成通过。
更多请关注我的微信公众号,感谢!