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

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

时间:2024-07-12 12:28:10浏览次数:14  
标签:教程 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」同样傻瓜式可以一键自动化、无人值守下载、安......