别再只用Curl了！用libhv的HttpClient类，5分钟搞定C++里的GET/POST请求
别再只用Curl了！用libhv的HttpClient类，5分钟搞定C++里的GET/POST请求
如果你还在用Curl命令行工具或者复杂的libcurl API来处理C++项目中的HTTP请求，那么是时候认识一下libhv了。这个轻量级、高性能的网络库，用起来简直像在写Python一样简单。今天我们就来聊聊如何用libhv的HttpClient类，在C++项目中优雅地处理各种HTTP请求。
1. 为什么选择libhv而不是Curl？
Curl确实是个强大的工具，但在C++项目里直接调用curl命令行或者使用libcurl的C API，总让人觉得不够"现代"。libhv的HttpClient类则提供了更符合C++开发者习惯的接口设计：
- 代码更简洁：相比libcurl需要设置大量回调函数，libhv的API设计更加直观
- 类型更安全：充分利用C++的特性，避免C风格API中的各种指针和内存管理问题
- 功能更全面：内置JSON、表单等常见数据格式的处理，开箱即用
- 性能更优：基于事件驱动模型，支持高并发请求
// 对比示例：libhv vs libcurl // libhv的GET请求 auto resp = requests::get("http://example.com"); // libcurl的GET请求 CURL* curl = curl_easy_init(); curl_easy_setopt(curl, CURLOPT_URL, "http://example.com"); curl_easy_setopt(curl, CURLOPT_WRITEFUNCTION, write_callback); curl_easy_perform(curl); curl_easy_cleanup(curl);2. 5分钟快速上手libhv HttpClient
2.1 安装与配置
首先，你需要在项目中引入libhv。最方便的方式是通过vcpkg：
vcpkg install libhv或者直接从GitHub克隆源码编译：
git clone https://github.com/ithewei/libhv.git cd libhv mkdir build && cd build cmake .. make && make install2.2 基本GET/POST请求
libhv的HttpClient使用起来异常简单，下面是一个完整的示例：
#include "requests.h" // libhv提供的简化接口 int main() { // 同步GET请求 auto resp = requests::get("http://httpbin.org/get"); if (resp) { printf("Status: %d %s\n", resp->status_code, resp->status_message()); printf("Body: %s\n", resp->body.c_str()); } // 同步POST请求（JSON数据） auto json_resp = requests::post("http://httpbin.org/post", R"({"key":"value"})"); // 同步POST请求（表单数据） auto form_resp = requests::post("http://httpbin.org/post", "name=libhv&type=awesome"); return 0; }2.3 处理各种响应数据
libhv内置了对常见数据格式的支持：
| 数据类型 | 处理方法 | 示例 |
|---|---|---|
| JSON | resp->GetJson() | auto json = resp->GetJson(); |
| 表单数据 | resp->GetFormData() | auto value = resp->GetFormData("key"); |
| 文本 | resp->body | std::string text = resp->body; |
| 二进制 | resp->body | std::vector<char> data(resp->body.begin(), resp->body.end()); |
3. 高级用法：异步请求与自定义配置
3.1 异步请求处理
对于需要高并发的场景，异步请求是更好的选择：
#include "requests.h" #include "hthread.h" void async_callback(const HttpResponsePtr& resp) { if (resp) { printf("Async response: %d %s\n", resp->status_code, resp->body.c_str()); } } int main() { // 异步GET请求 requests::getAsync("http://httpbin.org/get", async_callback); // 异步POST请求（自定义请求） HttpRequestPtr req(new HttpRequest); req->method = HTTP_POST; req->url = "http://httpbin.org/post"; req->headers["Content-Type"] = "application/json"; req->body = R"({"async":true})"; http_client_send_async(req, async_callback); // 主线程继续执行其他任务... hv_delay(3000); // 等待异步请求完成 return 0; }3.2 请求配置详解
HttpRequest类提供了丰富的配置选项：
HttpRequestPtr req(new HttpRequest); req->method = HTTP_GET; req->url = "http://example.com/api"; // 设置头部 req->headers["Accept"] = "application/json"; req->headers["Authorization"] = "Bearer token123"; // 设置超时（秒） req->timeout = 10; req->connect_timeout = 5; // 设置代理 req->SetProxy("127.0.0.1", 8888); // 允许重定向 req->AllowRedirect(true); // 设置重试策略 req->SetRetry(3, 1000); // 重试3次，每次间隔1秒4. 实战：构建一个完整的HTTP客户端
让我们把这些知识点整合起来，构建一个功能完整的HTTP客户端：
#include "requests.h" #include <iostream> class MyHttpClient { public: // 获取JSON数据 hv::Json fetchJson(const std::string& url) { auto resp = requests::get(url); if (!resp || resp->status_code != HTTP_STATUS_OK) { throw std::runtime_error("Request failed"); } return resp->GetJson(); } // 上传文件 bool uploadFile(const std::string& url, const std::string& filepath) { HttpRequestPtr req(new HttpRequest); req->method = HTTP_POST; req->url = url; req->SetFormFile("file", filepath.c_str()); auto resp = requests::request(req); return resp && resp->status_code == HTTP_STATUS_OK; } // 带认证的API请求 hv::Json apiRequest(const std::string& url, const std::string& token) { HttpRequestPtr req(new HttpRequest); req->method = HTTP_GET; req->url = url; req->headers["Authorization"] = "Bearer " + token; auto resp = requests::request(req); if (!resp || resp->status_code != HTTP_STATUS_OK) { throw std::runtime_error("API request failed"); } return resp->GetJson(); } }; int main() { MyHttpClient client; try { // 示例：获取公开API数据 auto data = client.fetchJson("http://httpbin.org/json"); std::cout << "Fetched data: " << data.dump(2) << std::endl; // 示例：带认证的请求 auto userData = client.apiRequest("http://api.example.com/user", "your_token_here"); std::cout << "User data: " << userData.dump(2) << std::endl; } catch (const std::exception& e) { std::cerr << "Error: " << e.what() << std::endl; } return 0; }提示：在实际项目中，你可能需要添加更完善的错误处理和日志记录。libhv的日志系统可以通过
hv::Logger::setLogLevel(hv::Logger::LOG_LEVEL_DEBUG)来启用调试日志。
libhv的HttpClient类让C++中的HTTP请求变得前所未有的简单。从简单的GET/POST到复杂的文件上传、认证请求，都能用几行代码搞定。下次当你的C++项目需要处理HTTP通信时，不妨试试这个轻量高效的解决方案。