六个方法各自取报文里的哪一段#

PPT 第 30 页的注释里给了每个方法的预期结果，把它和报文对齐就是这样：

一句话总结每个方法的口径：要值用 getParameter，要路径用 getRequestURI/getRequestURL，要请求头用 getHeader，要方式用 getMethod，要原始查询串用 getQueryString。

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

1. 请求数据由谁解析：Web 服务器（Tomcat）对 HTTP 协议的请求数据进行解析，并把它封装成请求对象，在调用 Controller 方法的时候作为方法参数传进来；这样程序员不必直接对协议进行操作，Web 开发更便捷
2. 请求对象是谁、怎么拿到：HttpServletRequest（jakarta.servlet.http 包）；写在 Controller 方法的参数里就行，它由服务器创建并注入，不是自己 new 出来的
3. 六个方法速查：getParameter("名") 取请求参数、getRequestURI() 取资源路径、getRequestURL() 取完整地址、getHeader("名") 取请求头、getMethod() 取请求方式、getQueryString() 取问号后面的原始查询串
4. getRequestURI() 与 getRequestURL() 的区别：URI 只有路径（本机实测 /request），URL 是含协议 + 主机 + 端口 + 路径的完整地址（实测 http://localhost:8080/request）；另外 getRequestURL() 返回的是 StringBuffer，要 .toString()
5. 本机实测的七行输出（请求 http://localhost:8080/request?name=Tomcat&age=10）：getParameter(name) = Tomcat、getParameter(age) = 10、getRequestURI() = /request、getRequestURL() = http://localhost:8080/request、getHeader(User-Agent) = curl/8.15.0、getMethod() = GET、getQueryString() = name=Tomcat&age=10
6. User-Agent 为什么两次不一样：它就是”谁在访问”的自述——curl 访问是 curl/8.15.0，浏览器访问是一长串 Mozilla/5.0 … Chrome/…，两者都对，取决于客户端
7. getParameter 与 getQueryString 的分工：前者按参数名取值（拿到的只是值，如 Tomcat），后者把问号后面那一整段原样返回（如 name=Tomcat&age=10）；参数存在请求体里时（POST），getParameter 照样能取到，但 getQueryString 就只反映地址栏上那段
8. 取参数的另一种写法：把参数名直接写成方法参数（如 public String hello(String name)），SpringMVC 会自动按名绑定——省事，但只能拿到声明的那几个值，比不上直接拿到整个请求对象
9. PPT 第 31 页两个必答问答：请求数据需要程序员自己解析吗 → 不需要，web 服务器解析并封装为请求对象；如何获取请求数据 → HttpServletRequest 对象里封装了所有的请求信息
10. 为什么要学它：上一篇看到的是”协议原文”，这一篇看到的是”报文进了 Java 程序之后的样子”——后面所有接口要从地址上拿参数（搜索条件、分页、id），用的都是这一节的 getParameter

二、裸写题#

• 2-1 写一个能收到问候对象的接口 需求：浏览器访问 /hello2?name=Tomcat 时，服务器在控制台打印出这次来访者的名字，并给浏览器返回一句简单的问候语（比如”Hello Tomcat”）。要求名字是从请求里取出来的、不能写死。 （练习文件 test_33_获取请求数据.java 里给了写作区。）

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

  一级 · 思路：地址上 ?name=Tomcat 就是一个请求参数，取参数得先有”请求对象”；这个对象不用自己造，声明成方法的参数服务器就会送进来 二级 · 方法：HttpServletRequest（jakarta.servlet.http 包）+ 它的 getParameter("name")；方法返回值由 @RestController + @RequestMapping 直接写进响应体 三级 · 骨架：@RequestMapping("____") public String hello2(____ request){ String name = request.____("____"); System.out.println(____); return ____; }

  参考答案（做完再点开）

  1
  package com.itheima;
  2
  
  3
  import jakarta.servlet.http.HttpServletRequest;
  4
  import org.springframework.web.bind.annotation.RequestMapping;
  5
  import org.springframework.web.bind.annotation.RestController;
  6
  
  7
  @RestController
  8
  public class HelloController {
  9
  
  10
      @RequestMapping("/hello2")
  11
      public String hello2(HttpServletRequest request) {
  12
          // 从请求参数里按名字取出 name（地址 ?name=Tomcat）
  13
          String name = request.getParameter("name");
  14
          // 控制台打印来访者名字
  15
          System.out.println("HelloController ... hello2 ： " + name);
  16
          // 把问候写回浏览器
  17
          return "Hello " + name;
  18
      }
  19
  }

  显示更多显示更少

  访问 http://localhost:8080/hello2?name=Tomcat，浏览器显示 Hello Tomcat，IDEA 控制台打印 HelloController ... hello2 ： Tomcat。 想省掉请求对象也行——把 String name 直接写成方法参数（课程30 篇的写法），SpringMVC 会自动把同名的请求参数绑定进来。

