重学JavaWeb之HTTP协议

yogurtzzz
754 阅读21分钟

HTTP协议

在网络通信中，2台计算机之间发送和接收的数据都是二进制流，二进制流可理解为只包含0和1的一个长串。单纯的二进制流是没有意义的，除非人为的对其进行规定。比如一个有爱的路人甲定义了一套规则（规则甲），在这套规则里，00表示我，11表示你，01表示爱，那么当计算机A向计算机B发送一串二进制流000111，若A和B都遵循规则甲。那么B就知道，A对她说了我爱你。如果另一个心怀怨恨的路人乙定义了一套规则（规则乙），其中00表示我，11表示你，01表示恨，如果A和B的通信，遵循的是规则乙，那么B接收到上面的二进制流，就知道A对她说了我恨你。同样的二进制流，若采用不同的规则，解读出来的是完全不同的含义。所以要让网络中的计算机互相通信，需要有一套标准规则，或者协议。HTTP协议就是网络通信中最基本的一种协议。浏览器通过发起HTTP请求给服务器（传送二进制流给服务器，并告诉服务器这段二进制流采用的协议是HTTP），服务器收到请求后，用HTTP协议对二进制流进行解析，明白了浏览器需要访问的具体是哪一个页面后，找到对应的页面资源，根据HTTP协议转化为二进制流，再传送回给浏览器。这样就完成了一次网页的请求和响应。

在通信时，HTTP协议会区分请求者，和响应者。或者客户端，和服务端。由客户端，发送HTTP请求给服务端，告知需要的资源。由服务端，发送HTTP响应给客户端，返回客户端需要的资源。遵循HTTP协议的二进制流，称为HTTP报文。客户端向服务端发送的报文，称为HTTP请求报文。服务端向客户端发送的报文，称为HTTP响应报文。它们的格式分别定义如下。

HTTP请求报文

先来看一个实际的HTTP请求报文。打开FireFox浏览器，按下F12打开开发者工具，在地址栏输入www.baidu.com，敲下回车，能够看到发出了如下的HTTP请求。

