首页 > 其他分享 >【史上最全面ESP32教程】http通信

【史上最全面ESP32教程】http通信

时间：2024-07-12 12:28:10浏览次数：16  
标签：教程 http String int ESP32 HTTP void 函数

文章目录

前言

随着物联网（IoT）的快速发展，ESP32作为一款高性能、低功耗的Wi-Fi和蓝牙双模芯片，受到了广泛的关注和应用。在物联网设备中，HTTP协议是实现设备与服务器之间通信的常用协议。本文将介绍HTTP协议的基本概念及其常见应用场景。

HTTP协议是什么？

HTTP（HyperText Transfer Protocol，超文本传输协议）是一种用于传输超文本的应用层协议。它是万维网（WWW）的基础，定义了客户端（如浏览器）与服务器之间的通信规则。HTTP协议采用请求-响应模式，客户端发送请求，服务器返回响应。

HTTP协议的特点

  • 无状态：每次请求都是独立的，服务器不会保留之前请求的状态。
  • 灵活性：支持多种数据格式，如HTML、JSON、XML等。
  • 简单性：易于实现和使用，广泛应用于Web开发。

HTTP协议的常见应用

  • Web浏览：浏览器通过HTTP协议请求网页内容，服务器返回HTML页面。
  • API通信：物联网设备通过HTTP协议与服务器进行数据交互，如上传传感器数据或获取控制指令。
  • 文件传输：通过HTTP协议下载或上传文件，如软件更新或日志文件。

esp32 使用http通信

通信流程

  1. 连接网络
  2. 开始http通信
  3. 发送请求并获取响应
  4. 关闭连接

基础使用

我们需要使用HTTPClient类来进行通信
如果我们要开启一个http通信使用下面这个函数，参数为你要http通信的url：

bool begin(String url);

如果我们要GET一个内容，我们可以使用下面这个函数：

int GET();

他的返回值为状态码。
状态码有下面这些取值：

  • 200 OK：请求成功。具体的含义取决于HTTP方法。例如，GET方法表示资源已被获取并在消息体中传输。
  • 201 Created：请求成功，并且新的资源已经作为结果创建。这通常是在POST请求或某些PUT请求后发送的响应。
  • 204 No Content：没有要发送的内容，但头部可能有用。用户代理可能会使用新的头部更新此资源的缓存头部。
  • 301 Moved Permanently：请求的URL已永久移动到新位置，并且将来的引用应使用新的URL。
  • 400 Bad Request：服务器无法理解请求的语法。
  • 401 Unauthorized：请求需要用户验证。
  • 403 Forbidden：服务器理解请求，但拒绝执行它。
  • 404 Not Found：服务器找不到请求的资源。
  • 500 Internal Server Error：服务器遇到错误，无法完成请求

我们可以通过下面这个函数来获取GET的返回值：

String getString(void);

我们可以使用下面这个函数来关闭http连接：

void end(void);

#include <WiFi.h>
#include <HTTPClient.h>

const char* ssid = ".......";        // WiFi网络名称
const char* password = ".......";  // WiFi网络密码

void setup() {
  Serial.begin(115200);  // 初始化串口通信
  
  // 连接到WiFi网络
  WiFi.begin(ssid, password);
  
  while (WiFi.status() != WL_CONNECTED) {
    delay(1000);
    Serial.println("Connecting to WiFi...");
  }
  Serial.println("Connected to WiFi");

  // 设置HTTPClient对象
  HTTPClient http;
  
  // 为GET请求设置目标URL
  String url = "http://example.com/api/data"; // 替换为你的目标URL
  
  // 发送GET请求
  http.begin(url);
  
  // 发送请求并获取响应
  int httpResponseCode = http.GET();
  
  if (httpResponseCode > 0) { // 如果收到响应
    Serial.print("HTTP Response code: ");
    Serial.println(httpResponseCode); // 打印响应代码
    
    String payload = http.getString(); // 获取响应内容
    Serial.println(payload); // 打印响应内容
  } else {
    Serial.print("Error code: ");
    Serial.println(httpResponseCode); // 打印错误代码
  }
  
  http.end(); // 关闭连接
}

