ESP8266 – ESP8266HTTPClient库 – setReuse

位置导航: ESP8266库 / ESP8266HTTPClient库 / 本页

说明

此函数用于设置ESP8266开发板在通过HTTP发送请求时,请求头中的keep-alive是否为”true”。

HTTP keep-alive 也称为 HTTP 长连接。它通过重用一个 TCP 连接来发送/接收多个 HTTP请求,来减少创建/关闭多个 TCP 连接的开销。

如果设置 keep-alive为true,则服务端在返回 response 后不关闭 TCP 连接;同样的,在接收完响应报文后,客户端也不关闭连接,发送下一个 HTTP 请求时会重用该连接。

语法

httpClient.setReuse(true)
httpClient.setReuse(false)

参数

返回值类型为布尔型。返回值的简要说明如下:
true: 启用请求头中的keep-alive
false: 禁用请求头中的keep-alive

返回值

示例程序

关于本函数的具体使用方法,请参考以下代码,尤其是代码中高亮的语句部分。

您将以下示例程序的WiFi连接信息修改后并且将本示例程序上传ESP8266开发板后,开发板随即会自动连接WiFi。WiFi连接成功后,ESP8266将会向www.example.com网站服务器发送HTTP请求并通过串口监视器将网站服务器响应信息通过串口监视器显示出来。

以下是本程序控制下,ESP8266发送的HTTP请求信息:

其中Connection: keep-alive部分即是通过以下程序中的httpClient.setReuse(true);来实现的。

相关内容

begin – 设置请求URL
setUserAgent – 设置请求头中的User-Agent
setAuthorization – 设置请求头中的Authorization
addHeader – 请求头中添加自定义信息
useHTTP10 – 设置http协议版本

位置导航: ESP8266库 / ESP8266HTTPClient库 / 本页