RT-Thread-基于官方 webclient 的 http clientRT-Thread问答社区

基于官方 webclient 的 http client

发布于 2020-01-05 16:20:36 浏览：3018 订阅该版

该库简单的封装了官方的 webclient API (并未对文件的请求API进行封装，原因是这个API需要过多的内存)
创建该库的原因是因为官方的 webclient API 均是阻塞型的，会造成线程高延迟 (例如我的线程是屏幕的刷新)

该库提供以下 API

异步操作API:
```c
/* --------------------------   Asynchronous API   -------------------------- */
int http_get(const char *url, http_result_cb_t cb);
int http_post(const char *url, const char *data, http_result_cb_t cb);
int http_send(const char *url, const char *type, const char *data, http_result_cb_t cb);
/* --------------------------   Asynchronous API   -------------------------- */
```

异步API是创建了一个线程去执行的这个请求的，请求成功并且有数据返回的时候，才会调用回调函数（前提是你有提供回调函数）
例如：
```c
char *ad_text;
char *ad_text_color;
void get_text_result_cb(char *buf, uint16_t len)
{
 printf("len:%d %s ", strlen(buf), buf);
 cJSON *json = cJSON_Parse(buf);
 cJSON *cotent = cJSON_GetObjectItem(json, "content");
 cJSON *color = cJSON_GetObjectItem(json, "color");
 char *content_str = cJSON_GetStringValue(cotent);
 char *color_str = cJSON_GetStringValue(color);
 printf(" content:%s color:#%lx ", content_str, color_str);
 if (content_str)
 {
 if (ad_text)
 cJSON_free(ad_text);
 ad_text = content_str;
 }
 if (color_str)
 {
 if (ad_text_color)
 cJSON_free(ad_text_color);
 ad_text_color = color_str;
 }
 // #是作为颜色的结束标志，详细可以查看littlevGL官网文档
 lv_label_set_text_fmt(label2, "%s %s#", ad_text_color, ad_text);
}
void get_text(void)
{
 http_get("http://" URL ":" PORT "/ad?cmd=get", get_text_result_cb);
}
```
阻塞型的API:
```c
/* -------------------------- synchronous API -------------------------- */
char* http_get_sync(const char *url);
char* http_post_sync(const char *url, const char *data);
char* http_sync(const char *url, const char *type, const char *data);
/* -------------------------- synchronous API -------------------------- */
```
阻塞型API 是封装了官方的 webclient 的过程，请求成功并且有数据返回的会把返回一个缓冲区给你（这些API会申请与返回内容一样大的内存空间去存储它）
使用完之后记得要释放掉这个缓冲区，不然会造成内存溢出的哟。

并提供了一个低内存消耗的文件请求API:
```c
char http_get_file(const char *url, const char *path, http_get_file_cb_t cb);
```
例如：
```c
extern void Jpeg_Dec_file(const char *path);
#define IMAGE_FILE_NAME "image.jpeg"
void get_image_cb(void)
{
    Jpeg_Dec_file(IMAGE_FILE_NAME); //  解析jpeg文件并刷新到屏幕
}
static void get_image(void)
{
    http_get_file("http://" URL ":" PORT "/ad?cmd=get_image", "/" IMAGE_FILE_NAME, get_image_cb);
}
```
倘若你系统中没有挂载存储就不要使用这个 API 啦

以下是两个回调函数的定义:
```c
typedef void (*http_result_cb_t)(char *buf, uint16_t len);
typedef void (*http_get_file_cb_t)(void);
```
以下是库文件，欢迎大家测试。
大家记得用完之后反馈下问题和使用感受哟。
![http_client.h](/uploads/202001/05/161922jzxxiazqf0aaiiif.attach)
![http_client.c](/uploads/202001/05/161922oony74zovz0b7bda.attach)

上面两个例子展示：
```
 \ | /
- RT -     Thread Operating System
 / | \     4.0.3 build Jan  5 2020
 2006 - 2019 Copyright by rt-thread team
[0m[D/drv.sram] sram init success, mapped at 0x68000000, size is 1048576 bytes, data width is 16[0m
[SFUD] Find a Winbond flash chip. Size is 16777216 bytes.
[SFUD] W25Q128 flash device is initialize success.
[32m[I/sal.skt] Socket Abstraction Layer initialize success.[0m
LCD ID:1963
[32m[I/at.clnt] AT client(V1.3.0) on device uart3 initialize success.[0m
msh />[32m[I/at.dev.esp] esp0 device wifi is connected.[0m
[32m[I/at.dev.esp] esp0 device network initialize successfully.[0m
[31m[E/at.clnt] execute command (AT+CIPDNS_CUR?) failed![0m
[33m[W/at.dev.esp] please check and update esp0 device firmware to support the "AT+CIPDNS_CUR?" cmd.[0m
[31m[E/at.clnt] execute command (AT+CIPDNS_CUR?) failed![0m
[33m[W/at.dev.esp] please check and update esp0 device firmware to support the "AT+CIPDNS_CUR?" cmd.[0m
last:0        Now:1578206928
len:253
{"content":"iu这些覅u上的覅速度和反思u发货是到付还是地方和但是fish的方式的好的放声大哭积分回馈圣诞节放假是东方航空技术的回复收到反馈说的的回复卡死的回复技术的开发","color":"#8080ff"}

content:iu这些覅u上的覅速度和反思u发货是到付还是地方和但是fish的方式的好的放声大哭积分回馈圣诞节放假是东方航空技术的回复收到反馈说的的回复卡死的回复技术的开发
color:#2001bad0
[I/http.get.file] This file size is : 19.61Kb.

0%
3%
6%
10%
13%
16%
20%
23%
26%
30%
33%
36%
40%
43%
46%
50%
53%
56%
60%
63%
66%
70%
73%
76%
80%
83%
86%
90%
93%
96%
OK
```
![b1839a4f7dcf2da9cff7745e2499950.jpg](/uploads/202001/05/164331u38ih944cm813899.jpg)