void loop() {
  // 程序主循环，此处不需要添加其他代码
}

HTTPClient 常用的函数

函数介绍：

void end(void);
  • 函数原型： void end(void);
  • 函数作用： 关闭HTTPClient对象，释放资源。
  • 函数参数： 无。
  • 返回值的作用： 无返回值。
  • 示例代码：
    HTTPClient http;
http.begin("http://example.com/api/data");
int httpResponseCode = http.GET();
// 处理响应
http.end(); // 关闭HTTP连接
bool connected(void);
  • 函数原型： bool connected(void);
  • 函数作用： 检查HTTPClient对象是否已连接到服务器。
  • 函数参数： 无。
  • 返回值的作用： 返回true表示连接成功，返回false表示未连接或连接已断开。
  • 示例代码：
    HTTPClient http;
if (http.connected()) {
  // 执行请求操作
} else {
  // 重新连接或处理断开连接情况
}
void setReuse(bool reuse);
  • 函数原型： void setReuse(bool reuse);
  • 函数作用： 设置是否启用HTTP keep-alive功能，允许多次复用同一TCP连接。
  • 函数参数：
    • reuse：布尔值，true表示启用keep-alive，false表示禁用。
  • 返回值的作用： 无返回值。
  • 示例代码：
    HTTPClient http;
http.setReuse(true); // 启用keep-alive
void setUserAgent(const String& userAgent);
  • 函数原型： void setUserAgent(const String& userAgent);
  • 函数作用： 设置HTTP请求的用户代理（User-Agent）标头。
  • 函数参数：
    • userAgent：String类型，要设置的用户代理字符串。
  • 返回值的作用： 无返回值。
  • 示例代码：
    HTTPClient http;
http.setUserAgent("ESP32 Client");
void setAuthorization(const char * user, const char * password);
  • 函数原型： void setAuthorization(const char * user, const char * password);
  • 函数作用： 设置基本身份验证的用户名和密码。
  • 函数参数：
    • user：用户名字符串。
    • password：密码字符串。
  • 返回值的作用： 无返回值。
  • 示例代码：
    HTTPClient http;
http.setAuthorization("username", "password");
int GET();
  • 函数原型： int GET();
  • 函数作用： 发送HTTP GET请求并接收响应。
  • 函数参数： 无。
  • 返回值的作用： 返回HTTP响应状态代码（例如200表示成功）。
  • 示例代码：
    HTTPClient http;
http.begin("http://example.com/api/data");
int httpResponseCode = http.GET();
// 处理响应
String getString(void);
  • 函数原型： String getString(void);
  • 函数作用： 获取HTTP响应的正文内容。
  • 函数参数： 无。
  • 返回值的作用： 返回包含HTTP响应正文内容的String对象。
  • 示例代码：
    HTTPClient http;
http.begin("http://example.com/api/data");
int httpResponseCode = http.GET();
if (httpResponseCode > 0) {
  String response = http.getString();
  Serial.println(response);
}
int PATCH(uint8_t * payload, size_t size);
  • 函数原型： int PATCH(uint8_t * payload, size_t size);
  • 函数作用： 发送HTTP PATCH请求并附带数据。
  • 函数参数：
    • payload：指向要发送数据的字节数组的指针。
    • size：要发送数据的大小（字节数）。
  • 返回值的作用： 返回HTTP响应状态代码。
  • 示例代码：
    HTTPClient http;
uint8_t data[] = { 0x01, 0x02, 0x03 };
int httpResponseCode = http.PATCH(data, sizeof(data));
int PATCH(String payload);
  • 函数原型： int PATCH(String payload);
  • 函数作用： 发送HTTP PATCH请求并附带数据（字符串形式）。
  • 函数参数：
    • payload：要发送的数据字符串。
  • 返回值的作用： 返回HTTP响应状态代码。
  • 示例代码：
    HTTPClient http;
