为什么从 classpath 读文件#

1
InputStream in = this.getClass().getClassLoader().getResourceAsStream("user.txt");

• getClassLoader() 拿到的是类加载器，getResourceAsStream("user.txt") 的意思是”从 classpath 的根开始找 user.txt”。项目编译后 src/main/resources 下的文件会被原样复制到 classpath 根下，所以文件名直接写 user.txt（不带 resources/ 前缀）；
• 为什么不用 new FileInputStream("user.txt")：那是按”当前工作目录”找文件的相对路径，在 IDEA 里跑也许能撞上，一旦打包成 jar 跑就必然找不到。资源文件一律走 classpath——课程代码的 import 区里还留着一个没用上的 java.io.FileInputStream（早期写法的残留），实际用的是 getResourceAsStream。

读文件：hutool 的 IoUtil.readLines#

1
ArrayList<String> lines = IoUtil.readLines(in, StandardCharsets.UTF_8, new ArrayList<>());

一句顶掉”BufferedReader 循环读 + 手动存 List”的一堆代码：把流里的内容按行读出来，装进最后一个参数给的集合里（这里顺手给个 new ArrayList<>()）。StandardCharsets.UTF_8 指定编码——user.txt 里有中文（大乔、吕布…），编码不对会变乱码。

解析封装：一行文本 → 一个 User 对象#

三件事连在一起做：

1
lines（8 行文本）
2
   │  lines.stream()          —— 把 List<String> 变成一条"流水线"
3
   │  .map(line -> { ... })    —— 每个元素（一行文本）加工成一个 User 对象
4
   │  .collect(Collectors.toList())  —— 加工结果收集回 List<User>
5
   ▼
6
List<User>（8 个 User 对象）→ return 出去 → 自动转成 JSON

map 里面的每一句都在解决”文本 → 属性”的类型转换：

@RestController 和 @ResponseBody（PPT 第 46 页）#

PPT 第 46 页专门把这点单拎出来讲：

@ResponseBody 注解的作用：将 controller 方法的返回值直接写入 HTTP 响应体；如果是对象或集合，会先转为 json，再响应。

@RestController = @Controller + @ResponseBody

三个注解各管什么：

这两者的区别有实测对照（本机在入门工程里另加了两个方法分别试的，下面就是跑出来的结果）：

1
// 实验一：只用 @Controller，方法返回字符串 "abc"
2
@Controller
3
public class DemoController {
4
    @RequestMapping("/demo")
5
    public String demo() { return "abc"; }
6
}
7
// 实验二：@Controller + @ResponseBody，返回同一个字符串

一、知识回顾（读完直接做下面的实践题）#

1. 案例需求：开发 web 程序，完成用户列表的渲染展示——浏览器访问 http://localhost:8080/list 拿到用户 JSON 数组（[{"id":1,"username":"daqiao",...}]），user.html 再用 axios 取回来渲染成表格
2. 准备工作四步：① 创建 SpringBoot 工程，勾选 web 依赖、lombok；② 引入资料里的 user.txt 和前端静态页面；③ 定义一个实体类封装用户信息；④ 开发服务端程序（接收请求、读取文本数据并响应）
3. 静态资源放哪：resources/static（完整路径 src/main/resources/static/）——user.html、js/axios.min.js、js/vue.esm-browser.js 都放这里，浏览器直接 http://localhost:8080/user.html 就能访问（实测返回 200 text/html）；user.txt 不放这里，它放 src/main/resources/ 根下，是给 Java 代码读的
4. 实体类与字段对应：User 六个属性 id、username、password、name、age、updateTime，用 Lombok 的 @Data + @NoArgsConstructor + @AllArgsConstructor 生成 getter/setter 与两个构造方法（new User(...) 用的就是全参构造）；user.txt 每行 6 段，按逗号切开后依次对应这六个属性（id、age 要 Integer.parseInt，最后一段用 LocalDateTime.parse(...) 配 DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss")）
5. 读文件的方式：this.getClass().getClassLoader().getResourceAsStream("user.txt")——从 classpath 读（src/main/resources 下的文件编译后就在 classpath 根），所以文件名不带 resources/ 前缀；用 new FileInputStream("user.txt") 这种相对路径打包成 jar 后会找不到
6. 按行读 + 解析封装：IoUtil.readLines(in, StandardCharsets.UTF_8, new ArrayList<>()) 一次读出所有行；再 lines.stream().map(line -> {...}).collect(Collectors.toList()) 把每行加工成 User 对象、收集成 List<User>（.toList() 是等价的新写法）
7. @ResponseBody 的作用：将 controller 方法的返回值直接写入 HTTP 响应体；如果是对象或集合，会先转为 json 再响应
8. @RestController = @Controller + @ResponseBody；实测对照：只用 @Controller 且方法返回 "abc" 时访问 404（返回值被当作视图名去解析），加上 @ResponseBody（或直接用 @RestController）就正常返回字符串
9. 实测 /list：响应头是 HTTP/1.1 200、Content-Type: application/json、Transfer-Encoding: chunked，响应体是 JSON 数组；其中 Content-Type 是 SpringBoot 自动设置的，时间字段默认序列化成 2024-07-15T15:05:45（空格变 T）
10. 这段代码的问题：Controller 里一个方法同时承担了”接收请求/响应数据""读文件""解析封装”三件事 → 复用性差、难以维护，解决方向是下一篇的三层架构（单一职责原则）