• 2-2 做一个”请求信息回显”接口 需求：访问 /requestInfo 时，把这次请求的三个信息拼成三行文字返回给浏览器——① 请求的是哪个资源路径；② 这个请求的完整地址；③ 用的是哪种请求方式。要求三行各占一行，且值都从请求里取。 （练习文件 test_33_请求信息回显.java 里给了写作区。）

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

  一级 · 思路：三个信息都在请求行里，分别对应”只要路径""要完整地址""要方法名”三个取值方法；拼字符串时每写完一段补一个换行 二级 · 方法：getRequestURI() / getRequestURL().toString() / getMethod()，用 StringBuilder 拼接，换行用 "\n" 三级 · 骨架：StringBuilder sb = new StringBuilder(); sb.append("请求路径 = ").append(request.____()); sb.append("\n"); …… return sb.toString();

  参考答案（做完再点开）

  1
  package com.itheima;
  2
  
  3
  import jakarta.servlet.http.HttpServletRequest;
  4
  import org.springframework.web.bind.annotation.RequestMapping;
  5
  import org.springframework.web.bind.annotation.RestController;
  6
  
  7
  @RestController
  8
  public class RequestInfoController {
  9
  
  10
      @RequestMapping("/requestInfo")
  11
      public String requestInfo(HttpServletRequest request) {
  12
          StringBuilder sb = new StringBuilder();
  13
          sb.append("请求路径 = ").append(request.getRequestURI()).append("\n");
  14
          // getRequestURL() 返回的是 StringBuffer，要 toString()
  15
          sb.append("完整地址 = ").append(request.getRequestURL().toString()).append("\n");
  16
          sb.append("请求方式 = ").append(request.getMethod());
  17
          return sb.toString();
  18
      }
  19
  }

  显示更多显示更少

  访问 http://localhost:8080/requestInfo，浏览器（返回的是 text/plain，浏览器按原文显示、保留换行）里是三行，本机实测同样的取法结果是 请求路径 = /request、完整地址 = http://localhost:8080/request、请求方式 = GET。

• 2-3 把来访者的身份记到控制台 需求：随意写一个能访问到的接口，在里面把来访客户端的身份信息和它访问的主机名取出来打印到控制台，并观察同一个地址分别用浏览器和用 curl 访问时，这两行输出有什么不同。 做完在文件末尾的注释里回答：这两行分别取的是报文里的哪一部分？为什么同一个接口两次访问拿到的值不一样？ （练习文件 test_33_读取请求头.java 里给了写作区。）

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

  一级 · 思路：客户端身份和主机名都不是地址上的参数，而是报文第二行开始的那些”键：值”——要用”按头名取请求头”的方法 二级 · 方法：request.getHeader("User-Agent")（客户端身份）、request.getHeader("Host")（主机名，浏览器访问时是 localhost:8080） 三级 · 骨架：String ua = request.getHeader("____"); String host = request.getHeader("____"); System.out.println("User-Agent = " + ua); System.out.println("Host = " + host);

  参考答案（做完再点开）

  1
  package com.itheima;
  2
  
  3
  import jakarta.servlet.http.HttpServletRequest;
  4
  import org.springframework.web.bind.annotation.RequestMapping;
  5
  import org.springframework.web.bind.annotation.RestController;
  6
  
  7
  @RestController
  8
  public class HeaderController {
  9
  
  10
      @RequestMapping("/header")
  11
      public String header(HttpServletRequest request) {
  12
          String userAgent = request.getHeader("User-Agent");
  13
          String host = request.getHeader("Host");
  14
          System.out.println("User-Agent = " + userAgent);
  15
          System.out.println("Host = " + host);
  16
          return "ok";
  17
      }
  18
  }

  显示更多显示更少

  两个问题： ① 两行取的都是请求头（request header），不是请求行里的参数——所以要用 getHeader("头名")，而不是 getParameter； ② 因为请求头是客户端自己填的：请求头里的 User-Agent 就是”我是谁”的自述，本机实测用 curl 访问拿到的是 curl/8.15.0，用浏览器访问拿到的是 Mozilla/5.0 (Windows NT 10.0; Win64; x64) … Chrome/…；两台不同的客户端访问同一个地址，值自然不一样（Host 也会因为访问用的地址不同而变，如 localhost:8080 与 127.0.0.1:8080）。

三、综合题#

