ESP8266 – ESP8266WebServer库 – streamFile

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

说明

在ESP8266开发板所建立的物联网服务器在运行过程中,如果有客户端向服务器发送HTTP请求,服务器将会对客户端发送响应信息。本函数可用于向服务器响应体中添加自定义信息。

请留意:可以实现此功能的函数共有三个。一个是sendContent,一个是sendContent_P,还有一个是streamFile。这三个函数虽然功能相同,但是他们所发送的信息存储位置有很大区别。

sendContent: sendContent函数所发送的信息通常是程序中的一个字符串。该函数的优点是直接调用程序内字符串,这个操作比起两外两种方法来说更加简单直接。但是其缺点是,由于存储发送信息的字符串是在程序中的,这会占用开发板的动态内存空间。因此,使用sendContent函数时,发送信息的大小受到了限制。

sendContent_P:当我们使用sendContent_P时,发送的响应信息必须存储在程序存储空间。这一特点大大优化了程序内存占用。因此sendContent_P对于我们在发送较大的响应信息时非常有帮助。但是sendContent_P的信息仍是写在程序中,如果发送的信息需要分为多个文件存储,使用sendContent_P函数是无法胜任的。

streamFile:使用streamFile函数来发送响应信息是最推荐的操作方法。因为streamFile利用了ESP8266开发板的闪存文件系统来存储发送的信息内容。可以说streamFile函数既可以节省程序内存空间,又允许我们将需要发送的信息分为多个文件进行保存。但是使用streamFile时需要我们使用Arduino IDE的闪存文件上传工具预先将文件上传到闪存中。这一操作可能有些朋友不甚了解。不过您可以通过《零基础入门学用物联网》免费视频教程中的“闪存文件系统”部分,了解具体操作方法。

语法

streamFile(file, contentType)

参数

file – 存储有响应信息的闪存文件对象
contentType(可选参数) – 响应信息系类型 (const String& )

语法

发送的文件大小,类型:size_t

示例程序

首先请将以下下载链接中的网页文件上传到ESP8266的闪存文件系统中。如果您对这一操作不甚了解,可以通过《零基础入门学用物联网》免费视频教程中的“闪存文件系统”部分,了解具体操作方法。

接下来请将示例程序中的WiFi连接信息修改后并且将本示例程序上传ESP8266开发板后,开发板随即会自动连接WiFi。WiFi连接成功后,您将可以从串口监视器获取当前ESP8266开发板的IP。

假设您的开发板IP地址为192.168.0.106,那么接下来您可以通过浏览器输入以下地址信息。

http://192.168.0.106/

接下来您将在浏览器中看到以下页面。此页面内容正是ESP8266开发板通过streamFile函数将闪存中的文件内容发送给浏览器的。

esp8266-streamFile-example-result
esp8266-streamFile-example-result

示例程序下载

相关内容

send – 发送响应信息
sendHeader – 发送响应头
sendContent – 发送响应体
sendContent_P – 发送响应信息
setContentLength – 设置响应体长度

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