GET / HTTP/1.1
Host: www.baidu.com
User-Agent: Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:84.0) Gecko/20100101 Firefox/84.0
Accept: text/html,application/xhtml+xml,application/xml;q=0.9,image/webp,*/*;q=0.8
Accept-Language: zh-CN,zh;q=0.8,zh-TW;q=0.7,zh-HK;q=0.5,en-US;q=0.3,en;q=0.2
Accept-Encoding: gzip, deflate, br
Connection: keep-alive
Cookie: BAIDUID=BD904AF3599D963DAF4E36903E9D0561;

报文的第一行称为请求行，由3部分组成：请求方法，请求的URL（关于URL），HTTP协议版本。上面的请求行表示，请求的方法是GET，请求的URL是/，使用的协议是HTTP 1.1版本。随后的每一行，都是以键值对的形式出现，左侧是键，右侧是值，键值之间用冒号:分隔。这些键值对称为请求头，它主要描述关于此次请求的一些元数据。比如Host: www.baidu.com表示请求的域名是www.baidu.com，User-Agent: Mozilla/5.0....说明了浏览器的信息，这里表示使用的Mozilla的火狐浏览器，Accept: text/html....表示了此次请求预期接收的响应体的格式，这里表明预期接收到的是纯文本或者HTML格式的数据。

上面的请求报文不包含请求体，下面在JSP中提交表单数据，来发起一个POST请求，查看一下请求报文。

POST /login HTTP/1.1
Host: localhost:8025
User-Agent: Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:84.0) Gecko/20100101 Firefox/84.0
Accept-Language: zh-CN,zh;q=0.8,zh-TW;q=0.7,zh-HK;q=0.5,en-US;q=0.3,en;q=0.2
Accept-Encoding: gzip, deflate
Content-Type: application/x-www-form-urlencoded; charset=UTF-8
Content-Length: 26
Connection: keep-alive

user=yogurtzz&password=123

可以看到在多行请求头之后，以一个空行作为分隔，多出了一部分内容，这些内容即是请求体

所以，HTTP请求报文由3部分组成：

  • 请求行：包含了请求方法，请求的URL，使用的HTTP协议版本（三者之间以空格分隔）
  • 请求头：包含了请求的元数据（关于元数据）
  • 请求体：包含了请求的主体数据（请求头与请求体之间以一个空行分隔）

image-20201231105610866

HTTP响应报文

同样，先看一个实际的HTTP响应报文

HTTP/1.1 200 OK
Content-Type: text/html;
Transfer-Encoding: chunked
Date: Wed, 30 Dec 2020 03:20:06 GMT
Keep-Alive: timeout=60
Connection: keep-alive

<html>
  <head>
  </head>
  <body>
  success
  </body>
</html>

与HTTP请求报文类似，响应报文也由3个部分组成

  • 响应行：包含HTTP协议版本，HTTP状态码，状态码描述
  • 响应头：包含了响应的元数据
  • 响应体：响应的主体数据

浏览器收到上面的响应报文后，会自动渲染出HTML页面，如下

image-20201231115312402

HTTP响应状态码

状态码用来描述HTTP响应的情况，由三位数字组成，第一个数字表明了响应的类别，共有如下几类

类别说明
1xxInformational（信息性状态码）接收的请求正在处理
2xxSuccess（成功性状态码）请求正常处理完毕
3xxRedirection（重定向状态码）需要进行附加操作以完成请求
4xxClient Error（客户端错误）服务器无法处理请求
5xxServer Error（服务端错误）服务器处理请求出错

状态码定义可以参考RFC2616

通常来说，只需要熟悉以下的几种常见状态码即可，其中加粗的几种状态码非常常见。

状态码状态码描述说明
200OK请求成功
301Move Permanently永久重定向
302Found临时重定向
400Bad Request请求报文中存在语法错误
401Unauthorized需要认证
403Forbidden请求被服务器拒绝，可能是IP未授权等原因
404Not Found服务器上找不到请求的资源
500Internal Server Error服务器内部错误

HTTP请求方法

HTTP请求方法用来告知服务器，客户端的意图，常用的有如下几种

请求方法意图HTTP版本
GET获取资源1.0/1.1
POST传输实体1.0/1.1
PUT传输文件1.0/1.1
HEAD获得响应头部1.0/1.1
DELETE删除文件1.0/1.1
OPTIONS询问支持的请求方法1.1
TRACE追踪路径1.1
CONNECT要求建立隧道1.1

在进行web开发时，通常只会用到GET和POST两种方法。通俗地讲，GET的请求参数是放在URL中，且通常没有请求体（但没有规定GET请求不能携带请求体，只是通常不这么做）。假设有如下表单

<form action="login" method="get">
    用户名：<input type="text" name="user"/>
    密码：<input type="password" name="password">
    <input type="submit" value="登录"/>
</form>

image-20201230232319472

按F12打开开发者工具，能够看到请求的报文如下

GET /login?user=yogurtzz&password=123 HTTP/1.1
Host: localhost:8080
User-Agent: Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:84.0) Gecko/20100101 Firefox/84.0
Accept: text/html,application/xhtml+xml,application/xml;q=0.9,image/webp,*/*;q=0.8
Accept-Language: zh-CN,zh;q=0.8,zh-TW;q=0.7,zh-HK;q=0.5,en-US;q=0.3,en;q=0.2
Accept-Encoding: gzip, deflate
Connection: keep-alive
Referer: http://localhost:8080/login.jsp
Cookie: JSESSIONID=FD82B6FF51C8B2B22407AC0892BCBA86
Upgrade-Insecure-Requests: 1

可以看到用GET方式提交的表单数据，是通过追加到URL中的queryString来传送的，所以请求的参数，会直接反映到浏览器的地址栏中，如下图所示。所以我们会说，GET请求是不太安全的，它把请求地数据直接显示了出来。

image-20201230232645759

我们把表单的请求方法改为POST

<form action="login" method="post">
    用户名：<input type="text" name="user"/>
    密码：<input type="password" name="password">
    <input type="submit" value="登录"/>
</form>

再填写用户名，密码，点击登录。得到的请求报文如下