String data = "key=value";
int httpResponseCode = http.PATCH(data);
int POST(uint8_t * payload, size_t size);
  • 函数原型： int POST(uint8_t * payload, size_t size);
  • 函数作用： 发送HTTP POST请求并附带数据。
  • 函数参数：
    • payload：指向要发送数据的字节数组的指针。
    • size：要发送数据的大小（字节数）。
  • 返回值的作用： 返回HTTP响应状态代码。
  • 示例代码：
    HTTPClient http;
uint8_t data[] = { 0x01, 0x02, 0x03 };
int httpResponseCode = http.POST(data, sizeof(data));
int POST(String payload);
  • 函数原型： int POST(String payload);
  • 函数作用： 发送HTTP POST请求并附带数据（字符串形式）。
  • 函数参数：
    • payload：要发送的数据字符串。
  • 返回值的作用： 返回HTTP响应状态代码。
  • 示例代码：
    HTTPClient http;
String data = "key=value";
int httpResponseCode = http.POST(data);
int PUT(uint8_t * payload, size_t size);
  • 函数原型： int PUT(uint8_t * payload, size_t size);
  • 函数作用： 发送HTTP PUT请求并附带数据。
  • 函数参数：
    • payload：指向要发送数据的字节数组的指针。
    • size：要发送数据的大小（字节数）。
  • 返回值的作用： 返回HTTP响应状态代码。
  • 示例代码：
    HTTPClient http;
uint8_t data[] = { 0x01, 0x02, 0x03 };
int httpResponseCode = http.PUT(data, sizeof(data));
int PUT(String payload);
  • 函数原型： int PUT(String payload);
  • 函数作用： 发送HTTP PUT请求并附带数据（字符串形式）。
  • 函数参数：
    • payload：要发送的数据字符串。
  • 返回值的作用： 返回HTTP响应状态代码。
  • 示例代码：
    HTTPClient http;
String data = "key=value";
int httpResponseCode = http.PUT(data);
int sendRequest(const char * type, String payload);
  • 函数原型： int sendRequest(const char * type, String payload);
  • 函数作用： 发送自定义类型的HTTP请求，并附带数据（字符串形式）。
  • 函数参数：
    • type：HTTP请求类型，例如 “GET”, “POST”, “PUT” 等。
    • payload：要发送的数据字符串。
  • 返回值的作用： 返回HTTP响应状态代码。
  • 示例代码：
    HTTPClient http;
int httpResponseCode = http.sendRequest("POST", "key=value");
void addHeader(const String& name, const String& value, bool first = false, bool replace = true);
  • 函数原型： void addHeader(const String& name, const String& value, bool first = false, bool replace = true);
  • 函数作用： 添加HTTP请求头。
  • 函数参数：
    • name：头部字段的名称。
    • value：头部字段的值。
    • first：可选参数，默认为false。如果为true，则将新头部添加到头部列表的开头。
    • replace：可选参数，默认为true。如果为true，则替换现有的同名头部；如果为false，则添加到现有同名头部后面。
  • 返回值的作用： 无返回值。
  • 示例代码：
    HTTPClient http;
http.addHeader("Content-Type", "application/json");
void collectHeaders(const char* headerKeys[], const size_t headerKeysCount);
  • 函数原型： void collectHeaders(const char* headerKeys[], const size_t headerKeysCount);
  • 函数作用： 指定要收集的HTTP响应头。
  • 函数参数：
    • headerKeys：指向包含要收集的头部字段名称的数组。
    • headerKeysCount：数组中头部字段名称的数量。
  • 返回值的作用： 无返回值。
  • 示例代码：
    const char* headersToCollect[] = { "Content-Length", "Content-Type" };
