第46次 · 框架知识回顾与调用链复盘
第46次 · 框架知识回顾与调用链复盘
第1/7页 · 先知道今天要做什么
先从一个熟悉的场景想一想:这节课的代码在帮我们解决什么问题?
先来一个生活里的画面
复盘一次查书,像倒着追一份外卖:这份结果从哪来、谁安排、谁取物、谁接单。用你自己的控制台标记走一遍 Book 请求,比背 IoC、MVC、Mapper 三个词更能说明各自做了什么。
你已经会的知识
用前面课的类、方法、参数和返回值来读本次例子。遇到新名字先看下一页;不用一开始读完整个工程。
为什么要学这一课
回到第13章SSM的Book查询,用自己标记过的一次请求复盘三层与Spring管理。此课下载映射就是第13章,不混用第14章发布类。
今天完成的事情
用一次真实查询复盘对象创建、Web入口、服务与数据库调用。
这课在哪里做
| 要找什么 | 真实位置 |
|---|---|
| 下载后打开 | 04_源代码/chapter13-SSM/pom.xml |
| 本次先读 | src/main/java/com/itheima/controller/BookController.java |
| 运行或请求入口 | src/main/java/com/itheima/controller/BookController.java |
看到什么才算完成一小步
- 正确Book请求:看到Controller、Service标记与JSON。
- 错误路径:通常404且未进该Controller。
- 只测查询:没有因此证明多步写入回滚,需要单独事务实验。
阅读顺序
第2页查新词,第3页读这一份工程的代码,第4页先找文件和入口。第5页在 IDEA 按步骤修改;第6页对照效果和问题;第7页用自己的话复盘。
操作位置
下载、解压、打开、修改和运行在本机 IDEA;教学网站用于看讲义、下载资源、保存草稿和提交。先请教师提供本章的独立练习数据库、已初始化的表和连接参数。按指定配置文件填写本地连接;配置未就绪时先停在这一步。读到 SQLException 不等于 Java 写错。只在自己的教学库做新增、修改和回滚练习,单独运行指定测试方法,不点整个测试类的 Run All。
来源:第13章 框架整合 · 课件第6、9、13页(课件页码,不是教材印刷页码)
第2/7页 · 把新词说清楚
先把本课用得到的名字认清;看到名字时回到真实文件定位。
新词与本课含义
| 名字 | 在这个例子里是什么意思 |
|---|---|
| 调用链 | URL→BookController→BookServiceImpl→BookMapper→book 表→JSON。 |
| 对象来源 | 配置和注解决定 Spring 提供哪些对象。 |
| 查询与事务 | 查询成功没有证明发生回滚,不把没测过的能力画成已验证。 |
| 失败定位 | 区分路径404与已进入查询后的错误。 |
把生活画面对应到教材代码
| 生活里的角色或动作 | 本课真正的代码 |
|---|---|
| 接到请求的站点 | BookController |
| 安排查询的站点 | BookServiceImpl |
| 真正查表的站点 | BookMapper 与 book 表 |
类比怎样用
先借这个画面记住分工,再回到本课文件逐项定位。生活里的角色只是类比,程序的实际行为以教材代码、配置和本机观察为准。
先对照文件名
src/main/java/com/itheima/controller/BookController.java 是本次主阅读文件,位置在 04_源代码/chapter13-SSM 内。目录、类、方法和对象登记名是四种不同名字,不要随意互相替换。
读代码时只问三个问题
- 它从哪里得到输入:方法参数、XML、请求还是数据库?
- 它调用哪个具体方法:到同一个工程中查这个名字。
- 结果从哪里看:Run 控制台、请求响应还是数据库?本课第1页检查表给出位置。
先不用背术语
先能找到文件、指出一行的动作并描述输出。术语用来给已经看过的动作命名,不用它替代操作过程。
来源:第13章 框架整合 · 课件第6、9、13页(课件页码,不是教材印刷页码)
第3/7页 · 先看一个小例子
下面的教材片段来自本课下载项目;新增练习代码会另外标明。不要把节选直接当完整文件覆盖。
先猜一猜,读完代码再回答
课程学过 AOP,就应该在每一条请求路线都画上切面吗?
三个具体例子:先给输入,再想结果
| 输入或改动 | 应该观察什么 | 为什么 |
|---|---|---|
| 正确查书请求 | 按实际代码看两层标记和 JSON | 逐站验证这次调用。 |
| 错误路径 | 通常404且未到该 Controller | 问题在到达方法之前。 |
| 仅本次查询成功 | 不能说明写事务回滚已测过 | 它验证的是这条只读请求链。 |
把例子用起来
这些是课堂推演,帮你看清“只改一个输入,结果怎样变化”。涉及数据库的编号、余额和数量是示意,动手时换成教师提供的真实练习数据;在 IDEA 写下自己的预测,再运行核对。
打开这一份文件
04_源代码/chapter13-SSM/src/main/java/com/itheima/controller/BookController.java。在 IDEA 双击打开;以下只是它的第27—31行,完整类、import 和配置仍保留在项目中。
BookController.java:先读这一段
04_源代码/chapter13-SSM/src/main/java/com/itheima/controller/BookController.java 第27—31行
public List<Book> findAllBooks(){
List<Book> allBooks = bookService.findAllBooks();
return allBooks;
}
}
先看第1个动作
BookController.findAllBooks先调用BookService。
先看第2个动作
BookServiceImpl再调用BookMapper,数据库对应book表。
先看第3个动作
@ResponseBody把列表返回为JSON;实际上下文由Tomcat部署决定。
先看第4个动作
只有源码确实存在的事务或切面才标在路线里,不能因课程讲过就假定此查询全用了。
先读再动手
先在 IDEA 找到以上几行,逐项说出它们做什么。第5页会明确告诉你改哪一行、加到哪个大括号里、运行哪个入口;今天只改那几处。
来源:第13章 框架整合 · 课件第6、9、13页(课件页码,不是教材印刷页码)
第4/7页 · 一步一步做出来
先认清项目、文件和运行入口;保持同一个例子,再去第5页做个人修改。
本课项目目录
04_源代码/chapter13-SSM/pom.xml;选择直接包含 pom.xml 和 src 的这一层。
把这条路线讲成一段小故事
- URL 请求
- Controller 方法
- Service 方法
- Mapper 与数据库
- 列表回到 JSON
先完成打开项目这一步
- 在讲义顶部点“下载代码资源”。等 ZIP 下载完成,在电脑文件管理器找到它,右键选择“全部提取/解压”,先解压成普通文件夹。不要直接在 ZIP 预览窗口中打开 Java 文件。
- 把解压目录复制一份作为自己的本课练习副本,例如 lesson-课次-学号。保留原包不改,后续课需要同章工程时可继续自己的副本,也可从原包重新开始。
- 按本页列出的“本课项目目录”进入到直接含 pom.xml 和 src 的那一层。整个 ZIP 解压目录、04_源代码 外层都不是这次的 Maven 项目根目录。
- 打开 IntelliJ IDEA。欢迎页点 Open(打开);已打开别的项目则点 File → Open。选择本课 pom.xml,出现选项时选 Open as Project(作为项目打开),或直接选它所在目录。已有项目时用 New Window,避免混淆。
- 导入后选择已安装的 JDK17,打开 Maven 面板 Reload All Maven Projects;依赖完成、代码无编译错误后再运行。
沿这些真实文件找代码
| 工程内路径 | 本次作用 |
|---|---|
| src/main/java/com/itheima/controller/BookController.java | 先双击定位,与第5页指定的修改步骤对照;原包已有。 |
| src/main/java/com/itheima/service/impl/BookServiceImpl.java | 先双击定位,与第5页指定的修改步骤对照;原包已有。 |
| src/main/java/com/itheima/mapper/BookMapper.java | 先双击定位,与第5页指定的修改步骤对照;原包已有。 |
不要急着执行
先请教师提供本章的独立练习数据库、已初始化的表和连接参数。按指定配置文件填写本地连接;配置未就绪时先停在这一步。读到 SQLException 不等于 Java 写错。只在自己的教学库做新增、修改和回滚练习,单独运行指定测试方法,不点整个测试类的 Run All。
本页先定位,第5页再修改运行
下面说明本课的运行方式,先找到对应按钮。到第5页完成指定配置、新建文件或修改代码后,再按这些步骤执行;还不存在的类或测试方法先不要运行。
本课怎样启动:部署到 Tomcat
- 此工程打包方式是 WAR,Controller 没有 main,不能直接右键运行控制器。先使用教师已准备的 JDK17 与兼容本章 Spring6/Jakarta 的 Tomcat10.1 环境。
- IDEA 有 Tomcat 集成功能时:Run → Edit Configurations → + → Tomcat Server → Local;Server 页点 Configure 选择教师给的 Tomcat 解压目录,JRE 选17,记下 HTTP port(例如8080)。
- Deployment 页点 + → Artifact,选择本工程 war exploded;没有 artifact 时先在 Project Structure → Artifacts 配置 Web Application: Exploded → From Modules,选本课模块。Application context 设 /lesson,保存配置。访问地址就是 http://localhost:实际端口/lesson 加本课路径。
- 点击刚配置的 Tomcat 运行按钮,等控制台明确部署完成后再请求;只启动 Tomcat 但未部署工程,访问本课接口会404。
- IDEA 版本没有 Tomcat 菜单时:在 Maven 面板 Lifecycle 双击 package,确认 BUILD SUCCESS;到 target 找实际 .war 文件,将它复制到教师给的 Tomcat/webapps,再运行 Tomcat/bin 中对应系统的启动脚本。上下文是 WAR 文件名去掉 .war。由教师先演示这个替代流程,不另找 Controller.main。
- 每次改 Java/XML 后 Save All,先停止旧实例,再重新部署并启动。用集成配置可重新 Run;手工 WAR 则重新 package、停服、替换自己的 WAR 与旧解压目录后启动。刷新浏览器不能代替重新编译部署。
- 控制台启动错误先核对本章 pom、JDK、Tomcat兼容与配置;未成功部署时先记录问题请教师检查原包,不能用后续页面的预测结果冒充运行成功。
本课入口是否需要新增
运行入口已在下载包中;第5页先做必要的配置或改动,再执行这个入口。JUnit 只运行指定方法,避免其它实验一起改数据。
完成修改后检查
| 操作或输入 | 预期观察 |
|---|---|
| 正确Book请求 | 看到Controller、Service标记与JSON。 |
| 错误路径 | 通常404且未进该Controller。 |
| 只测查询 | 没有因此证明多步写入回滚,需要单独事务实验。 |
记录一遍过程
在第5页按顺序改完,每次 Save All 再运行。写下本次实际入口、输入与结果,和表里的预期逐项对照;第一次未成功就按第6页定位。
来源:第13章 框架整合 · 课件第6、9、13页(课件页码,不是教材印刷页码)
第5/7页 · 换成自己的代码
下载项目后,在电脑的 IntelliJ IDEA 中一步一步修改、运行并检查;网站最后只接收你的作业。
本课在 IDEA 中完成什么
用一次真实查询复盘对象创建、Web入口、服务与数据库调用。
今天就用这个具体版本练习
把自己 Controller 与 Service 的标记抄到箭头两边。每个箭头写真实类和方法,最后标出 JSON 从哪里返回。
这七页使用同一个工程例子
前面的代码阅读和下面的练习都使用本课下载项目。表中列出的文件已在包中;写明“新建”的文件由你按步骤在 IDEA 创建。先保留本地正确包名和目录,再按真实文件名提交修改后的文本。
本课项目目录
04_源代码/chapter13-SSM;选择这一层的 pom.xml。运行入口:src/main/java/com/itheima/controller/BookController.java。# 后面的文字表示要单独运行的测试方法。
第0步:下载、解压并在 IDEA 打开项目
- 在讲义顶部点“下载代码资源”。等 ZIP 下载完成,在电脑文件管理器找到它,右键选择“全部提取/解压”,先解压成普通文件夹。不要直接在 ZIP 预览窗口中打开 Java 文件。
- 把解压目录复制一份作为自己的本课练习副本,例如 lesson-课次-学号。保留原包不改,后续课需要同章工程时可继续自己的副本,也可从原包重新开始。
- 按本页列出的“本课项目目录”进入到直接含 pom.xml 和 src 的那一层。整个 ZIP 解压目录、04_源代码 外层都不是这次的 Maven 项目根目录。
- 打开 IntelliJ IDEA。欢迎页点 Open(打开);已打开别的项目则点 File → Open。选择本课 pom.xml,出现选项时选 Open as Project(作为项目打开),或直接选它所在目录。已有项目时用 New Window,避免混淆。
- 确认导入方式为 Maven。若出现信任提示,先核对这确实是本课程下载的工程再信任。等右下角索引与依赖下载结束,不在下载尚未完成时急着运行。
- 点 File → Project Structure → Project,将 SDK 设为已安装的 JDK 17。列表没有17就按教师安装包先安装,再 Add SDK/JDK 选择实际安装目录;不要把语言级别选17当作JDK已安装。
- 打开 View → Tool Windows → Maven,点击 Reload All Maven Projects(重新加载全部 Maven 项目)。若没有Maven面板,右键本课 pom.xml → Add as Maven Project。红色依赖仍存在时看下载错误,先解决网络/仓库和JDK配置。
- 回到左侧 Project,按本课文件表展开目录并双击文件。Java包可能合并显示为 com.itheima;表中的 src/main/java 表示主代码,src/test/java 表示测试。先核对包名与文件名,再修改。
先找到这些真实文件
| 项目根目录下的路径 | 怎么找到 |
|---|---|
| src/main/java/com/itheima/controller/BookController.java | 在 IDEA 左侧 Project 按路径展开、双击;这份文件已在下载包中。 |
| src/main/java/com/itheima/service/impl/BookServiceImpl.java | 在 IDEA 左侧 Project 按路径展开、双击;这份文件已在下载包中。 |
| src/main/java/com/itheima/mapper/BookMapper.java | 在 IDEA 左侧 Project 按路径展开、双击;这份文件已在下载包中。 |
第1步前:准备运行依赖
先请教师提供本章的独立练习数据库、已初始化的表和连接参数。按指定配置文件填写本地连接;配置未就绪时先停在这一步。读到 SQLException 不等于 Java 写错。只在自己的教学库做新增、修改和回滚练习,单独运行指定测试方法,不点整个测试类的 Run All。 SSM 的数据源从 application-dao.xml 及其引用的配置定位;Boot 从 application.yml 定位。先核对启动的是哪个工程。
本课怎样启动:部署到 Tomcat
- 此工程打包方式是 WAR,Controller 没有 main,不能直接右键运行控制器。先使用教师已准备的 JDK17 与兼容本章 Spring6/Jakarta 的 Tomcat10.1 环境。
- IDEA 有 Tomcat 集成功能时:Run → Edit Configurations → + → Tomcat Server → Local;Server 页点 Configure 选择教师给的 Tomcat 解压目录,JRE 选17,记下 HTTP port(例如8080)。
- Deployment 页点 + → Artifact,选择本工程 war exploded;没有 artifact 时先在 Project Structure → Artifacts 配置 Web Application: Exploded → From Modules,选本课模块。Application context 设 /lesson,保存配置。访问地址就是 http://localhost:实际端口/lesson 加本课路径。
- 点击刚配置的 Tomcat 运行按钮,等控制台明确部署完成后再请求;只启动 Tomcat 但未部署工程,访问本课接口会404。
- IDEA 版本没有 Tomcat 菜单时:在 Maven 面板 Lifecycle 双击 package,确认 BUILD SUCCESS;到 target 找实际 .war 文件,将它复制到教师给的 Tomcat/webapps,再运行 Tomcat/bin 中对应系统的启动脚本。上下文是 WAR 文件名去掉 .war。由教师先演示这个替代流程,不另找 Controller.main。
- 每次改 Java/XML 后 Save All,先停止旧实例,再重新部署并启动。用集成配置可重新 Run;手工 WAR 则重新 package、停服、替换自己的 WAR 与旧解压目录后启动。刷新浏览器不能代替重新编译部署。
- 控制台启动错误先核对本章 pom、JDK、Tomcat兼容与配置;未成功部署时先记录问题请教师检查原包,不能用后续页面的预测结果冒充运行成功。
发送接口请求:GET 与 POST 分开操作
- GET 请求可在电脑浏览器地址栏输入本机完整地址,结果页面或 JSON 在浏览器看,服务器输出在 IDEA 的 Run/Tomcat 控制台看。
- POST/JSON 请求不能只在地址栏输入。IDEA 支持 HTTP Client 时,在项目根目录 New → File 建 lessonXX.http,按下方示例或教师已验证样例填方法、完整本机地址、Headers,空一行后写 JSON,再点请求左边运行图标。没有 HTTP Client 时,用教师提供的 Postman:New → HTTP Request → 选 POST → 填地址 → Body → raw → JSON → Send。
- 需要登录凭据时在请求 Headers 增加本项目实际使用的 token 键,值用刚登录得到的凭据。文件上传则在 Postman Body 选 form-data、指定键名并将类型由 Text 切到 File。
- 同时记录 HTTP 状态、业务返回码/提示、控制台和实际数据。HTTP200并不保证业务成功;请求示例中的中文占位值必须先替换,端口取启动日志。
第1步:在 IDEA 操作并核对
本课下载的是第13章包。打开 chapter13-SSM/pom.xml,先找到 BookController.findAllBooks、BookServiceImpl.findAllBooks 和对应 Mapper;不要在本课包里寻找第14章 NewsController。
第2步:在 IDEA 操作并核对
在 Controller 和 Service 的查询前各加入一行不同的个人标记;保存并按 Tomcat 流程重新部署。访问 /book/findAllBooks,核对标记先后与真实JSON结果。
第3步:在 IDEA 操作并核对
把本次请求画成 URL → Controller方法 → Service方法 → Mapper方法 → book表 → JSON,逐箭头写实际文件名及传递内容。
第4步:在 IDEA 操作并核对
在配置与注解中标出对象怎么被 Spring 提供、数据源在哪里设置。只有源码实际存在的事务或切面才标出来,查询测试本身没有证明回滚。
第5步:在 IDEA 操作并核对
使用错误地址再请求,对比没进入Controller的404和数据库异常引起的500;后者只读已有错误记录分析,不主动破坏共享数据库。写出具体定位顺序。
在本地写练习记录
- 在 IDEA 项目根目录右键 New → File,新建 练习说明.md。填写改过的完整文件路径、方法或行位置,别只写“改了代码”。
- 每组检查写输入/操作、预期、实际结果;文字输出从 Run 控制台抄,接口结果从本机请求抄,数据库结果写实际查到的值。未运行就写“未实测”,并说明卡在哪一步。
- 临时故意写错的对象名、请求或配置按本课要求恢复,Save All。关闭再打开修改文件,确认本地改动保留;最终效果用最后一次重新运行检查。
最后才回网站交作业
本课代码的打开、修改、运行和检查都在本机 IDEA 完成。网站只用来下载讲义/资源和提交结果,不能运行 Java。完成后点讲义顶部“打开代码任务”,将自己在 IDEA 改过的文本文件复制到任务对应文件中;名称与模板不同就“+ 添加文件”填写真实文件名,不为迁就网站模板改错本地包名。保留自己的旧草稿,只提交需要交的源码和练习说明。
保存与提交
添加练习说明.md 并核对本地运行记录 → 保存草稿 → 等显示已保存 → 正式提交并核对新增版本。草稿不计入正式提交次数。项目 ZIP 留在电脑,按教师指定方式另交;不要把 ZIP 二进制内容粘进文本编辑器。提交材料去掉真实密码与登录token。
来源:第13章 框架整合 · 课件第6、9、13页(课件页码,不是教材印刷页码)
第6/7页 · 出错时从哪里查
先保留现象,只检查这一课的同一条调用路线。一次改一处,再重跑确认。
常见现象
| 现象 | 先做什么 |
|---|---|
| IDEA 没有运行三角或依赖报红 | 先查已安装的 JDK17、Maven 导入与下载错误;不要给 DAO/Controller 硬加 main。 |
| 运行结果还是旧的 | 核对右上角入口与当前工程;main/JUnit重新 Run,Web修改后重新编译部署或重启。 |
| 连接或启动失败 | 按第一段关键错误定位数据库、配置、端口或存储;环境未就绪先请教师检查。 |
| 没有预期数据或文字 | 按下面的具体输入表查调用链,分开看控制台、响应和真实数据,不把无报错等同完成。 |
遇到问题,先演一遍这一条路线
URL 请求 → Controller 方法 → Service 方法 → Mapper 与数据库 → 列表回到 JSON
用本课的输入复查
| 操作或输入 | 对照实际结果 |
|---|---|
| 正确Book请求 | 看到Controller、Service标记与JSON。 |
| 错误路径 | 通常404且未进该Controller。 |
| 只测查询 | 没有因此证明多步写入回滚,需要单独事务实验。 |
按本课路线检查
- BookController.findAllBooks先调用BookService。
- BookServiceImpl再调用BookMapper,数据库对应book表。
- @ResponseBody把列表返回为JSON;实际上下文由Tomcat部署决定。
- 只有源码确实存在的事务或切面才标在路线里,不能因课程讲过就假定此查询全用了。
需要老师帮忙时交这些
工程名 chapter13-SSM;运行入口 src/main/java/com/itheima/controller/BookController.java;你改的文件;输入或请求;第一段关键错误;本次预期与实际。截图之外保留错误文字,方便找到具体行。
把预测和实测分开
检查表是预期,不是替你运行过的证明。未在本机执行就写“未实测”;原教材配置或逻辑出现问题时记录原文件与现象,不写“系统判错”。
来源:第13章 框架整合 · 课件第6、9、13页(课件页码,不是教材印刷页码)
第7/7页 · 用自己的话讲一遍
用真实文件和本机结果说明你完成了什么;先说动作,再说术语。
回到第3页:你刚才猜对了吗?
课程学过 AOP,就应该在每一条请求路线都画上切面吗?
老师带你说清原因
只有实际配置并命中的切面才画进去。指源码说明这个请求用了什么,未出现或未测试的能力要分开。
请换一个自己的例子
照着本课三个例子的写法,说清“我只改什么、预计哪一处变化、到哪里看结果”。不需要再发明一个陌生项目;用本课同一组文件和入口。
回答本课的两个问题
| 问题 | 参考解释 |
|---|---|
| 这课应该找NewsController吗? | 不用;本课包是chapter13-SSM,主线是Book查询。 |
| 回顾框架时如何避免背术语? | 指实际类、方法、配置及输入结果,逐箭头讲工作。 |
按这个顺序讲给同学听
- 我打开的工程是 chapter13-SSM,本次阅读文件是 src/main/java/com/itheima/controller/BookController.java。
- 我实际改了哪一行、加了哪个方法;指着 IDEA 的代码说明。
- 我运行或请求的入口是 src/main/java/com/itheima/controller/BookController.java,输入是什么。
- 我在控制台、响应或数据库看到了什么,与第1页预期有什么差异。
- 我还有哪步没完成,保留了什么错误信息。
交作业前最后检查
文件与练习说明在 IDEA 已保存,正式提交的是自己的最终文本。下载包原样未改的部分标为参考;配置去掉真实密码和token。原有草稿不会被起始文件覆盖,需要时在代码任务查看本次起始文件对照。
课后再做一个小对照
只换本课检查表的一项输入,按同一入口重新执行,补一行预期和实际。没有环境时写明前置条件并停在实际完成的位置;不增加下一章的陌生功能。
来源:第13章 框架整合 · 课件第6、9、13页(课件页码,不是教材印刷页码)