POST /login HTTP/1.1
Host: localhost:8080
User-Agent: Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:84.0) Gecko/20100101 Firefox/84.0
Accept: text/html,application/xhtml+xml,application/xml;q=0.9,image/webp,*/*;q=0.8
Accept-Language: zh-CN,zh;q=0.8,zh-TW;q=0.7,zh-HK;q=0.5,en-US;q=0.3,en;q=0.2
Accept-Encoding: gzip, deflate
Content-Type: application/x-www-form-urlencoded
Content-Length: 26
Origin: http://localhost:8080
Connection: keep-alive
Referer: http://localhost:8080/login.jsp
Cookie: JSESSIONID=A061396E89A92B916AB1FA8298354BAE
Upgrade-Insecure-Requests: 1

user=yogurtzz&password=123

请求的参数是放在请求体中的，不会明文显示在浏览器地址栏，所以我们说POST相对更加安全。

image-20201231092810770

HTTP小结

  • 定义：HTTP，全称 Hyper Text Transfer Protocol ，超文本传输协议

  • 作用：规范了客户端和服务端的数据交互格式

  • 报文格式：

    • 请求行（响应行）
    • 请求头（响应头）
    • 请求体（响应体）

  • 特点

    • 简单

      HTTP协议简单，不复杂

    • 灵活

      HTTP协议可以发送任何类型的数据（MIME类型），只要客户端和服务端能够处理这种数据。这可以通过Content-Type头来指定，请求头和响应头中都可以设置该头部。

    • 无连接

      在早期HTTP版本里，使用的是短链接，即每次请求和响应都会单独建立一个HTTP连接，完成一次请求响应后，连接断开。这么做的原因是，早期的网络，流量没有很大，请求具有间歇性和突发性，维持持久连接会使得连接通道长时间处于空闲状态，占用网络资源。而如今的网络请求具有频繁性和持续性，一次会话中可能会连续发送好几个HTTP请求，若为每一次的请求和响应单独建立一个HTTP连接，则频繁的建立和关闭连接会无谓地消耗性能。HTTP 1.1 之前的版本，可以通过设置请求头Connection: keep-alive来建立一个HTTP长连接（长连接即持久连接）。HTTP 1.1版本的默认连接则都是长连接。客户端可以在一个HTTP长连接上发送多次请求。若想断开连接，设置Connection: close即可。

    • 无状态

      HTTP协议不具备记忆能力。也就是说，每个HTTP请求都是独立的，完整的。后一个请求无法了解前一个请求的情况。这样设计使得HTTP协议足够简单，快速，因为不需要维护状态信息，不需要在状态之间进行转换。缺点也很明显，就是单个请求的所有信息都必须要完整地包含在一次请求中，使得单个请求的数据量可能会很大，并且先前请求中传输过的相同数据，可能在后续的请求中需要重复传输（如果后续的请求中需要用到前面请求的信息）。

      在某些场景下，需要让HTTP协议记住一些状态。比如用户登录的场景，用户应该只登录一次，就能够访问一个网站的全部资源，而不是每次请求资源都要重新登录。这种需要维持一个会话的场景，可通过Cookie和Session技术进行解决。

      关于有状态（stateful）和无状态（stateless）的生活小例子：

      • 有状态

        A：你中午吃的啥呀？

        B：吃的土豆烧排骨。

        A：味道怎么样？

        B：香的一匹。

      • 无状态

        A：你中午吃的啥呀？

        B：吃的土豆烧排骨。

        A：味道怎么样？

        B：什么味道怎么样？

      无状态的每次请求都是独立的，不存在上下文环境。有状态则存在上下文环境。

附录

元数据

元数据，就是数据的数据，或者可以理解为对数据的描述。比如客户端发起的HTTP请求报文中，请求体为name=yogurt，那么可以在请求头中可能有一项为：Content-Length: 11，以说明请求体的长度（字节数）为11。请求时传送的数据是name=yogurt，而请求头Content-Length: 11则描述了数据的长度，此为对数据的描述，即元数据。再比如，Content-Type 头，这个请求头说明了请求体数据的格式。在前后端对接开发时，前端请求后端，传递参数时，最常用的两种Content-Type便是application/x-www-form-urlencoded和application/json，前者是表单数据，后端可以用Spring的@RequestParam来接收请求参数，后者是json数据，后端可以用@RequestBody来接收。

URL

Uniform Resource Locator，统一资源定位符。在使用浏览器访问web页面时需要输入的网页地址，就是URL，比如http://www.baidu.com

与URL相关的，还有一个概念，叫URI（Uniform Resource Identifier，统一资源标识符）。URI用一个字符串来唯一标识网络上的某一资源，而URL则额外描述了该资源的地点，即在哪里能找到这个资源。

比如一个身份证可以用来唯一标识某个具体的人，但你需要这个人的地址才能找到他。

一个绝对URI的格式如下

http://user:pass@www.xxx.com:8808/dir/index.html?date=2021#chapter1

schemeuser info（可选）hostport（可选）pathquery（可选）fragment（可选）
协议名称登录信息(用户+密码)服务器地址端口号资源路径查询字符串片段标识符
httpuser:passwww.xxx.com8808/dir/index.htmldate=2021chapter1

其中，服务器地址可以是www.xxx.com这种能被DNS解析的域名，或者192.168.0.133这种IP地址（ipv4），或者[0:0:0:0:0:0:0:1]这样用方括号括起来的ipv6地址。

关于片段标识符，假设index.html内容如下

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>Title</title>
</head>
<body>
    <p>This is head</p>
    <!-- 此处省略1万字 -->
    <br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/>
    <br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/>
    <br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/>
    <br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/>
    <br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/>
    <br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/>
    <p id="chapter1"> This is Chapter 1</p>
</body>
</html>

访问http://localhost:8080/index.html，结果如下。若需要看到This is Chapter1，则需要将滚动条往下拖

image-20201231145300807

若加上片段标识符，访问http://localhost:8080/index.html#chapter1，则会自动定位到网页的锚点chapter1的位置（自动定位到一个id属性为chapter1的元素的位置，对于<a>元素，设置其name属性为chapter1也能够达到同样的效果）

image-20201231145433851

锚点在编写markdown文档时的妙用：可以使用锚点自由的链接到文档的其他位置。比如在本篇markdown文档中，我在HTTP请求报文的位置，添加了一个锚点request

image-20201231150153499

在这个地方，我只需要创建一个链接，指向request这个锚点，查看文档时，就可以点击链接，定位到锚点所处的位置。比如我用markdown语法，

[点击这里](#request)，来创建一个链接，点击就可以直接定位到锚点所处的位置，非常方便。可以试试 => 点击这里

HTTP抓包体验

为了更好的学习HTTP协议，可以尝试使用抓包工具来查看HTTP报文。这里推荐Fiddler，它是一款免费的HTTP分析和调试工具。支持对HTTP数据包进行截取，编辑，存储等。它的操作也非常简便。下面对使用Fiddler进行抓包做一个简单介绍

  1. 下载&安装

    访问https://www.telerik.com/download/fiddler-everywhere下载Fiddler，并安装

  2. 启动Fiddler，点击按钮开始抓包

    image-20201231151518509

  3. 打开浏览器随便访问一个页面，如www.baidu.com

    一开始可能会奇怪，为什么在Fiddler中看不到HTTP报文，这可能是因为访问外部网站采用的多是HTTPS协议，而没有对Fiddler进行HTTPS配置，所以查看不到，点击右上角的设置按钮，进行HTTPS的设置即可。设置完毕后记得重启一下Fiddler

    image-20201231151942327

  4. 再次开启抓包，就能看到访问www.baidu.com的HTTP报文了，选择并点击要查看的某一条HTTP请求，右侧Inspectors中会展示具体的请求报文和响应报文。

    image-20201231152309451

    可以看到已经自动对报文的各个部分进行了拆分展示，如报文头头部，报文主体等。若要查看原始的报文信息，点击Raw即可

    image-20201231152619208

    由于开发时，经常要对本地服务进行调试，本地服务经常使用http://localhost或者http://127.0.0.1来访问，故需要Fiddler抓取请求本地服务的HTTP报文。但不经任何配置，会发现在Fiddler中无法抓取到访问本地服务的HTTP请求。

    推荐如下2种解决方式：

    1. 使用ipv4.fiddler替换localhost

      假设要访问的本地服务地址为http://localhost:8080/demo，将其中的localhost替换ipv4.fiddler，则URL变为http://ipv4.fiddler:8080/demo

      由于Fiddler内部拦截了ipv4.fiddler这个域名，并自动转换到localhost，所以开启Fiddler时，访问ipv4.fiddler就等同于访问localhost

    2. 使用计算机名替换localhost

      计算机名的查看方式：打开 控制面板 -> 系统 ，便能够看到计算机名

      image-20201231153823190

      或者直接打开CMD，命令提示符，敲命令hostname，得到的也是计算机名

      image-20201231153940391

      假设要访问的本地服务地址为http://localhost:8080/demo，将其中的localhost替换计算机名DESKTOP-XXXX，则URL变为http://DESKTOP-XXXX:8080/demo

      参考链接：

      www.racecoder.com/archives/90…

      docs.telerik.com/fiddler/Obs…

      对本地服务的访问进行抓包测试如下

      image-20201231154713984

      image-20201231154813940

HTTP常用头部

HTTP报文中有一些非常常用的头部，在进行接口调用时，最重要的一个请求头莫过于Content-Type

Content-Type

这个头部，用于指定报文主体中的数据的格式（请求报文和响应报文中均可使用该头部），在前后端交互中，最常用的有3种：

  • application/x-www-form-urlencoded
  • application/json
  • multipart/form-data

下面以调用后端接口为例，对该头部的三种取值做一个简单说明

表单数据

对于第一种，当提交表单数据时，浏览器会自动在请求头中加入Content-Type:application/x-www-form-urlencoded，此时请求体中的数据格式类似于user=yogurt&password=123&age=17，后端若采用Spring，则可以用@RequestParam注解来获取，当方法的形参名称和请求体中参数名称一致时，可以不用加@RequestParam注解），代码示例如下

import org.springframework.web.bind.annotation.PostMapping;
import org.springframework.web.bind.annotation.RestController;

@RestController
public class SimpleController {

	@PostMapping("/test")
	public String test(String user, String password, int age) {
		System.out.println("user = " + user + ", password = " + password + ", age = " + age);
		return "success";
	}
}

我们用POSTMAN发出一个请求，请求上述接口

查看抓包情况

查看应用控制台输出

JSON数据

对第二种，当用POST方法提交JSON格式的数据时，需要在请求头中加上Content-Type: application/json，此时请求体中的内容就是一个JSON格式的字符串，后端若采用Spring，则可以用@RequestBody来将JSON字符串自动封装成一个JAVA对象，代码示例如下

import org.springframework.web.bind.annotation.PostMapping;
import org.springframework.web.bind.annotation.RequestBody;
import org.springframework.web.bind.annotation.RestController;

@RestController
public class SimpleController {

	@PostMapping("/json")
	public String json(@RequestBody Person person) {
		System.out.println(person.toString());
		return "success";
	}
}

其中，Person类定义如下

public class Person {

	private String name;
	private Integer age;
	private String school;

	public void setName(String name) {
		this.name = name;
	}

	public void setAge(Integer age) {
		this.age = age;
	}

	public void setSchool(String school) {
		this.school = school;
	}

	@Override
	public String toString() {
		return "Person{" +
				"name='" + name + '\'' +
				", age=" + age +
				", school='" + school + '\'' +
				'}';
	}
}

我们用POSTMAN发起一个请求，请求上面的/json接口

查看抓包情况如下

查看应用控制台输出如下

文件数据

对第三种，通常是用在文件上传的场景，后端若采用Spring，可以用MultipartFile类来接收上传的文件，示例代码如下

import org.springframework.web.bind.annotation.PostMapping;
import org.springframework.web.bind.annotation.RestController;
import org.springframework.web.multipart.MultipartFile;
import java.io.IOException;

@RestController
public class SimpleController {
	
	@PostMapping("/file")
	public String file(MultipartFile file) throws IOException {
		String fileName = file.getName();
		byte[] bytes = file.getBytes();
		String fileContent = new String(bytes);
		return "fileName: " + fileName + "\nfileContent: " + fileContent;
	}
	
}

我们用POSTMAN提交一个请求，上传一个文件，文件内容如下

POSTMAN请求如下

抓包情况如下（由于报文内容较长，直接复制报文内容，而不采用截图）

请求报文：

POST http://127.0.0.1:8025/file HTTP/1.1
User-Agent: PostmanRuntime/7.26.8
Accept: */*
Cache-Control: no-cache
Postman-Token: 0c6504d5-b71c-4b28-8e1f-d770596a796f
Host: 127.0.0.1:8025
Accept-Encoding: gzip, deflate, br
Connection: keep-alive
Content-Type: multipart/form-data; boundary=--------------------------604727261679510540033606
Content-Length: 261