HTTPClient http;
http.collectHeaders(headersToCollect, sizeof(headersToCollect) / sizeof(headersToCollect[0]));
String header(const char* name);
  • 函数原型： String header(const char* name);
  • 函数作用： 获取指定名称的HTTP响应头值。
  • 函数参数：
    • name：要获取的头部字段名称。
  • 返回值的作用： 返回包含头部字段值的String对象。
  • 示例代码：
    HTTPClient http;
http.begin("http://example.com/api/data");
int httpResponseCode = http.GET();
String contentType = http.header("Content-Type");
String header(size_t i);
  • 函数原型： String header(size_t i);
  • 函数作用： 获取指定索引位置的HTTP响应头值。
  • 函数参数：
    • i：要获取的头部字段的索引（从0开始）。
  • 返回值的作用： 返回包含头部字段值的String对象。
  • 示例代码：
    HTTPClient http;
http.begin("http://example.com/api/data");
int httpResponseCode = http.GET();
String firstHeader = http.header(0);
String headerName(size_t i);
  • 函数原型： String headerName(size_t i);
  • 函数作用： 获取指定索引位置的HTTP响应头名称。
  • 函数参数：
    • i：要获取的头部字段的索引（从0开始）。
  • 返回值的作用： 返回包含头部字段名称的String对象。
  • 示例代码：
    HTTPClient http;
http.begin("http://example.com/api/data");
int httpResponseCode = http.GET();
String firstName = http.headerName(0);
int headers();
  • 函数原型： int headers();
  • 函数作用： 获取HTTP响应中头部字段的数量。
  • 函数参数： 无。
  • 返回值的作用： 返回头部字段的数量。
  • 示例代码：
    HTTPClient http;
http.begin("http://example.com/api/data");
int httpResponseCode = http.GET();
int numHeaders = http.headers();
bool hasHeader(const char* name);
  • 函数原型： bool hasHeader(const char* name);
  • 函数作用： 检查HTTP响应中是否存在指定名称的头部字段。
  • 函数参数：
    • name：要检查

的头部字段名称。

  • 返回值的作用： 如果存在指定名称的头部字段，则返回true；否则返回false。
  • 示例代码：
    HTTPClient http;
http.begin("http://example.com/api/data");
int httpResponseCode = http.GET();
if (http.hasHeader("Content-Type")) {
  // 处理存在Content-Type头部的情况
}
int getSize(void);
  • 函数原型： int getSize(void);
  • 函数作用： 获取HTTP响应正文的大小（字节数）。
  • 函数参数： 无。
  • 返回值的作用： 返回HTTP响应正文的大小。
  • 示例代码：
    HTTPClient http;
http.begin("http://example.com/api/data");
int httpResponseCode = http.GET();
int contentSize = http.getSize();
const String &getLocation(void);
  • 函数原型： const String &getLocation(void);
  • 函数作用： 获取HTTP响应中的 Location 头部字段的值，用于处理重定向。
  • 函数参数： 无。
  • 返回值的作用： 返回包含 Location 头部字段值的String对象的引用。
  • 示例代码：
    HTTPClient http;
http.begin("http://example.com/api/data");
int httpResponseCode = http.GET();
String redirectLocation = http.getLocation();
WiFiClient& getStream(void);
  • 函数原型： WiFiClient& getStream(void);
  • 函数作用： 获取底层的WiFiClient对象，用于直接访问底层网络连接。
  • 函数参数： 无。
  • 返回值的作用： 返回一个WiFiClient对象的引用。
  • 示例代码：
    HTTPClient http;
http.begin("http://example.com/api/data");
int httpResponseCode = http.GET();
WiFiClient& stream = http.getStream();
WiFiClient* getStreamPtr(void);
  • 函数原型： WiFiClient* getStreamPtr(void);
  • 函数作用： 获取底层的WiFiClient对象指针，用于直接访问底层网络连接。
  • 函数参数： 无。
  • 返回值的作用： 返回一个指向WiFiClient对象的指针。
  • 示例代码：
    HTTPClient http;
