一 、介绍

cellnet是一个组件化、高扩展性、高性能的开源服务器网络库

git地址:https://github.com/davyxu/cellnet

主要使用领域:

  • 游戏服务器

    方便定制私有协议,快速构建逻辑服务器、网关服务器、服务器间互联互通、对接第三方SDK、转换编码协议等

  • ARM设备

    设备间网络通讯

  • 证券软件

    内部RPC

支持多种传输协议:

  • TCP

    TCP连接器的重连,侦听器的优雅重启。

  • UDP

    纯UDP裸包收发

  • HTTP(测试中)

    侦听器的优雅重启, 支持json及form的收发及封装。编写游戏服务器时,不再需要使用第三方HTTP服务器对接SDK。

    注: 如需要对接大规模网页, 请使用第三方专业网络库,如(https://github.com/gin-gonic/gin), cellnet的http支持主要目的在用统一的地址及peer管理

  • WebSocket

    采用(github.com/gorilla/websocket)实现

支持混合消息编码:

  • cellnet内建支持以下数据编码:

    可以通过codec包自行添加新的编码格式

  • 支持混合编码收发

    无需改动代码,只需调整消息注册方式,即可达成运行期同时收发不同编码的封包

    • 与其他语言编写的服务器使用protobuf

    • 与web服务器使用json通信

    • 与Unity3D(C#)使用ProtoPlus(github.com/davyxu/protoplus)协议通信

    优点:

    • 享受不同通信协议格式的优点,避免缺点。如Protobuf适合服务器间的传输,封包小,适应面广。

    • 私有的二进制协议方便加密和客户端处理,低GC和实现复杂度。

支持多线程和单线程设计架构:

  • 单线程异步逻辑,适用于MMORPG复杂交互,免加锁处理共享数据。

  • 多线程同步逻辑,适用于机器人逻辑,每个机器人使用独立的goroutine收发处理,机器人间互不干扰。

  • 多线程并发逻辑,适用于网关,消息转发,HTTP服务器,每条消息处理都会在完全并发下。

支持远程过程调用(RPC):

  • 支持同步RPC,适用于后台服务器向其他服务器请求数据后再顺处理事务。

  • 支持异步RPC,适用于单线程服务器逻辑。

cellnet的主要流程和架构:

  • socket连接管理:cellnet网络库使用连接器和接受器(connector,acceptor)管理socket连接

  • 会话(session):客户端和服务器连接使用会话(session)处理收发包流程,收发包的流程将事件通过事件的回调(cellnet.Eventfunc)派发

  • 包处理(packet):cellent中的packet包处理会话收发流程派发的事件,实现变长封包的解析,处理和收发

  • 编码器:用户的封包使用编码器(codec)负责原始封包的字节数组和用户消息间的转换

  • 消息队列:可以将收到的消息按顺序排队并提供给用户进行处理

  • 消息元信息(messageMeta):为所有的系统提供静态的消息扩展信息,如消息的ID,编码器,创建方法等

二、客户端功能

#官方demo
package main import (
"bufio"
"github.com/davyxu/cellnet"
"github.com/davyxu/cellnet/examples/chat/proto"
"github.com/davyxu/cellnet/peer"
"github.com/davyxu/cellnet/proc"
"github.com/davyxu/golog"
"os"
"strings" _ "github.com/davyxu/cellnet/peer/tcp"
_ "github.com/davyxu/cellnet/proc/tcp"
) var log = golog.New("client") func ReadConsole(callback func(string)) { for { // 从标准输入读取字符串,以\n为分割
text, err := bufio.NewReader(os.Stdin).ReadString('\n')
if err != nil {
break
} // 去掉读入内容的空白符
text = strings.TrimSpace(text) callback(text) } } func main() { // 创建一个事件处理队列,整个客户端只有这一个队列处理事件,客户端属于单线程模型
queue := cellnet.NewEventQueue() // 创建一个tcp的连接器,名称为client,连接地址为127.0.0.1:8801,将事件投递到queue队列,单线程的处理(收发封包过程是多线程)
p := peer.NewGenericPeer("tcp.Connector", "client", "127.0.0.1:18801", queue) // 设定封包收发处理的模式为tcp的ltv(Length-Type-Value), Length为封包大小,Type为消息ID,Value为消息内容
// 并使用switch处理收到的消息
proc.BindProcessorHandler(p, "tcp.ltv", func(ev cellnet.Event) {
switch msg := ev.Message().(type) {
case *cellnet.SessionConnected:
log.Debugln("client connected")
case *cellnet.SessionClosed:
log.Debugln("client error")
case *proto.ChatACK:
log.Infof("sid%d say: %s", msg.Id, msg.Content)
}
}) // 开始发起到服务器的连接
p.Start() // 事件队列开始循环
queue.StartLoop() log.Debugln("Ready to chat!") // 阻塞的从命令行获取聊天输入
ReadConsole(func(str string) { p.(interface {
Session() cellnet.Session
}).Session().Send(&proto.ChatREQ{
Content: str,
}) }) }

三、服务端功能

#官方demo
package main import (
"github.com/davyxu/cellnet"
"github.com/davyxu/cellnet/examples/chat/proto"
"github.com/davyxu/cellnet/peer"
"github.com/davyxu/cellnet/proc"
"github.com/davyxu/golog" _ "github.com/davyxu/cellnet/peer/tcp"
_ "github.com/davyxu/cellnet/proc/tcp"
) var log = golog.New("server") func main() { // 创建一个事件处理队列,整个服务器只有这一个队列处理事件,服务器属于单线程服务器
queue := cellnet.NewEventQueue() // 创建一个tcp的侦听器,名称为server,连接地址为127.0.0.1:8801,所有连接将事件投递到queue队列,单线程的处理(收发封包过程是多线程)
p := peer.NewGenericPeer("tcp.Acceptor", "server", "127.0.0.1:18801", queue) // 设定封包收发处理的模式为tcp的ltv(Length-Type-Value), Length为封包大小,Type为消息ID,Value为消息内容
// 每一个连接收到的所有消息事件(cellnet.Event)都被派发到用户回调, 用户使用switch判断消息类型,并做出不同的处理
proc.BindProcessorHandler(p, "tcp.ltv", func(ev cellnet.Event) { switch msg := ev.Message().(type) {
// 有新的连接
case *cellnet.SessionAccepted:
log.Debugln("server accepted")
// 有连接断开
case *cellnet.SessionClosed:
log.Debugln("session closed: ", ev.Session().ID())
// 收到某个连接的ChatREQ消息
case *proto.ChatREQ: // 准备回应的消息
ack := proto.ChatACK{
Content: msg.Content, // 聊天内容
Id: ev.Session().ID(), // 使用会话ID作为发送内容的ID
} // 在Peer上查询SessionAccessor接口,并遍历Peer上的所有连接,并发送回应消息(即广播消息)
p.(cellnet.SessionAccessor).VisitSession(func(ses cellnet.Session) bool { ses.Send(&ack) return true
}) } }) // 开始侦听
p.Start() // 事件队列开始循环
queue.StartLoop() // 阻塞等待事件队列结束退出( 在另外的goroutine调用queue.StopLoop() )
queue.Wait() }

最新文章

  1. AngularJs之二
  2. css 样式 图片平铺整个界面
  3. C# String 前面不足位数补零的方法 PadLeft
  4. php中如何开启GD库
  5. 无废话XML--XML解析(DOM和SAX)
  6. 将eclipse dynamic web project部署到指定的tomcat软件下的webapps文件夹中
  7. 题解-bzoj2554 Color
  8. Docker CE 镜像源站
  9. python3学习笔记五(列表2)
  10. 网卡驱动-BD详解(缓存描述符 Buffer Description)
  11. DS18B20读数错误排除
  12. PHP微信公共号发送模板消息。
  13. e829. 获得和设置JTabbedPane 的卡片
  14. (4)对象的的初始化与__init__方法以及绑定方法
  15. leetcode 两数之和 II - 输入有序数组
  16. 20155211 课下测试ch12补做
  17. element ui 栅格布局
  18. 如何去访问win8系统的共享文件夹
  19. 平均分割list
  20. java全栈day08--面向对象

热门文章

  1. C#实体类克隆
  2. eclipse打包jar及第三方jar包一起导出(生成SDK)
  3. log4cplus TimeBasedRollingFileAppender
  4. selenium 自动下载文件
  5. 起手一个mpvue项目准备
  6. 区别 |DCL |DDL |DML |DQL
  7. 使用Process子类创建进程
  8. POJ3241 最小曼哈顿距离生成树 - 真有趣哇
  9. CVE-2018-3246 weblogic xxe
  10. 《构建之法》CH5~6读书笔记 PB16110698 第九周(~5.15)