----------------------------604727261679510540033606
Content-Disposition: form-data; name="file"; filename="test.txt"
Content-Type: text/plain

我是谁？
我从哪儿来？
我要到哪儿去？
----------------------------604727261679510540033606--

响应报文：

HTTP/1.1 200
Content-Type: text/plain;charset=UTF-8
Content-Length: 89
Date: Sat, 16 Jan 2021 14:05:13 GMT
Keep-Alive: timeout=60
Connection: keep-alive

fileName: 
test.txt
fileContent: 
我是谁？
我从哪儿来？
我要到哪儿去？

说完上传文件，下面说一下下载文件的场景，这涉及到另一个HTTP头部：Content-Disposition

Content-Disposition

使用说明：

使用response.getOutputStream()获取一个输出流，往输出流中写入字节数组。

随后，设置响应头Content-Disposition，有2种设置方法

  • Content-Disposition: attachment;filename=xxx.txt
  • Content-Disposition: inline;filename=xxx.txt

设置为attachment，则浏览器会以附件的形式保存文件，默认文件名为xxx.txt

设置为inline，当浏览器支持该文件类型时，会直接在浏览器打开文件

在文件下载时，我们设置为attachment，这样，浏览器会激活文件下载（有的浏览器会弹出文件下载对话框，有的浏览器会直接下载），使用示例如下

