1.示例程序
WebClient 软件包提供两个 HTTP Client 示例程序, 分别用于演示软件包支持的 GET 和 POST 功能,完成数据的上传与下载。
示例文件
示例程序路径 | 说明 |
---|---|
samples/webclient_get_sample.c | GET 请求测试例程 |
samples/webclient_post_sample.c | POST 请求测试例程 |
2.准备工作
2.1获取软件包
-
menuconfig 配置获取软件包和示例代码
打开 RT-Thread 提供的 ENV 工具,使用 menuconfig 配置软件包。
启用 WebClient 软件包,并配置使能测试例程(Enable webclient GET/POST samples),如下所示:
RT-Thread online packages
IoT - internet of things --->
[*] WebClient: A HTTP/HTTPS Client for RT-Thread
[ ] Enable debug log output
[*] Enable webclient GET/POST samples # 开启 WebClient 测试例程
[ ] Enable file download feature support
Select TLS mode (Not support) --->
Version (latest) ---> # 开启使用最新版本软件包
- 使用
pkgs --update
命令下载软件包 - 编译下载
特别注意:如果要开启TLS加密功能,编译时会依赖mebtls服务,主要的两个文件tls_client.c/tls_client.h.如果只是简单的从移植webclient和mbedtls两个包是不会有这两个文件的,所以要采取RTT ENV的方式先获取.当然啦,如果你直接玩RTT,那就按照官网操作吧.
3.启动例程
本例程使用的测试网站是 RT-Thread 系统的官方网站。GET 请求示例可以从网站中获取并打印显示文件内容;POST 请求示例可以上传数据到测试网站,测试网站会响应相同的数据。
HTTP 收发数据包括头部数据和正文数据两部分,以下称头部数据为
header 数据
,正文数据为body 数据
。
3.1GET 请求示例
GET 请求示例流程:
- 创建 client 会话结构体
- client 发送 GET 请求 header 数据(使用默认header 数据)
- server 响应 header 数据和 body 数据
- 打印 server 响应 body 数据
- GET 请求测试完成/失败
GET 请求示例使用方式有如下两种:
- 在 MSH 中使用命令
web_get_test
执行 GET 请求示例程序,可以获取并打印显示默认网址下载的文件信息;在 MSH 中使用命令web_get_test -s
执行 POST 请求示例程序,使用简化接口(webclient_request 接口)发送 GET请求,适用于简短数据的收发。如下图 LOG 显示:
msh />web_get_test
webclient get response data:
RT-Thread is an open source IoT operating system from China, which has strong scalability: from a tiny kernel running on a tiny core, for example ARM Cortex-M0, or Cortex-M3/4/7, to a rich feature system running on MIPS32, ARM Cortex-A8, ARM Cortex-A9 DualCore etc.
msh />web_get_test -s
webclient send get request by simplify request interface.
webclient get response data:
RT-Thread is an open source IoT operating system from China, which has strong scalability: from a tiny kernel running on a tiny core, for example ARM Cortex-M0, or Cortex-M3/4/7, to a rich feature system running on MIPS32, ARM Cortex-A8, ARM Cortex-A9 DualCore etc.
msh />
- 在 MSH 中使用命令
web_get_test [URI]
或web_get_test -s [URI]
格式命令执行 GET 请求示例程序,其中 URI 为用户自定义的支持 GET 请求的地址。
3.2POST 请求示例
POST 请求示例流程如下:
- 创建 client 会话结构体
- 拼接 POST 请求需要的 header 数据
- client 发送拼接的 header 数据和 body 数据
- server 响应 header 数据和 body 数据
- 打印 server 响应 body 数据
- POST 请求测试完成/失败
POST 请求示例使用方式有如下两种:
- 在 MSH 中使用命令
web_post_test
执行 POST 请求示例程序,可以获取并打印显示响应数据(默认 POST 请求的地址是类似于回显的地址,会返回上传的数据);在 MSH 中使用命令web_post_test -s
执行 POST 请求示例程序,使用简化接口(webclient_request 接口)发送 POST 请求,适用于简短数据的收发。如下图 LOG 显示:
msh />web_post_test
webclient post response data :
RT-Thread is an open source IoT operating system from China!
msh />
msh />web_post_test -s
webclient send post request by simplify request interface.
webclient post response data:
RT-Thread is an open source IoT operating system from China!
msh />
- 在 MSH 中使用命令
web_post_test [URI]
或者web_post_test -s [URI]
格式命令执行 POST 请求示例程序,其中 URI 为用户自定义的支持 POST 请求的地址。