NAppGUI网络编程指南：HTTP请求与Cookie管理，几行C代码搞定

NAppGUI网络编程指南：HTTP请求与Cookie管理，几行C代码搞定

【免费下载链接】nappgui_srcSDK for building cross-platform desktop apps in ANSI-C项目地址: https://gitcode.com/gh_mirrors/na/nappgui_src

NAppGUI是一个用 ANSI-C 编写的跨平台桌面应用 SDK，它的网络编程能力同样令人惊喜。如果你正在寻找用 C 语言实现 HTTP 请求与 Cookie 管理的轻量方案，NAppGUI 的inet模块就是答案——只需几行代码，就能完成 GET、POST、HTTPS 请求以及 Cookie 的自动保存与读取，完全不用接触繁琐的底层 socket 细节。

NAppGUI 是什么？一个 C 语言的跨平台开发利器

NAppGUI 是一个开源的跨平台 C SDK，支持 Windows、macOS 和 Linux，帮助开发者用纯 C 语言构建原生桌面应用。它分为多个模块：gui（界面）、draw2d（绘图）、geom2d（几何计算），以及本文的主角——inet（网络编程模块）。

与传统 C 网络库不同，NAppGUI 将 HTTP 协议封装为简单直观的 API，你不需要了解 TCP 握手、报文解析，甚至不需要手动处理重定向和 Cookie，这正是它"几行 C 代码搞定网络编程"的底气所在。

快速开始：创建 HTTP 连接只需一行代码

在 src/inet/httpreq.h 中，NAppGUI 提供了完整的 HTTP 客户端接口。创建连接的方式非常直观：

• http_create(host, port)：创建普通 HTTP 连接
• http_secure(host, port)：创建 HTTPS 加密连接

比如访问http://example.com只需要：

Http *http = http_create("example.com", 80);

想要加密传输？把http_create换成http_secure，端口改为 443 即可。一行代码完成连接创建，无需任何初始化配置。

发起 HTTP 请求：GET、POST 的核心写法

创建连接后，调用请求方法发送数据。NAppGUI 支持全部主流 HTTP 方法：http_get、http_post、http_put、http_patch、http_delete，它们在 httpreq.c 中实现，参数完全一致，学习成本极低。

以项目自带的 demo/products/prmodel.c 为例，真实的网络请求代码只有短短几行：

Http *http = http_create("serv.nappgui.com", 80); if (http_get(http, "/dproducts.php", NULL, 0, NULL) == TRUE) { uint32_t status = http_response_status(http); if (status >= 200 && status <= 299) { Stream *stm = stm_memory(4096); http_response_body(http, stm, NULL); } } http_destroy(&http);

这段代码完成了"连接服务器 → 发送 GET 请求 → 检查状态码 → 读取响应体"的完整流程，清爽利落。

带数据的 POST 请求怎么写？

POST 提交表单或 JSON 数据同样简单，只需把数据指针和长度传给http_post：

const char_t *json = "{\"name\":\"NAppGUI\"}"; http_post(http, "/api/upload", (const byte_t *)json, str_len_c(json), NULL);

智能响应处理：状态码、响应头一网打尽

网络编程中最麻烦的响应解析，NAppGUI 也已经帮你封装好了。发送请求后，你可以通过一系列http_response_*函数读取服务器返回的信息：

状态码是判断请求成败的关键，配合ekIOK等错误码（定义在 src/inet/inet.hxx），你可以轻松处理超时、服务器错误、网络不通等各种异常情况。

Cookie 管理：自动保存、搜索与删除

Cookie 是 Web 开发绕不开的话题。NAppGUI 的 Cookie 管理功能同样强大，所有接口都在 httpreq.h 中：

• 策略控制：http_cookies_policy(http, ekCOOKIES_ALL)开启 Cookie 自动保存；ekCOOKIES_OFF则关闭
• 查询 Cookie：http_cookie_search(http, "session_id")按名称查找 Cookie 值
• 遍历所有 Cookie：http_cookies_size获取数量，配合http_cookie_name/http_cookie_value遍历
• 删除 Cookie：http_cookie_delete删除单个，http_cookie_delete_all一键清空

这意味着你的 C 程序可以像浏览器一样保持登录状态：第一次请求拿到 Cookie 后自动保存，后续请求自动携带，全程无需手工拼装Cookie头字段。

高级技巧：URL 一步直达下载

不想手动拆分 URL？NAppGUI 提供了更省事的http_dget(url, &result, &error)函数，传入完整 URL 即可一步完成 GET 请求并返回响应流。demo 目录下的 urlimg/urlimg.c 就展示了如何从 URL 直接下载图片，还支持判断 URL 是否可访问（http_exists）。

实战组合：HTTP 请求 + JSON 解析

网络请求通常和数据处理配合使用。NAppGUI 的encode模块提供了 JSON 解析功能，配合 demo/htjson/htjson.c 中的示例，你可以把服务器返回的 JSON 直接映射为 C 结构体：

Stream *stm = http_dget("https://api.example.com/data", NULL, NULL); Products *json = json_read(stm, NULL, Products); /* json->data 就是解析好的产品数组 */

从"发起 HTTP 请求"到"解析 JSON 数据"再到"渲染到桌面界面"，NAppGUI 提供了完整闭环，非常适合构建轻量级桌面客户端。

结语：用 C 语言也能写出优雅的网络应用

NAppGUI 用实践证明，C 语言网络编程不必是噩梦。http_create创建连接、http_get发起请求、http_cookies_policy管理 Cookie、http_response_body读取数据——这套简洁的 API 设计让跨平台桌面应用的网络功能触手可及。如果你正在用 C 语言开发桌面工具，不妨打开demo/products和demo/urlimg两个示例，亲手体验一下"几行 C 代码搞定 HTTP 请求"的快感吧！🚀

【免费下载链接】nappgui_srcSDK for building cross-platform desktop apps in ANSI-C项目地址: https://gitcode.com/gh_mirrors/na/nappgui_src