假设我的服务器上有如下一张图片AW.jpeg

我想提供一个接口，使得别人能够下载这张图片

后端代码如下

import org.springframework.http.HttpHeaders;
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.GetMapping;
import javax.servlet.ServletOutputStream;
import javax.servlet.http.HttpServletResponse;
import java.io.FileInputStream;
import java.io.IOException;
import java.nio.file.Path;
import java.nio.file.Paths;

@Controller
public class SimpleController {

	@GetMapping("/img")
	public void file(HttpServletResponse response) throws IOException {
		String imgPath = "E:\\AW.jpeg";
		Path path = Paths.get(imgPath);
		FileInputStream in = new FileInputStream(path.toFile());
		ServletOutputStream outputStream = response.getOutputStream();
		byte[] buffer = new byte[1024];
		int len;
		while ((len = in.read(buffer)) != -1) {
			outputStream.write(buffer, 0, len);
		}
		response.addHeader(HttpHeaders.CONTENT_DISPOSITION, "attachment;filename=AW2.jpeg");
	}

}

使用浏览器请求/img接口，发现并没有如预期一样弹出下载窗口，而是直接在浏览器端展示了图片

我开始纳闷了，于是按F12打开调试工具，再次请求，发现一个奇怪的现象，响应头中，没有Content-Disposition