二、裸写题#

• 2-1 写一个返回用户列表的接口 工程里有 src/main/resources/user.txt（8 行，逗号分隔，6 段），还有一个实体类 com.itheima.pojo.User（六个属性 id/username/password/name/age/updateTime）。请写一个请求处理类，让浏览器访问 http://localhost:8080/list 时：

  1. 从工程里读到这个文件（不许写死 D:\... 这种绝对路径）；
  2. 每行解析成一个 User 对象，最后返回这 8 个对象的集合；
  3. 返回值到浏览器上要是 JSON 数组，而不是一个页面名字。 （练习文件 test_36_用户列表接口.java 里已经给了包名、实体类路径和写作区。）
  提示（先自己想，实在想不出再点开）

  一级 · 思路：四件事——类上标明”这是个处理请求的类”、“访问哪个地址进这个方法”、方法体里读文件+解析、返回集合。返回集合还要保证”不被当成页面名” 二级 · 方法：类上用 @RestController（它自带 @ResponseBody），方法上用 @RequestMapping("/list")；读文件用 this.getClass().getClassLoader().getResourceAsStream("user.txt")；按行读用 hutool 的 IoUtil.readLines(in, StandardCharsets.UTF_8, new ArrayList<>())；解析用 lines.stream().map(...).collect(Collectors.toList())，每行 split(",") 后 Integer.parseInt、LocalDateTime.parse(..., DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss"))；最后 return userList; 三级 · 骨架：@____ public class UserController { @____("/list") public List<User> list(){ InputStream in = this.getClass().getClassLoader().getResourceAsStream("____"); ArrayList<String> lines = IoUtil.____(in, StandardCharsets.UTF_8, new ArrayList<>()); List<User> userList = lines.____().map(line -> { String[] parts = line.split("____"); return new User(Integer.parseInt(parts[0]), parts[1], parts[2], parts[3], Integer.parseInt(parts[4]), LocalDateTime.____(parts[5], DateTimeFormatter.ofPattern("____"))); }).collect(Collectors.toList()); return ____; } }

  参考答案（做完再点开）

  1
  package com.itheima.controller;
  2
  
  3
  import cn.hutool.core.io.IoUtil;
  4
  import com.itheima.pojo.User;
  5
  import org.springframework.web.bind.annotation.RequestMapping;
  6
  import org.springframework.web.bind.annotation.RestController;
  7
  
  8
  import java.io.InputStream;
  9
  import java.nio.charset.StandardCharsets;
  10
  import java.time.LocalDateTime;
  11
  import java.time.format.DateTimeFormatter;
  12
  import java.util.ArrayList;
  13
  import java.util.List;
  14
  import java.util.stream.Collectors;
  15
  
  16
  @RestController   // = @Controller + @ResponseBody：返回值直接写进响应体，集合会先转 JSON
  17
  public class UserController {
  18
  
  19
      @RequestMapping("/list")
  20
      public List<User> list() throws Exception {
  21
          // 1. 从 classpath 读取 user.txt（编译后 resources 下的文件就在 classpath 根）
  22
          InputStream in = this.getClass().getClassLoader().getResourceAsStream("user.txt");
  23
          ArrayList<String> lines = IoUtil.readLines(in, StandardCharsets.UTF_8, new ArrayList<>());
  24
  
  25
          // 2. 一行文本 -> 一个 User 对象
  26
          List<User> userList = lines.stream().map(line -> {
  27
              String[] parts = line.split(",");
  28
              Integer id = Integer.parseInt(parts[0]);
  29
              String username = parts[1];
  30
              String password = parts[2];
  31
              String name = parts[3];
  32
              Integer age = Integer.parseInt(parts[4]);
  33
              LocalDateTime updateTime = LocalDateTime.parse(parts[5],
  34
                      DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss"));
  35
              return new User(id, username, password, name, age, updateTime);
  36
          }).collect(Collectors.toList());
  37
  
  38
          // 3. 响应数据
  39
          return userList;
  40
      }
  41
  }

  显示更多显示更少

  三点检查：① 访问 http://localhost:8080/list 得到 JSON 数组（实测响应头是 HTTP/1.1 200 + Content-Type: application/json）；② 把类上的注解换成 @Controller 再访问会变成 404——返回值被当成视图名了，这就是”第 3 个要求”的由来；③ 把 getResourceAsStream("user.txt") 改成 new FileInputStream("user.txt")，IDEA 里可能还能跑，打包成 jar 后就找不到了。

• 2-2 把 user.txt 的一行解析成对象 给定 user.txt 的第一行文本：

  1
  1,daqiao,1234567890,大乔,22,2024-07-15 15:05:45

  请写代码把它变成 com.itheima.pojo.User 对象（六个属性依次填进去）：数字段要变成数字、时间字符串要变成时间对象、剩下的原样是字符串。写完打印这个对象看一眼。 （练习文件 test_36_解析一行用户数据.java 里给了写作区。）

  提示（先自己想，实在想不出再点开）

  一级 · 思路：先把一行”切开”成 6 段，再按实体类每个属性的类型逐个转换，最后交给全参构造方法组装 二级 · 方法：split(",") 得到 String[]；Integer.parseInt(...) 转数字；LocalDateTime.parse(字符串, DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss")) 转时间；new User(...) 组装 三级 · 骨架：String[] parts = line.split("____"); User user = new User(Integer.____(parts[0]), parts[1], parts[2], parts[3], Integer.parseInt(parts[____]), LocalDateTime.____(parts[5], DateTimeFormatter.ofPattern("____")));

  参考答案（做完再点开）

  1
  package com.itheima;
  2
  
  3
  import com.itheima.pojo.User;
  4
  
  5
  import java.time.LocalDateTime;
  6
  import java.time.format.DateTimeFormatter;
  7
  
  8
  public class ParseLineTest {
  9
      public static void main(String[] args) {
  10
          String line = "1,daqiao,1234567890,大乔,22,2024-07-15 15:05:45";
  11
  
  12
          // 1. 按逗号切成 6 段
  13
          String[] parts = line.split(",");
  14
  
  15
          // 2. 按类型转换：数字段 parseInt，时间段 parse（格式要和文本一模一样）
  16
          Integer id = Integer.parseInt(parts[0]);            // "1" -> 1
  17
          String username = parts[1];                          // daqiao
  18
          String password = parts[2];                          // 1234567890
  19
          String name = parts[3];                              // 大乔
  20
          Integer age = Integer.parseInt(parts[4]);            // "22" -> 22
  21
          LocalDateTime updateTime = LocalDateTime.parse(parts[5],
  22
                  DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss"));
  23
  
  24
          // 3. 组装（Lombok 的 @AllArgsConstructor 生成的构造方法）
  25
          User user = new User(id, username, password, name, age, updateTime);
  26
          System.out.println(user);
  27
          // 输出：User(id=1, username=daqiao, password=1234567890, name=大乔, age=22, updateTime=2024-07-15T15:05)
  28
      }
  29
  }

  显示更多显示更少

  检查点：① split 的参数就是分隔符（","），不是正则里的 ".",；② LocalDateTime.parse 的格式串必须和文本一致（yyyy-MM-dd HH:mm:ss，中间那个空格也是格式的一部分），差一个字符就抛 DateTimeParseException；③ 如果打印出来中文是乱码，是编码没指定对——读文件时要给 StandardCharsets.UTF_8。

• 2-3 接口为什么返回了 404 小王写完接口，类上用的是 @Controller，方法返回字符串 "abc"。启动工程后浏览器访问 /demo，得到 404。请回答：

  1. 为什么会 404？（说清楚返回值被当成了什么）
  2. 给出两种改法，让这个接口能正常返回字符串 "abc"；
  3. 本案例的 /list 接口要返回 JSON 数组，两种改法里哪一种更省事？ （练习文件 test_36_接口为什么返回404.java 里给了写作区。）
  提示（先自己想，实在想不出再点开）

  一级 · 思路：先想”@Controller 默认拿返回值去干什么”，再想”有没有一个注解能改成’把返回值写进响应体’“，最后想”有没有一个注解把这两件事合起来” 二级 · 方法：类上换 @RestController，或者保留 @Controller、在方法（或类）上加 @ResponseBody 三级 · 骨架：改法一 @____RestMethod → 换成 @____Controller；改法二 在方法上加 @____Body

  参考答案（做完再点开）

  1. 因为 @Controller 默认把方法返回值当成”视图名”：SpringMVC 拿 "abc" 去找叫 abc 的页面（视图），工程里既没有模板引擎也没有这个页面，所以 404。实测（Spring Boot 3.2.8）就是这个结果。
  2. 两种改法：

     1
     // 改法一：类上的 @Controller 换成 @RestController（= @Controller + @ResponseBody）
     2
     @RestController
     3
     public class DemoController {
     4
         @RequestMapping("/demo")
     5
         public String demo() { return "abc"; }
     6
     }

     1
     // 改法二：保留 @Controller，给方法（或类）加上 @ResponseBody
     2
     @Controller
     3
     public class DemoController {
     4
         @RequestMapping("/demo")
     5
         @ResponseBody
     6
         public String demo() { return "abc"; }
     7
     }

  3. 本案例返回的是 List<User>，用 @RestController 更省事——一次注解管住整个类的所有方法（本机实测：@Controller + @ResponseBody 返回字符串的效果和 @RestController 完全一样，但每个方法都得记得加 @ResponseBody）。

三、综合题#

• 3-1 照课程做一遍”用户列表渲染”案例 从空工程开始，把这个案例完整做一遍，每一步都跑一遍再进下一步：

  1. 创建 SpringBoot 工程，勾 Spring Web + Lombok，pom 里补上 hutool 依赖（代码里 IoUtil 要用）；
  2. 把 user.txt 放进 src/main/resources/ 根下，把 user.html + js/ 两个库文件放进 src/main/resources/static/；先用浏览器把 http://localhost:8080/user.html 打开，确认页面能显示（这时表格是空的，因为接口还没有）；
  3. 写实体类 com.itheima.pojo.User（6 个属性 + 3 个 Lombok 注解）；
  4. 写请求处理类 com.itheima.controller.UserController：读文件 → 按行解析成 List<User> → 返回；
  5. 启动工程，用两种方式验证接口：浏览器/curl 直接访问 http://localhost:8080/list（应看到 JSON 数组），再看响应头里的 Content-Type；
  6. 回到 user.html 刷新页面，表格应该出现 8 行数据；顺手做一次”故障演练”：把 @RestController 换成 @Controller 再访问 /list，把看到的状态码记在练习文件末尾。 （练习文件 test_36_综合_用户列表案例.java 里按这 6 步给了写作区。）

  涉及知识点

  知识点	在这里的应用
  起步依赖	spring-boot-starter-web（内嵌 Tomcat + SpringMVC + Jackson）、lombok、hutool-all
  静态资源位置	resources/static 放页面（/user.html 能直接访问），resources 根放数据文件（classpath 读）
  实体类	User + @Data/@NoArgsConstructor/@AllArgsConstructor，属性名 = JSON 字段名
  读文件	getClassLoader().getResourceAsStream("user.txt") + IoUtil.readLines(..., UTF_8, ...)
  解析封装	stream().map() + split(",") + Integer.parseInt + LocalDateTime.parse
  响应数据	@RestController = @Controller + @ResponseBody；集合自动转 JSON，Content-Type: application/json
  遗留问题	一个方法三件事 → 复用性差、难以维护（下一篇拆三层）

  提示（先自己想，实在想不出再点开）

  一级 · 思路：整个案例就是”文件 → 对象集合 → JSON”这一条链，外加”页面从哪来”（静态资源）和”返回值怎么变成 JSON”（@RestController）两个配角 二级 · 方法：建工程勾 web+lombok、pom 补 hutool；页面进 resources/static、数据文件进 resources 根；实体类用 Lombok 三件套；接口用 @RestController + @RequestMapping("/list")；读文件 getResourceAsStream、按行读 IoUtil.readLines、解析 stream().map(...)；验证用 curl 看状态码和 Content-Type 三级 · 骨架：@____ public class UserController { @____("/list") public List<User> list(){ ... } }；验证三连 = curl -si http://localhost:8080/list（看头）、curl -s http://localhost:8080/list（看体）、浏览器打开 http://localhost:8080/user.html（看效果）

  参考答案（做完再点开）

  3-1 六步的落地写法：

  1. 工程与依赖：坐标随意（课程是 com.itheima:springboot-web-demo），pom 关键三行：

     1
     <dependency>
     2
         <groupId>org.springframework.boot</groupId>
     3
         <artifactId>spring-boot-starter-web</artifactId>
     4
     </dependency>
     5
     <dependency>
     6
         <groupId>org.projectlombok</groupId>
     7
         <artifactId>lombok</artifactId>
     8
         <optional>true</optional>
     9
     </dependency>
     10
     <dependency>
     11
         <groupId>cn.hutool</groupId>
     12
         <artifactId>hutool-all</artifactId>
     13
         <version>5.8.28</version>
     14
     </dependency>

  2. 文件位置：

     1
     src/main/resources/
     2
     ├── user.txt              ← 给 Java 代码读（classpath 根，文件名就是 user.txt）
     3
     ├── application.properties
     4
     └── static/               ← 给浏览器访问（映射到网站根路径）
     5
         ├── user.html
     6
         └── js/
     7
             ├── axios.min.js
     8
             └── vue.esm-browser.js

     此时浏览器访问 http://localhost:8080/user.html 应能看到标题和表头（本机实测静态资源返回 200 text/html），表格里没有数据行。
  3. 实体类：

     1
     package com.itheima.pojo;
     2
     
     3
     import lombok.AllArgsConstructor;
     4
     import lombok.Data;
     5
     import lombok.NoArgsConstructor;
     6
     import java.time.LocalDateTime;
     7
     
     8
     @Data
     9
     @NoArgsConstructor
     10
     @AllArgsConstructor
     11
     public class User {
     12
         private Integer id;
     13
         private String username;
     14
         private String password;
     15
         private String name;
     16
         private Integer age;
     17
         private LocalDateTime updateTime;
     18
     }

     显示更多显示更少
  4. 请求处理类：就是本篇”第 4 步”那段完整代码（@RestController + @RequestMapping("/list") + 读文件 + stream().map(...) + return userList;）。
  5. 验证：

     1
     $ curl -si "http://localhost:8080/list" | head -4
     2
     HTTP/1.1 200
     3
     Content-Type: application/json
     4
     Transfer-Encoding: chunked

     能拿到这个头，说明”返回值 → JSON → 响应体”这条链全通了；响应头里的 Content-Type 是 SpringBoot 自动加的。
  6. 页面效果与故障演练：
     • 刷新 user.html，8 行数据出现（对课程资料里的 8 个用户：大乔、小乔、貂蝉、吕布、赵云、张飞、关羽、刘备）；
     • 把 @RestController 换成 @Controller 后重启，curl -s -o /dev/null -w "%{http_code}" http://localhost:8080/list 得到 404——返回值 List<User> 被当成视图名了（本机实测结论），这就反向印证了”@RestController = @Controller + @ResponseBody”。