• 3-1 照课程做一个”请求信息体检”接口（把六类数据一次取全） 把这一篇的六个方法串成一个接口做一遍，做完它你就把”从请求里取数据”这件事打通了。

  1. 在入门工程里新建一个请求处理类（类名自取，控制台/浏览器都能看到结果），并在类上加上”标识请求处理类”的注解；
  2. 定义处理方法，映射到 /request，方法参数里声明请求对象（这就是本篇的核心：让服务器把封装好的请求对象送进来）；
  3. 在方法里取出两个请求参数 name、age；
  4. 取出这个请求的资源路径和完整地址（各用一个变量存）；
  5. 取出请求头 User-Agent 和请求方式；
  6. 取出查询字符串（问号后面那一整段原样字符串）；
  7. 把上面七行结果拼成一段多行文字返回给浏览器；
  8. 用命令行或浏览器访问 http://localhost:8080/request?name=Tomcat&age=10，把返回的七行结果抄到练习文件末尾的注释里；
  9. 在注释里回答两个问题：① 第 4 步那两个变量的值分别是什么、差别在哪？② 这份请求数据是谁解析、谁封装、谁传给方法的？ （练习文件 test_33_综合_请求信息体检.java 里按这 9 步给了写作区。）

  涉及知识点

  知识点	在这里的应用
  Tomcat 解析 + 封装	方法参数里的 HttpServletRequest 不是自己 new 的
  @RestController / @RequestMapping	标类、标方法，把返回值直接写进响应体
  六个取值方法	getParameter ×2、getRequestURI、getRequestURL、getHeader、getMethod、getQueryString
  URI 与 URL 的区别	一个只有路径、一个是完整地址（含协议/主机/端口）
  请求头	User-Agent 随客户端变化（curl 与浏览器不同）

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

  一级 · 思路：先”拿到请求对象”，再”从它身上一个个取”——取参数、取路径、取头、取方式，最后把七行拼成一段字符串返回；第 9 步的两个问题回去看本篇开头 PPT 第 29 页那句原话 二级 · 方法：@RestController + @RequestMapping("/request")；参数写 HttpServletRequest request；拼串用 StringBuilder（append 一串 .append("\n")），注意 getRequestURL() 要 .toString() 三级 · 骨架：String name = request.____("name"); String uri = request.____(); String url = request.____().toString(); String ua = request.____("User-Agent"); String method = request.____(); String qs = request.____();

  参考答案（做完再点开）

  3-1 1~7. 代码（本机实验室里用的就是这个结构，HttpLabController）：

  1
  package com.itheima;
  2
  
  3
  import jakarta.servlet.http.HttpServletRequest;
  4
  import org.springframework.web.bind.annotation.RequestMapping;
  5
  import org.springframework.web.bind.annotation.RestController;
  6
  
  7
  @RestController
  8
  public class RequestLabController {
  9
  
  10
      @RequestMapping("/request")
  11
      public String request(HttpServletRequest request) {
  12
          // 1.请求参数
  13
          String name = request.getParameter("name");
  14
          String age = request.getParameter("age");
  15
          // 2.路径 uri 与完整地址 url
  16
          String uri = request.getRequestURI();
  17
          String url = request.getRequestURL().toString();
  18
          // 3.请求头
  19
          String userAgent = request.getHeader("User-Agent");
  20
          // 4.请求方式
  21
          String method = request.getMethod();
  22
          // 5.查询字符串
  23
          String queryString = request.getQueryString();
  24
  
  25
          StringBuilder sb = new StringBuilder();
  26
          sb.append("getParameter(name)    = ").append(name).append("\n");
  27
          sb.append("getParameter(age)     = ").append(age).append("\n");
  28
          sb.append("getRequestURI()       = ").append(uri).append("\n");
  29
          sb.append("getRequestURL()       = ").append(url).append("\n");
  30
          sb.append("getHeader(User-Agent) = ").append(userAgent).append("\n");
  31
          sb.append("getMethod()           = ").append(method).append("\n");
  32
          sb.append("getQueryString()      = ").append(queryString);
  33
          return sb.toString();
  34
      }
  35
  }

  显示更多显示更少

  8. 访问 http://localhost:8080/request?name=Tomcat&age=10 的本机实测输出：

     1
     getParameter(name)    = Tomcat
     2
     getParameter(age)     = 10
     3
     getRequestURI()       = /request
     4
     getRequestURL()       = http://localhost:8080/request
     5
     getHeader(User-Agent) = curl/8.15.0
     6
     getMethod()           = GET
     7
     getQueryString()      = name=Tomcat&age=10

     （User-Agent 那一行取决于用什么访问：curl 是 curl/8.15.0，浏览器是一长串 Mozilla/5.0 … Chrome/…。）
  9. 两个问题： ① uri = /request（只有资源路径，来自请求行的 GET /request HTTP/1.1 那一段）；url = http://localhost:8080/request（完整地址，多了协议、主机、端口）。名字只差一个字母，URL 才是能在浏览器里直接打开的地址；另外 getRequestURL() 返回 StringBuffer，所以代码里多写了 .toString()； ② 请求数据由 Web 服务器（Tomcat）解析并封装成 HttpServletRequest 请求对象，在调用 Controller 方法时作为方法参数传给该方法——所以方法里一行解析代码都不用写（PPT 第 29 页原话，也是 PPT 第 31 页问答的答案）。