http.begin("http://example.com/api/data");
int httpResponseCode = http.GET();
WiFiClient* streamPtr = http.getStreamPtr();
int writeToStream(Stream* stream);
  • 函数原型： int writeToStream(Stream* stream);
  • 函数作用： 将HTTP响应内容写入给定的流（Stream）对象。
  • 函数参数：
    • stream：指向目标流对象的指针。
  • 返回值的作用： 返回写入流的字节数。
  • 示例代码：
    HTTPClient http;
http.begin("http://example.com/api/data");
int httpResponseCode = http.GET();
WiFiClient client;
int bytesWritten = http.writeToStream(&client);
String getString(void);
  • 函数原型： String getString(void);
  • 函数作用： 获取HTTP响应的正文内容。
  • 函数参数： 无。
  • 返回值的作用： 返回包含HTTP响应正文内容的String对象。
  • 示例代码：
    HTTPClient http;
http.begin("http://example.com/api/data");
int httpResponseCode = http.GET();
String response = http.getString();
static String errorToString(int error);
  • 函数原型： static String errorToString(int error);
  • 函数作用： 将HTTPClient库中的错误代码转换为对应的错误消息字符串。
  • 函数参数：
    • error：HTTPClient库中定义的错误代码。
  • 返回值的作用： 返回表示错误消息的String对象。
  • 示例代码：
    HTTPClient http;
http.begin("http://example.com/api/data");
int httpResponseCode = http.GET();
if (httpResponseCode < 0) {
  String errorMessage = HTTPClient::errorToString(httpResponseCode);
  Serial.println(errorMessage);
}
void setCookieJar(CookieJar* cookieJar);
  • 函数原型： void setCookieJar(CookieJar* cookieJar);
  • 函数作用： 设置用于管理HTTP请求和响应中Cookie的CookieJar对象。
  • 函数参数：
    • cookieJar：指向CookieJar对象的指针。
  • 返回值的作用： 无返回值。
  • 示例代码：
    CookieJar cookieJar;
HTTPClient http;
http.setCookieJar(&cookieJar);
void resetCookieJar();
  • 函数原型： void resetCookieJar();
  • 函数作用： 重置CookieJar，清除所有保存的Cookie。
  • 函数参数： 无。
  • 返回值的作用： 无返回值。
  • 示例代码：
    HTTPClient http;
http.resetCookieJar();
void clearAllCookies();
  • 函数原型： void clearAllCookies();
  • 函数作用： 清除所有保存的Cookie，无论它们是否过期。
  • 函数参数： 无。
  • 返回值的作用： 无返回值。
  • 示例代码：
    HTTPClient http;
http.clearAllCookies();

总结

本文简要介绍了HTTP协议的基本概念及其在物联网设备中的常见应用。HTTP协议作为一种简单、灵活的通信协议，广泛应用于Web开发和物联网设备中。希望本文能帮助读者更好地理解HTTP协议及其在ESP32中的应用。

标签：教程,http,String,int,ESP32,HTTP,void,函数
From： https://blog.csdn.net/m0_62599305/article/details/140331023

