服务器网络库 cellnet

cellnet是一个高性能，简单，方便的开源服务器网络库

自由切换编码，业务代码无需调整。

TCP和html5的应用都可以直接使用cellnet迅速搭建服务器框架。

如果你熟悉Java的Netty或Mina网络库，Handler机制将给予你强大定制功能。

特性

数据协议

编码支持:
- Google Protobuf (https://github.com/google/protobuf)
- sproto (https://github.com/cloudwu/sproto)
- json
- 二进制协议(https://github.com/davyxu/goobjfmt)
支持混合编码收发
传输协议支持:
- tcp(基于Type-Length-Value私有协议)
- WebSocket

基于handler处理链

自定义, 组装收发流程
支持专有日志调试

队列及IO

支持多个队列, 实现单线程/多线程收发处理消息
发送时自动合并封包(性能效果决定于实际请求和发送比例)

RPC

异步/同步远程过程调用

消息日志

可以方便的通过日志查看收发消息的每一个字段消息

第三方库依赖

github.com/davyxu/golog
github.com/davyxu/goobjfmt

编码包可选支持

github.com/golang/protobuf
github.com/davyxu/gosproto

websocket可选支持

github.com/gorilla/websocket

获取+编译

    go get -u -v github.com/davyxu/cellnet

例子主要采用了protobuf做编码，因此需要安装protobuf支持

    go get -v github.com/golang/protobuf

性能测试

命令行: go test -v github.com/davyxu/cellnet/benchmark/io

平台: Windows 7 x64/CentOS 6.5 x64

测试用例: localhost 1000连接同时对服务器进行实时PingPong测试

配置1: i7 6700 3.4GHz 8核

IOPS: 12.5w

配置2: i5 4590 3.3GHz 4核

IOPS: 10.1w

例子

Echo


func server() {

    queue := cellnet.NewEventQueue()

    p := socket.NewAcceptor(queue).Start("127.0.0.1:7201")

    cellnet.RegisterMessage(p, "gamedef.TestEchoACK", func(ev *cellnet.Event) {
        msg := ev.Msg.(*gamedef.TestEchoACK)

        log.Debugln("server recv:", msg.Content)

        ev.Send(&gamedef.TestEchoACK{
            Content: msg.String(),
        })

    })

    queue.StartLoop()

}

func client() {

    queue := cellnet.NewEventQueue()

    p := socket.NewConnector(queue).Start("127.0.0.1:7301")

    cellnet.RegisterMessage(p, "gamedef.TestEchoACK", func(ev *cellnet.Event) {
        msg := ev.Msg.(*gamedef.TestEchoACK)

        log.Debugln("client recv:", msg.Content)
    })

    cellnet.RegisterMessage(p, "coredef.SessionConnected", func(ev *cellnet.Event) {

        log.Debugln("client connected")

        ev.Send(&gamedef.TestEchoACK{
            Content: "hello",
        })

    })

    cellnet.RegisterMessage(p, "coredef.SessionConnectFailed", func(ev *cellnet.SessionEvent) {

        msg := ev.Msg.(*coredef.SessionConnectFailed)

        log.Debugln(msg.Reason)

    })

    queue.StartLoop()
}

文件夹功能

benchmark\            性能测试用例

proto\                cellnet内部的proto

    binary\         内部系统消息,rpc消息协议

    pb\             使用pb例子的消息

    sproto\         使用sproto例子的消息

protoc-gen-msg\     protobuf的protoc插件, 消息id生成, 使用pb编码时使用

rpc\                异步远程过程调用封装

socket\                套接字,连接管理等封装

example\            测试用例/例子

    classicrecv\    传统的固定消息处理函数例子

       echo_pb\        基于protobuf和json混合编码的pingpong测试，

       echo_sproto\    基于sproto编码的pingpong测试，

       echo_websocket\    基于websocket协议，

       gracefulexit\    平滑退出

    rpc\            异步远程过程调用

    sendclose\        发送消息后保证消息送达后再断开连接

    timer\            异步计时器


timer\            计时器接口

util\            工具库

FAQ

这个代码的入口在哪里? 怎么编译为exe?

本代码是一个网络库, 需要根据需求, 整合逻辑
支持WebSocket么?

支持!

本网络库的Websocket基于第三方整合, 包格式基于文本: 包名\n+json内容

参见example/echo_websocket
混合编码有何用途?

在与多种语言写成的服务器进行通信时, 可以使用不同的编码, 最终在逻辑层都是统一的结构能让逻辑编写更加方便, 无需关注底层处理细节
内建支持的二进制协议能与其他语言写成的网络库互通么?

完全支持, 但内建二进制协议支持更适合网关与后台服务器. 不建议与客户端通信中使用, 二进制协议不会忽略使用默认值的字段
我能通过Handler处理链进行怎样的扩展?

封包需要加密, 统计, 预处理时, 可以使用Handler. 每个Handler建议无状态, 需要存储的数据, 可以通过Event中的Tag进行扩展
如何查看Handler处理流程? 在程序启动时, 调用如下代码
```
  cellnet.EnableHandlerLog = true
```
可在日志中看到如下日志格式

    [DEBUG] cellnet 2000/00/00 01:02:03 9 Event_Connected [svc->agent] <DecodePacketHandler> SesID: 1 MsgID: 3551021301(coredef.SessionConnected) {} Tag: <nil> TransmitTag: <nil> Raw: (0)[]

9 表示一个Event处理序号, 同一序号表示1个处理流程, 例如1个接收/发送流程

Event_Connected 表示事件名

[svc->agent] 表示peer的名称

<DecodePacketHandler> 表示Handler的名称, 通过反射取得

SesID 表示 会话ID, 由SessionManager分配

MsgID 表示消息号, 后面括号中是对应的消息名, 如果未在系统中注册, 显示为空, 后续是消息内容

TransmitTag, Tag 附属上下文内容

Raw, 表示消息的原始二进制信息

所有的例子都是单线程的, 能编写多线程的逻辑么?

完全可以, cellnet并没有全局的队列, 只需在Acceptor和Connector创建时, 传入不同的队列, socket收到的消息就会被放到这个队列中传入空队列时, 使用并发方式(io线程)调用处理回调
消息日志为什么与处理函数日志顺序不统一?

由于消息日志反应的是收到消息的日志, 因此必须放置在io线程中处理. 而单线程逻辑与io线程分别在不同的线程. 日志顺序错位是正常的如果需要顺序日志: 可以在进程启动时, 调用runtime.GOMAXPROCS(1), 将go的线程调度默认为1CPU
cellnet有网关和db支持么?

cellnet专注于服务器底层.你可以根据自己需要编写网关及db支持

posted on 2018-12-10 10:18 &大飞阅读(901) 评论(0) 收藏举报

刷新页面返回顶部

大飞