/Joynet

high performance network (tcp socket) library for lua, based on https://github.com/IronsDu/brynet and lua coroutine.

Primary LanguageLuaMIT LicenseMIT

Joynet

Windows : Build status Linux : Build Status

介绍

high performance network library for lua, based on https://github.com/IronsDu/accumulation-dev and lua coroutine. Joynet 的网络底层使用多线程，但Lua (层面)是运行在单线程上。借助协程提供同步形式的API。

src 目录是此项目源代码

libs 目录为基于此Lua协程网络库开发的一些库(譬如Redis、Mysql、WebSocket、Postgres、HTTP Client)

构建

使用 git clone迁出项目并进入项目根目录，并依次使用 git submodule init和git submodule update 下载依赖项.

然后使用cmake进行构建Joynet动态库

使用

examples 目录包含测试代码。 譬如我们要在Windows下运行PingPong测试：

先在项目根目录执行 lua examples\PingpongServer.lua，然后执行 lua examples\PingpongClient.lua 即可

使用此库也很简单,在你的Lua代码里使用require("Joynet")加载网络库,然后使用CoreDD对象的相关接口即可(具体参考examples目录的各示例代码)

当然，你必须先安装有Lua环境

Windows下可以下载二进制包,仅Windows下的Joynet需要链接3rdparty/lualib目录,当前版本是lua5.3,如果你使用的Lua虚拟机是lua5.1,那么你需要用Lua5.1的include和lib/dll替换luasrc目录的内容,然后再构建Joynet

linux下可以下载Lua源码(然后使用make linus;make install安装即可)

关于协程

协程是轻量级线程，所以多线程有的问题它也有，只是影响程度不同。 在协程中使用同步API会阻塞当前协程，所以当你的应用程序只有一个协程从外部收取网络消息时，且在消息处理中使用同步API 操作Redis或者Http的话，效率会很低。 这时有两个方案可解决：1 、再提供回调形式的异步API， 但这样会使开发概念混乱 ； 2、 在前面说到的情景的消息处理中再开新协程，并在其中操作HTTP/Redis。 （当然，协程的创建和切换必然有一定开销 ^-^ )