而我在后端代码中是设置了该响应头的。也就是说，我设置的响应头失效了。于是我开始了抓虫（debug）之旅

我先是增加了一个下载简单的txt文本文件的接口，如下

	@GetMapping("/txt")
	public void txt(HttpServletResponse response) throws IOException {
		response.setCharacterEncoding("utf-8");  // 设置response流中的字符编码
		response.getWriter().write("我是谁，我从哪儿来，我要到哪儿去");
		response.addHeader(HttpHeaders.CONTENT_DISPOSITION, "attachment;filename=question.txt");
	}

在浏览器端访问，发现按照预期打开了文件下载对话框

在下面的开发者工具栏，查看请求的情况，发现Content-Disposition是有成功被添加的

经过一系列查找，发现ServletResponse中有一个方法isCommitted()，查看源码中的注释

根据注释，一个 "已被提交" 的response，其响应状态码和响应头已经被written。

于是我在/img和/txt两个接口添加响应头的代码前面，将response的isCommitted()打印出来

	@GetMapping("/img")
	public void file(HttpServletResponse response) throws IOException {
		String imgPath = "E:\\AW.jpeg";
		Path path = Paths.get(imgPath);
		FileInputStream in = new FileInputStream(path.toFile());
		ServletOutputStream outputStream = response.getOutputStream();
		byte[] buffer = new byte[1024];
		int len;
		while ((len = in.read(buffer)) != -1) {
			outputStream.write(buffer, 0, len);
		}
		System.out.println("/img接口被请求, isCommitted = " + response.isCommitted());
		response.addHeader(HttpHeaders.CONTENT_DISPOSITION, "attachment;filename=AW2.jpeg");
	}

	@GetMapping("/txt")
	public void txt(HttpServletResponse response) throws IOException {
		response.setCharacterEncoding("utf-8");  // 设置response流中的字符编码
		response.getWriter().write("我是谁，我从哪儿来，我要到哪儿去");
		System.out.println("/txt接口被请求, isCommitted = " + response.isCommitted());
		response.addHeader(HttpHeaders.CONTENT_DISPOSITION, "attachment;filename=question.txt");
	}