相关文章

  • 闯荡西游之路，续写经典传奇，大话西游图文架设教程
    前言这次给大家带来的是我精心准备了很久的，也是大家呼声很高的大话西游，云集西游版本，安卓苹果双端，非变态版本，包含天梯、星阵、八卦等玩法，游戏内置GM后台，快来体验一下吧~本文讲解大话西游架设教程，闯荡西游路，天地任我行！不知道这款IP游戏，是不是有你的青春呢~我架设的大话西游请关......
  • HTTPS、SSL和TLS
    1、HTTPS相关概念1.1、对称加密和非对称加密简单描述一下，加密密钥和解密密钥相同，则称为对称加密；加密密钥和解密密钥不同，则称为非对称加密；对称加密比非对称加密的效率要高。详细的描述的可以查看对称加密与非对称加密详解-浪迹天涯的派大星-博客园(cnblogs.com)1.2、中间......
  • 仙侠天花板，圆你土豪梦，上古传说手游详细图文架设教程
    前言这次给大家带来的是一款我的心头好，绝对是我所有架设游戏里排名前三的，一款经典的仙侠手游，安卓苹果双端，画质精美程度真的没有哪几个游戏可以比得上，故事情节加上背景音乐绝对值得沉浸其中慢慢玩，最主要的是这款游戏真的是基本没有任何BUG，玩法功能非常多，这么说吧，给你全后台所有功......
  • 在springboot 中使用Apache HttpClient 4的详细示例
    在SpringBoot中使用ApacheHttpClient，可以通过配置HttpClient的Bean并使用它来发起HTTP请求。下面是一个详细的示例，展示了如何在SpringBoot应用中集成和使用ApacheHttpClient。步骤1：添加依赖在你的pom.xml文件中添加ApacheHttpClient的依赖：<dependency>......
  • 在springboot 中使用Apache HttpClient 5的详细示例
    ApacheHttpComponentsClient5.x是HttpClient的最新版本，与4.x系列相比，5.x系列进行了许多改进和重构，提供了更现代的API和更好的性能。以下是使用步骤步骤1：添加依赖在你的pom.xml文件中添加ApacheHttpClient5.x的依赖：<dependency><groupId>org.apache.htt......
  • 【项目实战】深入解析HTTP状态码：401 Unauthorized
    在网络通信过程中，HTTP状态码对于服务器和客户端之间的信息交流起着至关重要的作用。其中，401Unauthorized（未授权）是一个非常关键的状态码，它涉及到安全认证的方面。本文将详细介绍401状态码，分析其原因，并提供针对性的解决方案，以帮助开发者和用户更好地理解和处理这种情况。1.......
  • 一类账户认证API在Java、Python、PHP中的使用教程
    随着金融科技的快速发展，一类账户认证在金融服务中扮演着越来越重要的角色。对于个人和企业而言，拥有一个高级别的账户不仅能提高交易效率，还能享受到更多优惠和服务。然而，这也带来了账户安全的挑战和风险。为了确保账户的真实性和合法性，一类账户认证应运而生。它通过对用户......
  • 【项目实战】深入解析HTTP状态码：405 Method Not Allowed
    HTTP状态码在网站和网络应用的开发中扮演着重要角色，其中405MethodNotAllowed是一种相对常见但有时会被误解的状态码。本文将详细解释405状态码的含义、发生的原因，并提供解决方法，以帮助开发者和网站管理员更好地处理这种情况。1.状态码简介405MethodNotAllowed是一......
  • ESP32纯Cj简单实现图片上传阿里云OSS
    对于嵌入式设备资源较少或者运行环境较简单的环境下，如果只是简单上传一张图片到阿里云OSS服务器的话，移植阿里云OSS的SDK就是一件性价比很低而且不一定能实现的事情了。那就得考虑自己实现一套简单的、最基础的图片上传功能。阿里云OSS提供了RESTAPI方式的图片上传接口，即通过HTTP......
  • [ Office安装 ] Mocreak 傻瓜式安装教程
    微软Office办公软件安装除了官方的安装包外，还可以通过部署工具来安装各种版本的Office，其中目前比较流行的是OfficeToolPlus和Office2013-2021C2RInstall这两个软件。今天再分享一个类似的Office部署工具「Mocreak」同样傻瓜式可以一键自动化、无人值守下载、安......

赞助商

阅读排行

网站主页关于我们联系我们网站地图

本网站内容转载自其他媒体，侵权联系[admin##ips99.com]。

Copyright © 2020-2023 IPS99 版权所有 IPS99