Skip to content

Pang-GJ/luce

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

luce

简介

基于C++20 coroutine的“高性能”epoll网络库,使用协程可以方便地用同步的代码写出异步的效果。

ps: “高性能”是指单看echo_server,性能跟muduo接近,没有进行更多的性能测试。
同时muduo有很多内部的优化技巧,本项目暂未优化一些内部实现,所以有不少的提升空间。

期望

C++20带来了无栈协程,但是不方便普通用户使用,目前的标准库适合库作者使用。
我想慢慢地封装一层协程异步框架,计划参考rust中的实现。

编译运行

本项目采用了xmake作为构建系统、依赖管理。

# 编译
xmake build
# 运行echo_server
xmake run echo_server

目前已实现的部分

  • IO多路复用(epoll)+ MultiReactor
  • C++20协程支持 co_await/co_return
    • 简单使用co::Task<>即可令函数成为协程
  • 线程池
  • EventManager/Reactor
  • TcpServer/TcpAcceptor/TcpConnection/TcpApplication
  • 高性能异步日志
    • 没有合并异步日志,仍在开发中,计划封装一下fmt或者std::formatTODO
  • json解析
  • 类似gin的restful HTTP框架

用法

参考example/echo_server.cpp
用户需要继承TcpApplication(位于include/net/tcp_application.h) 实现自己的Tcp应用程序,
具体来说要实现三个函数:

 virtual co::Task<> OnRequest(TcpConnectionPtr conn,
                                     TcpServer &server) = 0;
 virtual co::Task<> OnOpen(TcpConnectionPtr conn) = 0;
 virtual co::Task<> OnClose(TcpConnectionPtr conn) = 0;

OnRequest表示请求到来时的回调(已经使用协程尽量减少回调的使用,但总有一些不好去除的回调,如果你有更好的想法,欢迎跟我讨论)。
OnOpen表示连接刚开启的回调
OnClose表示连接关闭时的回调

网络模型

Reactor

用户所在的线程运行main_reactor,负责监听到来的请求连接,连接后交由sub_reactor进行读写

RoadMap

  • 协程
    • 目前的协程使用感觉还不是很容易
    • 缺少了不少组件,例如调度器、同步原语
  • io_uring
  • HTTP封装
    • 实现类似gin的简易HTTP框架
  • 简单protobuf RPC实现
    • 更进一步可以使用自己实现的序列化
    • TODO: 不用写IDL的RPC
  • Zero Copy

About

C++20协程net,基于epoll,可以方便地使用await语法

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published