然后再分别用浏览器请求2个接口

发现在/img接口中，添加响应头之前，response已经被commit过，而/txt接口，response还没有被commit。所以就导致了/img接口最后添加响应头失效，而/txt接口没有失效。于是问题就变成了，什么时候会触发response的commit呢？

经过查询资料，发现在我上面的案例中，极有可能是response中的缓冲区已满，触发了缓冲区数据的flush，导致response变为已提交状态，从而导致随后对响应头的设置失效（已提交的response，响应状态码和响应头都无法更改了）。

下面修改代码进行验证

	@GetMapping("/img")
	public void file(HttpServletResponse response) throws IOException {
		String imgPath = "E:\\AW.jpeg";
		Path path = Paths.get(imgPath);
		FileInputStream in = new FileInputStream(path.toFile());
		ServletOutputStream outputStream = response.getOutputStream();
		byte[] buffer = new byte[1024];
		int len;
		int sumLen = 0;
		int bufferSize = response.getBufferSize();
		System.out.println("bufferSize = " + bufferSize);
		while ((len = in.read(buffer)) != -1) {
			outputStream.write(buffer, 0, len);
			sumLen += len;
			System.out.println("sumLen = " + sumLen);
			System.out.println("isCommitted = " + response.isCommitted());
			System.out.println("==========================");
		}
		System.out.println("/img接口被请求, isCommitted = " + response.isCommitted());
		response.addHeader(HttpHeaders.CONTENT_DISPOSITION, "attachment;filename=AW2.jpeg");
	}

打印的内容很多，选取关键的信息展示如下

可以看到，确实是由于response的缓冲区已满，触发了response的提交。想要细究的话，可以查看附录的debug过程

所以，我们只要在一开始就把响应头设置好，就可以了。

	@GetMapping("/img")
	public void file(HttpServletResponse response) throws IOException {
		response.addHeader(HttpHeaders.CONTENT_DISPOSITION, "attachment;filename=AW2.jpeg");
		String imgPath = "E:\\AW.jpeg";
		Path path = Paths.get(imgPath);
		FileInputStream in = new FileInputStream(path.toFile());
		ServletOutputStream outputStream = response.getOutputStream();
		byte[] buffer = new byte[1024];
		int len;
		while ((len = in.read(buffer)) != -1) {
			outputStream.write(buffer, 0, len);
		}
	}

修改后，在浏览器访问，发现按照预期弹出了文件下载对话框

Debug过程

关于response缓冲区已满导致response提交，无法更改响应头的debug过程

然后我们调用response.isCommitted()

avatar
文章
阅读
粉丝
相关推荐
从0.9到3.0，超文本传输协议的进化史
945阅读
 · 
12点赞
Node.js 内置模块大揭秘：超文本传输协议（http）模块
1.0k阅读
 · 
57点赞
HTTP超文本传输协议
299阅读
 · 
0点赞
web基础及http协议
1.7k阅读
 · 
1点赞
【法医奇遇记】法医破案之HTTP协议状态码探秘
180k阅读
 · 
52点赞