FAQ

Q：libhv和libevent、libev、libuv有什么不同

A：

• libevent最为古老、有历史包袱，bufferevent虽为精妙，却也难以上手；
• libev可以说是libevent的简化版，代码极为精简，但宏定义用的过多，代码可读性不强，且在Windows上实现不佳；
• libuv是nodejs的c底层库，最先也是由libevent+对Windows IOCP支持，后来才改写自成一体，同时实现了管道、文件的异步读写，很强大，但结构体比较多，封装比较深；
• libhv本身是参考了libevent、libev、libuv的实现思路，它们的核心都是事件循环（即在一个事件循环中处理IO、定时器等事件），但提供的接口最为精简，API接近原生系统调用，最容易上手；
• 具体这几个库的写法比较见https://github.com/ithewei/libhv/tree/master/echo-servers
• 当然这几个库的性能是接近的，都将非阻塞IO多路复用用到了极致
• 更详细介绍见国产开源库libhv为何能被awesome-c和awesome-cpp收录

Q：libhv的定位

A：精妙小巧跨平台，简单实用易上手

• base封装了很多跨平台的代码，如hatomic原子操作、hthread线程、hmutex线程同步，当然这都是基于configure/cmake自动生成的hconfig.h和hplatform.h两个头文件中提供的平台宏、编译器宏等实现的；
• event模块则实现了事件循环（包括IO、timer、idle），不同的平台有不同的实现，如Linux使用epoll，Windows使用IOCP、Mac使用kqueue、Solaris使用evport，感兴趣的可以读一读event下的源码；
• http模块则基于event模块实现了本世纪最为通用的应用层协议http协议，包括http服务端和客户端，libhv中examples下提供的httpd，性能可媲美nginx服务；
• 不妨勇敢的说，libhv是c++编写HTTP API服务端/客户端最简单的库，没有之一

Q：libhv的发展规划

A：基于event模块实现更多的常见应用层协议，如websocket、MQTT、redis等；

Q：libhv性能如何

A：上面说了，libhv、libevent、libev、libuv几个库是性能是接近的，它们都将非阻塞IO多路复用用到了极致，可使用echo-servers下提供的benchmark.sh简单做个压力测试，在我个人开发机上QPS都在28K左右，不存在量级差距； 此外libhv中提供的httpd QPS甚至略微超过nginx；

Q：libhv稳定性如何，是否商用

A：libhv自2018年5月创建，至今已有两年多迭代，300+提交，广泛用于公司IoT和HTTP API服务中，此外QQ群里也是有不少水友成功用在各种项目中，反馈很好； 请放心使用，开源且保证长期维护，QQ群里也有很多大神积极解答。

Q：libhv如何入门

A：

• 建议先从运行项目根目录下getting_started.sh脚本开始， 你会被libhv的httpd所展示的便利性所吸引；
• 看unittest和examples下的示例代码；
• 源码阅读推荐路线base->event->http；

Q：libhv如何使用

A：libhv可通过Makefile或cmake编译出动态库和静态库，make install后包含相关头文件（base模块下头文件比较分散，可直接#include "hv.h"）和链接库文件即可使用；当然libhv模块划分清晰，低耦合，你也可以直接把源文件拿到自己项目中去编译，如日志功能hlog.h和hlog.c就可以直接拿去用。

Q：libhv在Windows下如何编译

A：Windows下编译libhv请先使用cmake生成VS工程

Q：Windows下静态库链接问题

A：请在工程-->属性-->c/c++-->预处理器-->预处理器定义中添加HV_STATICLIB预编译宏，以屏蔽hexport.h头文件中动态库导入宏

#define HV_EXPORT  __declspec(dllimport)

使用curl静态库类似加CURL_STATICLIB预编译宏