03-00-小白上手路线与操作地图

0 阅读5分钟

这组笔记把课程 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.ps1HTTP 返回成功仍需核对数据库
DBeaver SQL 编辑器执行 SQL、查看字段与业务记录SELECT ... FROM ticketsDBeaver 连接成功不等于 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,这两者并不矛盾。

每节课的固定学习动作

  1. 用一句话说出本节解决的问题,例如“服务一重启工单就没了”。
  2. 找到输入、业务规则、SQL、响应分别在哪个文件。
  3. 预测正常结果,再预测一个失败结果。
  4. 按本节步骤操作,保存 HTTP 状态和对应工单编号。
  5. 用 SQL 核对状态与事件;不要只看页面或控制台文字。
  6. 写下“为什么”,不是只抄最终代码。

验收记录可以使用:日期 / 当前代码版本或差异 / 环境 / 命令 / 预期 / 实际 / 工单编号 / 结论。编号 34、56、87 是历史练习数据,不是下次必须得到的编号。

原课程和阶段笔记怎么用

[[03 工单项目交付:数据库、权限、事务与部署]] 是总要求。原有“数据库接入操作步骤”等阶段笔记保留当时的演进过程,其中匿名调用、固定创建人等写法不是当前运行方式。当前操作先看本组模块笔记;历史证据看 [[03-项目实施与验收进度]]。

本组以仓库实际 Java、Mapper、测试和用户提供的运行记录为来源。示例输出标注为预期;没有执行的测试不会写成通过。

更多请关注我的微信公众号,感谢!

微信图片_20260427132414_18_737.jpg