libhv技术文档：跨平台高性能网络库使用指南

libhv技术文档：跨平台高性能网络库使用指南

【免费下载链接】libhv 🔥 比libevent/libuv/asio更易用的网络库。A c/c++ network library for developing TCP/UDP/SSL/HTTP/WebSocket/MQTT client/server. 项目地址: https://gitcode.com/libhv/libhv

1. 安装指南

1.1 系统要求

• 支持平台：Linux/Windows/macOS/Android/iOS/BSD/Solaris
• 编译工具：GCC/Clang/MSVC等C++11兼容编译器

1.2 源码编译安装

# 克隆仓库
git clone https://github.com/ithewei/libhv.git
cd libhv

# 方式1：使用Makefile编译
./configure
make
sudo make install

# 方式2：使用CMake编译
mkdir build
cd build
cmake ..
cmake --build .

# 方式3：使用Bazel编译
bazel build libhv

# 方式4：使用vcpkg安装
vcpkg install libhv

# 方式5：使用xmake安装
xrepo install libhv

2. 项目使用说明

2.1 快速开始

# 启动HTTP服务
bin/httpd -d

# 测试HTTP服务
bin/curl -v localhost:8080/ping
bin/curl -v localhost:8080/echo -d "hello,world!"

# 性能测试
bin/wrk -c 1000 -d 10 -t 4 http://127.0.0.1:8080/

2.2 主要功能模块

• 事件循环(EventLoop)：支持IO、定时器、空闲事件等
• TCP/UDP通信：支持客户端/服务器/代理模式
• HTTP服务：支持RESTful、中间件、SSE等特性
• WebSocket全双工通信
• MQTT客户端实现

3. API使用文档

3.1 TCP服务器示例(C++版)

#include "TcpServer.h"
using namespace hv;

TcpServer srv;
srv.onConnection = [](const SocketChannelPtr& channel) {
    if (channel->isConnected()) {
        printf("%s connected!\n", channel->peeraddr().c_str());
    }
};
srv.onMessage = [](const SocketChannelPtr& channel, Buffer* buf) {
    channel->write(buf); // 回显消息
};
srv.setThreadNum(4); // 设置工作线程数
srv.start(1234);     // 启动服务

3.2 HTTP服务器示例

#include "HttpServer.h"
using namespace hv;

HttpService router;
router.GET("/ping", [](HttpRequest* req, HttpResponse* resp) {
    return resp->String("pong");
});

HttpServer server(&router);
server.setPort(8080);
server.run();

3.3 WebSocket客户端示例

#include "WebSocketClient.h"
using namespace hv;

WebSocketClient ws;
ws.onmessage = [](const std::string& msg) {
    printf("Received: %s\n", msg.c_str());
};
ws.open("ws://127.0.0.1:9999");

4. 项目安装方式

4.1 二进制安装

从Release页面下载预编译的库文件：

• Linux: libhv.so
• Windows: hv.dll
• macOS: libhv.dylib

4.2 源码集成

将include和lib目录复制到您的项目中：

your_project/
├── include/
│   └── hv/
└── lib/
    └── libhv.a

4.3 依赖管理

CMake集成示例：

find_package(libhv REQUIRED)
target_link_libraries(your_target PRIVATE libhv::hv)

本技术文档提供了libhv的核心使用指南，如需更详细的功能说明，请参考项目中的示例代码和测试用例。

【免费下载链接】libhv 🔥 比libevent/libuv/asio更易用的网络库。A c/c++ network library for developing TCP/UDP/SSL/HTTP/WebSocket/MQTT client/server. 项目地址: https://gitcode.com/libhv/libhv