Handy C++11网络库：构建高性能网络应用的利器-优快云博客

本文链接：https://blog.youkuaiyun.com/gitblog_00984/article/details/148524085

Handy C++11网络库：构建高性能网络应用的利器

handy 项目地址: https://gitcode.com/gh_mirrors/han/handy

项目概述

Handy是一个基于C++11开发的轻量级、高性能网络库，专为Linux和Mac平台设计。它采用异步IO模型（epoll/kqueue）实现，提供了简洁易用的API接口，帮助开发者快速构建各类网络应用程序。作为现代C++网络编程的优秀解决方案，Handy特别适合需要高性能网络通信的场景。

核心组件与功能

1. EventBase事件分发器

EventBase是Handy的核心组件，负责事件循环和IO事件分发。它封装了底层epoll/kqueue的实现细节，为上层提供统一的接口。

关键特性：

事件循环管理：通过loop()方法启动事件循环
线程安全退出：支持从其他线程安全退出事件循环
定时任务调度：精确管理定时任务的执行
线程间任务调度：确保IO操作在正确的线程中执行

典型用法：

EventBase base;  // 创建事件分发器
base.loop();     // 启动事件循环

2. TCP通信组件

Handy提供了完整的TCP通信解决方案，包括客户端和服务端实现。

TcpConn连接管理

TcpConn代表一个TCP连接，采用智能指针管理生命周期，避免内存泄漏问题。

主要功能：

连接状态管理：提供Connected、Closed等多种状态
自动重连机制：可配置重连间隔时间
空闲连接检测：支持设置空闲超时回调
消息处理模式：支持原始数据流和消息分帧两种处理方式

示例代码：

auto con = TcpConn::createConnection(&base, "127.0.0.1", 8080);
con->onState([](const TcpConnPtr& con) {
    // 处理连接状态变化
});
con->onRead([](const TcpConnPtr& con) {
    // 处理接收到的数据
});

TcpServer服务器

TcpServer简化了TCP服务器的创建过程，只需几行代码即可搭建服务。

基本用法：

TcpServer server(&base);
server.bind("0.0.0.0", 8080);  // 绑定端口
server.onConnRead([](const TcpConnPtr& con) {
    con->send(con->getInput());  // 实现echo服务
});

3. HttpServer组件

Handy内置了轻量级的HTTP服务器实现，方便开发Web应用。

特性展示：

HttpServer http(&base);
http.bind("", 8080);
http.onGet("/hello", [](const HttpConnPtr& con) {
    HttpResponse resp;
    resp.body = "Hello World";
    con.sendResponse(resp);
});

4. 半同步半异步(HSHA)模式

Handy支持HSHA架构，将IO处理与业务逻辑分离，提高系统吞吐量。

实现原理：

IO线程处理网络事件
工作线程处理业务逻辑
通过消息队列实现线程间通信

使用示例：

HSHA server(&base, 4);  // 4个工作线程
server.onMsg(new LineCodec, [](const TcpConnPtr& con, const string& input) {
    // 在工作线程中处理业务逻辑
    return "Processed: " + input;
});