initial commit
This commit is contained in:
469
third_party/libhv/README.md
vendored
Executable file
469
third_party/libhv/README.md
vendored
Executable file
@@ -0,0 +1,469 @@
|
||||
English | [中文](README-CN.md)
|
||||
|
||||
# libhv
|
||||
|
||||
[](https://github.com/ithewei/libhv/actions/workflows/CI.yml?query=branch%3Amaster)
|
||||
[](https://github.com/ithewei/libhv/actions/workflows/CI.yml?query=branch%3Amaster)
|
||||
[](https://github.com/ithewei/libhv/actions/workflows/CI.yml?query=branch%3Amaster)
|
||||
[](https://github.com/ithewei/libhv/actions/workflows/CI.yml?query=branch%3Amaster)
|
||||
[](https://github.com/ithewei/libhv/actions/workflows/CI.yml?query=branch%3Amaster)
|
||||
[](https://github.com/ithewei/libhv/actions/workflows/benchmark.yml?query=branch%3Amaster)
|
||||
<br>
|
||||
[](https://github.com/ithewei/libhv/releases)
|
||||
[](https://github.com/ithewei/libhv/stargazers)
|
||||
[](https://github.com/ithewei/libhv/forks)
|
||||
[](https://github.com/ithewei/libhv/issues)
|
||||
[](https://github.com/ithewei/libhv/pulls)
|
||||
[](https://github.com/ithewei/libhv/contributors)
|
||||
[](LICENSE)
|
||||
<br>
|
||||
[](https://gitee.com/libhv/libhv)
|
||||
[](https://github.com/oz123/awesome-c)
|
||||
[](https://github.com/fffaraz/awesome-cpp)
|
||||
|
||||
Like `libevent, libev, and libuv`,
|
||||
`libhv` provides event-loop with non-blocking IO and timer,
|
||||
but simpler api and richer protocols.
|
||||
|
||||
## ✨ Features
|
||||
|
||||
- Cross-platform (Linux, Windows, macOS, Android, iOS, BSD, Solaris)
|
||||
- High-performance EventLoop (IO, timer, idle, custom, signal)
|
||||
- TCP/UDP client/server/proxy
|
||||
- TCP supports heartbeat, reconnect, upstream, MultiThread-safe write and close, etc.
|
||||
- Built-in common unpacking modes (FixedLength, Delimiter, LengthField)
|
||||
- RUDP support: WITH_KCP
|
||||
- SSL/TLS support: (via WITH_OPENSSL or WITH_GNUTLS or WITH_MBEDTLS)
|
||||
- HTTP client/server (support https http1/x http2 grpc)
|
||||
- HTTP supports static service, indexof service, forward/reverse proxy service, sync/async API handler
|
||||
- HTTP supports RESTful, router, middleware, keep-alive, chunked, SSE, etc.
|
||||
- WebSocket client/server
|
||||
- MQTT client
|
||||
|
||||
## ⌛️ Build
|
||||
|
||||
see [BUILD.md](BUILD.md)
|
||||
|
||||
Makefile:
|
||||
```shell
|
||||
./configure
|
||||
make
|
||||
sudo make install
|
||||
```
|
||||
|
||||
or cmake:
|
||||
```shell
|
||||
mkdir build
|
||||
cd build
|
||||
cmake ..
|
||||
cmake --build .
|
||||
```
|
||||
|
||||
or bazel:
|
||||
```shell
|
||||
bazel build libhv
|
||||
```
|
||||
|
||||
or vcpkg:
|
||||
```shell
|
||||
vcpkg install libhv
|
||||
```
|
||||
|
||||
or xmake:
|
||||
```shell
|
||||
xrepo install libhv
|
||||
```
|
||||
|
||||
## ⚡️ Getting Started
|
||||
|
||||
run `./getting_started.sh`:
|
||||
|
||||
```shell
|
||||
git clone https://github.com/ithewei/libhv.git
|
||||
cd libhv
|
||||
./configure
|
||||
make
|
||||
|
||||
bin/httpd -h
|
||||
bin/httpd -d
|
||||
#bin/httpd -c etc/httpd.conf -s restart -d
|
||||
ps aux | grep httpd
|
||||
|
||||
# http file service
|
||||
bin/curl -v localhost:8080
|
||||
|
||||
# http indexof service
|
||||
bin/curl -v localhost:8080/downloads/
|
||||
|
||||
# http api service
|
||||
bin/curl -v localhost:8080/ping
|
||||
bin/curl -v localhost:8080/echo -d "hello,world!"
|
||||
bin/curl -v localhost:8080/query?page_no=1\&page_size=10
|
||||
bin/curl -v localhost:8080/kv -H "Content-Type:application/x-www-form-urlencoded" -d 'user=admin&pswd=123456'
|
||||
bin/curl -v localhost:8080/json -H "Content-Type:application/json" -d '{"user":"admin","pswd":"123456"}'
|
||||
bin/curl -v localhost:8080/form -F 'user=admin' -F 'pswd=123456'
|
||||
bin/curl -v localhost:8080/upload -d "@LICENSE"
|
||||
bin/curl -v localhost:8080/upload -F "file=@LICENSE"
|
||||
|
||||
bin/curl -v localhost:8080/test -H "Content-Type:application/x-www-form-urlencoded" -d 'bool=1&int=123&float=3.14&string=hello'
|
||||
bin/curl -v localhost:8080/test -H "Content-Type:application/json" -d '{"bool":true,"int":123,"float":3.14,"string":"hello"}'
|
||||
bin/curl -v localhost:8080/test -F 'bool=1' -F 'int=123' -F 'float=3.14' -F 'string=hello'
|
||||
# RESTful API: /group/:group_name/user/:user_id
|
||||
bin/curl -v -X DELETE localhost:8080/group/test/user/123
|
||||
|
||||
# benchmark
|
||||
bin/wrk -c 1000 -d 10 -t 4 http://127.0.0.1:8080/
|
||||
```
|
||||
|
||||
### TCP
|
||||
#### tcp server
|
||||
**c version**: [examples/tcp_echo_server.c](examples/tcp_echo_server.c)
|
||||
|
||||
**c++ version**: [evpp/TcpServer_test.cpp](evpp/TcpServer_test.cpp)
|
||||
```c++
|
||||
#include "TcpServer.h"
|
||||
using namespace hv;
|
||||
|
||||
int main() {
|
||||
int port = 1234;
|
||||
TcpServer srv;
|
||||
int listenfd = srv.createsocket(port);
|
||||
if (listenfd < 0) {
|
||||
return -1;
|
||||
}
|
||||
printf("server listen on port %d, listenfd=%d ...\n", port, listenfd);
|
||||
srv.onConnection = [](const SocketChannelPtr& channel) {
|
||||
std::string peeraddr = channel->peeraddr();
|
||||
if (channel->isConnected()) {
|
||||
printf("%s connected! connfd=%d\n", peeraddr.c_str(), channel->fd());
|
||||
} else {
|
||||
printf("%s disconnected! connfd=%d\n", peeraddr.c_str(), channel->fd());
|
||||
}
|
||||
};
|
||||
srv.onMessage = [](const SocketChannelPtr& channel, Buffer* buf) {
|
||||
// echo
|
||||
channel->write(buf);
|
||||
};
|
||||
srv.setThreadNum(4);
|
||||
srv.start();
|
||||
|
||||
// press Enter to stop
|
||||
while (getchar() != '\n');
|
||||
return 0;
|
||||
}
|
||||
```
|
||||
|
||||
#### tcp client
|
||||
**c version**: [examples/tcp_client_test.c](examples/tcp_client_test.c)
|
||||
|
||||
**c++ version**: [evpp/TcpClient_test.cpp](evpp/TcpClient_test.cpp)
|
||||
```c++
|
||||
#include <iostream>
|
||||
#include "TcpClient.h"
|
||||
using namespace hv;
|
||||
|
||||
int main() {
|
||||
int port = 1234;
|
||||
TcpClient cli;
|
||||
int connfd = cli.createsocket(port);
|
||||
if (connfd < 0) {
|
||||
return -1;
|
||||
}
|
||||
cli.onConnection = [](const SocketChannelPtr& channel) {
|
||||
std::string peeraddr = channel->peeraddr();
|
||||
if (channel->isConnected()) {
|
||||
printf("connected to %s! connfd=%d\n", peeraddr.c_str(), channel->fd());
|
||||
} else {
|
||||
printf("disconnected to %s! connfd=%d\n", peeraddr.c_str(), channel->fd());
|
||||
}
|
||||
};
|
||||
cli.onMessage = [](const SocketChannelPtr& channel, Buffer* buf) {
|
||||
printf("< %.*s\n", (int)buf->size(), (char*)buf->data());
|
||||
};
|
||||
cli.start();
|
||||
|
||||
std::string str;
|
||||
while (std::getline(std::cin, str)) {
|
||||
if (str == "close") {
|
||||
cli.closesocket();
|
||||
} else if (str == "start") {
|
||||
cli.start();
|
||||
} else if (str == "stop") {
|
||||
cli.stop();
|
||||
break;
|
||||
} else {
|
||||
if (!cli.isConnected()) break;
|
||||
cli.send(str);
|
||||
}
|
||||
}
|
||||
return 0;
|
||||
}
|
||||
```
|
||||
|
||||
### HTTP
|
||||
#### http server
|
||||
see [examples/http_server_test.cpp](examples/http_server_test.cpp)
|
||||
|
||||
**golang gin style**
|
||||
```c++
|
||||
#include "HttpServer.h"
|
||||
using namespace hv;
|
||||
|
||||
int main() {
|
||||
HttpService router;
|
||||
router.GET("/ping", [](HttpRequest* req, HttpResponse* resp) {
|
||||
return resp->String("pong");
|
||||
});
|
||||
|
||||
router.GET("/data", [](HttpRequest* req, HttpResponse* resp) {
|
||||
static char data[] = "0123456789";
|
||||
return resp->Data(data, 10);
|
||||
});
|
||||
|
||||
router.GET("/paths", [&router](HttpRequest* req, HttpResponse* resp) {
|
||||
return resp->Json(router.Paths());
|
||||
});
|
||||
|
||||
router.GET("/get", [](HttpRequest* req, HttpResponse* resp) {
|
||||
resp->json["origin"] = req->client_addr.ip;
|
||||
resp->json["url"] = req->url;
|
||||
resp->json["args"] = req->query_params;
|
||||
resp->json["headers"] = req->headers;
|
||||
return 200;
|
||||
});
|
||||
|
||||
router.POST("/echo", [](const HttpContextPtr& ctx) {
|
||||
return ctx->send(ctx->body(), ctx->type());
|
||||
});
|
||||
|
||||
HttpServer server(&router);
|
||||
server.setPort(8080);
|
||||
server.setThreadNum(4);
|
||||
server.run();
|
||||
return 0;
|
||||
}
|
||||
```
|
||||
#### http client
|
||||
see [examples/http_client_test.cpp](examples/http_client_test.cpp)
|
||||
|
||||
**python requests style**
|
||||
```c++
|
||||
#include "requests.h"
|
||||
|
||||
int main() {
|
||||
auto resp = requests::get("http://www.example.com");
|
||||
if (resp == NULL) {
|
||||
printf("request failed!\n");
|
||||
} else {
|
||||
printf("%s\n", resp->body.c_str());
|
||||
}
|
||||
|
||||
resp = requests::post("127.0.0.1:8080/echo", "hello,world!");
|
||||
if (resp == NULL) {
|
||||
printf("request failed!\n");
|
||||
} else {
|
||||
printf("%s\n", resp->body.c_str());
|
||||
}
|
||||
|
||||
return 0;
|
||||
}
|
||||
```
|
||||
|
||||
### WebSocket
|
||||
#### WebSocket server
|
||||
see [examples/websocket_server_test.cpp](examples/websocket_server_test.cpp)
|
||||
```c++
|
||||
#include "WebSocketServer.h"
|
||||
using namespace hv;
|
||||
|
||||
int main(int argc, char** argv) {
|
||||
WebSocketService ws;
|
||||
ws.onopen = [](const WebSocketChannelPtr& channel, const HttpRequestPtr& req) {
|
||||
printf("onopen: GET %s\n", req->Path().c_str());
|
||||
};
|
||||
ws.onmessage = [](const WebSocketChannelPtr& channel, const std::string& msg) {
|
||||
printf("onmessage: %.*s\n", (int)msg.size(), msg.data());
|
||||
};
|
||||
ws.onclose = [](const WebSocketChannelPtr& channel) {
|
||||
printf("onclose\n");
|
||||
};
|
||||
|
||||
WebSocketServer server(&ws);
|
||||
server.setPort(9999);
|
||||
server.setThreadNum(4);
|
||||
server.run();
|
||||
return 0;
|
||||
}
|
||||
```
|
||||
|
||||
#### WebSocket client
|
||||
see [examples/websocket_client_test.cpp](examples/websocket_client_test.cpp)
|
||||
```c++
|
||||
#include "WebSocketClient.h"
|
||||
using namespace hv;
|
||||
|
||||
int main(int argc, char** argv) {
|
||||
WebSocketClient ws;
|
||||
ws.onopen = []() {
|
||||
printf("onopen\n");
|
||||
};
|
||||
ws.onmessage = [](const std::string& msg) {
|
||||
printf("onmessage: %.*s\n", (int)msg.size(), msg.data());
|
||||
};
|
||||
ws.onclose = []() {
|
||||
printf("onclose\n");
|
||||
};
|
||||
|
||||
// reconnect: 1,2,4,8,10,10,10...
|
||||
reconn_setting_t reconn;
|
||||
reconn_setting_init(&reconn);
|
||||
reconn.min_delay = 1000;
|
||||
reconn.max_delay = 10000;
|
||||
reconn.delay_policy = 2;
|
||||
ws.setReconnect(&reconn);
|
||||
|
||||
ws.open("ws://127.0.0.1:9999/test");
|
||||
|
||||
std::string str;
|
||||
while (std::getline(std::cin, str)) {
|
||||
if (!ws.isConnected()) break;
|
||||
if (str == "quit") {
|
||||
ws.close();
|
||||
break;
|
||||
}
|
||||
ws.send(str);
|
||||
}
|
||||
|
||||
return 0;
|
||||
}
|
||||
```
|
||||
|
||||
## 🍭 More examples
|
||||
### c version
|
||||
- [examples/hloop_test.c](examples/hloop_test.c)
|
||||
- [examples/htimer_test.c](examples/htimer_test.c)
|
||||
- [examples/pipe_test.c](examples/pipe_test.c)
|
||||
- [examples/tcp_echo_server.c](examples/tcp_echo_server.c)
|
||||
- [examples/tcp_chat_server.c](examples/tcp_chat_server.c)
|
||||
- [examples/tcp_proxy_server.c](examples/tcp_proxy_server.c)
|
||||
- [examples/udp_echo_server.c](examples/udp_echo_server.c)
|
||||
- [examples/udp_proxy_server.c](examples/udp_proxy_server.c)
|
||||
- [examples/socks5_proxy_server.c](examples/socks5_proxy_server.c)
|
||||
- [examples/tinyhttpd.c](examples/tinyhttpd.c)
|
||||
- [examples/tinyproxyd.c](examples/tinyproxyd.c)
|
||||
- [examples/jsonrpc](examples/jsonrpc)
|
||||
- [examples/mqtt](examples/mqtt)
|
||||
- [examples/multi-thread/multi-acceptor-processes.c](examples/multi-thread/multi-acceptor-processes.c)
|
||||
- [examples/multi-thread/multi-acceptor-threads.c](examples/multi-thread/multi-acceptor-threads.c)
|
||||
- [examples/multi-thread/one-acceptor-multi-workers.c](examples/multi-thread/one-acceptor-multi-workers.c)
|
||||
|
||||
### c++ version
|
||||
- [evpp/EventLoop_test.cpp](evpp/EventLoop_test.cpp)
|
||||
- [evpp/EventLoopThread_test.cpp](evpp/EventLoopThread_test.cpp)
|
||||
- [evpp/EventLoopThreadPool_test.cpp](evpp/EventLoopThreadPool_test.cpp)
|
||||
- [evpp/TimerThread_test.cpp](evpp/TimerThread_test.cpp)
|
||||
- [evpp/TcpServer_test.cpp](evpp/TcpServer_test.cpp)
|
||||
- [evpp/TcpClient_test.cpp](evpp/TcpClient_test.cpp)
|
||||
- [evpp/UdpServer_test.cpp](evpp/UdpServer_test.cpp)
|
||||
- [evpp/UdpClient_test.cpp](evpp/UdpClient_test.cpp)
|
||||
- [examples/http_server_test.cpp](examples/http_server_test.cpp)
|
||||
- [examples/http_client_test.cpp](examples/http_client_test.cpp)
|
||||
- [examples/websocket_server_test.cpp](examples/websocket_server_test.cpp)
|
||||
- [examples/websocket_client_test.cpp](examples/websocket_client_test.cpp)
|
||||
- [examples/protorpc](examples/protorpc)
|
||||
- [hv-projects/QtDemo](https://github.com/hv-projects/QtDemo)
|
||||
|
||||
### simulate well-known command line tools
|
||||
- [examples/nc](examples/nc.c)
|
||||
- [examples/nmap](examples/nmap)
|
||||
- [examples/httpd](examples/httpd)
|
||||
- [examples/wrk](examples/wrk.cpp)
|
||||
- [examples/curl](examples/curl.cpp)
|
||||
- [examples/wget](examples/wget.cpp)
|
||||
- [examples/consul](examples/consul)
|
||||
- [examples/kcptun](examples/kcptun)
|
||||
|
||||
## 🥇 Benchmark
|
||||
### `pingpong echo-servers`
|
||||
```shell
|
||||
cd echo-servers
|
||||
./build.sh
|
||||
./benchmark.sh
|
||||
```
|
||||
|
||||
**throughput**:
|
||||
```shell
|
||||
libevent running on port 2001
|
||||
libev running on port 2002
|
||||
libuv running on port 2003
|
||||
libhv running on port 2004
|
||||
asio running on port 2005
|
||||
poco running on port 2006
|
||||
|
||||
==============2001=====================================
|
||||
[127.0.0.1:2001] 4 threads 1000 connections run 10s
|
||||
total readcount=1616761 readbytes=1655563264
|
||||
throughput = 157 MB/s
|
||||
|
||||
==============2002=====================================
|
||||
[127.0.0.1:2002] 4 threads 1000 connections run 10s
|
||||
total readcount=2153171 readbytes=2204847104
|
||||
throughput = 210 MB/s
|
||||
|
||||
==============2003=====================================
|
||||
[127.0.0.1:2003] 4 threads 1000 connections run 10s
|
||||
total readcount=1599727 readbytes=1638120448
|
||||
throughput = 156 MB/s
|
||||
|
||||
==============2004=====================================
|
||||
[127.0.0.1:2004] 4 threads 1000 connections run 10s
|
||||
total readcount=2202271 readbytes=2255125504
|
||||
throughput = 215 MB/s
|
||||
|
||||
==============2005=====================================
|
||||
[127.0.0.1:2005] 4 threads 1000 connections run 10s
|
||||
total readcount=1354230 readbytes=1386731520
|
||||
throughput = 132 MB/s
|
||||
|
||||
==============2006=====================================
|
||||
[127.0.0.1:2006] 4 threads 1000 connections run 10s
|
||||
total readcount=1699652 readbytes=1740443648
|
||||
throughput = 165 MB/s
|
||||
```
|
||||
|
||||
### `iperf tcp_proxy_server`
|
||||
```shell
|
||||
# sudo apt install iperf
|
||||
iperf -s -p 5001 > /dev/null &
|
||||
bin/tcp_proxy_server 1212 127.0.0.1:5001 &
|
||||
iperf -c 127.0.0.1 -p 5001 -l 8K
|
||||
iperf -c 127.0.0.1 -p 1212 -l 8K
|
||||
```
|
||||
|
||||
**Bandwidth**:
|
||||
```shell
|
||||
------------------------------------------------------------
|
||||
[ 3] local 127.0.0.1 port 52560 connected with 127.0.0.1 port 5001
|
||||
[ ID] Interval Transfer Bandwidth
|
||||
[ 3] 0.0-10.0 sec 20.8 GBytes 17.9 Gbits/sec
|
||||
|
||||
------------------------------------------------------------
|
||||
[ 3] local 127.0.0.1 port 48142 connected with 127.0.0.1 port 1212
|
||||
[ ID] Interval Transfer Bandwidth
|
||||
[ 3] 0.0-10.0 sec 11.9 GBytes 10.2 Gbits/sec
|
||||
```
|
||||
|
||||
### `webbench`
|
||||
```shell
|
||||
# sudo apt install wrk
|
||||
wrk -c 100 -t 4 -d 10s http://127.0.0.1:8080/
|
||||
|
||||
# sudo apt install apache2-utils
|
||||
ab -c 100 -n 100000 http://127.0.0.1:8080/
|
||||
```
|
||||
|
||||
**libhv(port:8080) vs nginx(port:80)**
|
||||
|
||||
|
||||
|
||||
Above test results can be found on [Github Actions](https://github.com/ithewei/libhv/actions/workflows/benchmark.yml).
|
||||
Reference in New Issue
Block a user