README
¶
xingo_cluster
xingo golang游戏开发交流群：535378240
文档地址: http://www.runingman.net/
xingo是免费、开源、可定制、可扩展、节点支持“热更新”的高性能分布式服务器开发框架，采用golang语言开发，天生携带
高并发场景的处理基因，继承了golang语言本身的各种优点，开发简单易上手并且功能强大。它主要实现了高性能的异步网络库，
分布式节点间的高性能rpc通信，日志管理,数据库支持（暂时只支持mongodb），goroutine安全的定时器，telnet在线服务器调试
工具等，可用的开发场景包括但不局限于IM即时通讯服务器，游戏服务器（已有多款公司级别的项目选择了xingo）等可以节省大量
游戏开发时间，让游戏开发人员可以将主要精力放到游戏玩法和游戏逻辑上。真正实现了修改配置文件就可以搭建自定义的分布式服
务器架构。
优势特点：
1) 开发效率高
2) 支持自定义的分布式架构，方便横向扩展节点，理论上只要有足够的物理机器，没有承载上限
3) 支持自定义通信协议
4) 分布式节点自动发现，自动重连
5) worker pool工作线程池
6) telnet在线服务调试工具（使用方便扩展简单）
7) 内置mongodb数据库支持
8）goroutine安全的定时器实现
示例配置:
{
"master":{"host": "192.168.2.225","rootport":9999},
"servers":{
"gate2":{"host": "192.168.2.225", "rootport":10000,"name":"gate2", "module": "gate", "log": "gate2.log"},
"gate1":{"host": "192.168.2.225", "rootport":10001,"name":"gate1", "module": "gate", "log": "gate1.log"},
"net1":{"host": "192.168.2.225", "netport":11009,"name":"net1","remotes":["gate2", "gate1"],
"module": "net", "log": "net.log"},
"net2":{"host": "192.168.2.225", "netport":11010,"name":"net2","remotes":["gate2", "gate1"],
"module": "net", "log": "net.log"},
"net3":{"host": "192.168.2.225", "netport":11011,"name":"net3","remotes":["gate2", "gate1"],
"module": "net", "log": "net.log"},
"net4":{"host": "192.168.2.225", "netport":11012,"name":"net4","remotes":["gate2", "gate1"],
"module": "net", "log": "net.log"},
"admin":{"host": "192.168.2.225", "remotes":["gate2", "gate1"], "name":"admin", "module": "admin",
"http": [8888, "/static"]},
"game1":{"host": "192.168.2.225", "remotes":["gate2", "gate1"], "name":"game1", "module": "game"}
}
}
示例架构图：
默认通信协议如下（支持自定义协议处理部分代码，支持灵活的重载协议部分代码）：
Len uint32 数据Data部分长度
MsgId uint32 消息号
Data []byte 数据
消息默认通过google 的protobuf进行序列化
服务器全局配置对象为GlobalObject，支持的配置选项及默认值如下：
TcpPort: 8109,//服务器监听端口
MaxConn: 12000,//支持最大链接数
LogPath: "./log",//日志文件路径
LogName: "server.log",//日志文件名
MaxLogNum: 10,//最大日志数
MaxFileSize: 100,//per日志文件大小
LogFileUnit: logger.KB,//日志文件大小对应单位
LogLevel: logger.ERROR,//日志级别
SetToConsole: true,//是否输出到console
LogFileType: 1,//日志切割方式1 按天切割 2按文件大小切割
PoolSize: 10,//api接口工作线程数量
MaxWorkerLen: 1024 * 2,//任务缓冲池大小
MaxSendChanLen: 1024,//发送队列从缓冲池
FrameSpeed: 30,//未使用
MaxPacketSize: 1024,//协议数据包最大包体大小
FrequencyControl: 100/s,// 100/h(每小时一百个包), 100/m(每分钟一百个包), 100/s(每秒一百个包)
OnConnectioned: func(fconn iface.Iconnection) {},//链接建立事件回调
OnClosed: func(fconn iface.Iconnection) {},//链接断开事件回调
OnServerStop: func(), //服务器停服回调
Protoc: iface.IServerProtocol//socket数据pack和unpack的实现，可以通过设置该值重载服务器协议
如何使用？
只需要一步，添加消息路由：
s := fserver.NewServer()
//add api ---------------start
FightingRouterObj := &api.FightingRouter{}
s.AddRouter(FightingRouterObj)
//add api ---------------end
xingo会自动注册FightingRouter中的方法处理对应消息
例如：msgId =1 则会寻找FightingRouter中的Func_1的方法从进行处理
具体使用请参考项目：
帧同步服务器: https://github.com/viphxin/fighting
mmo demo: https://git.oschina.net/viphxin/xingo_demo
xingo_cluster demo: https://github.com/viphxin/xingo_cluster
Documentation
¶
Index ¶
Constants ¶
This section is empty.
Variables ¶
This section is empty.
Functions ¶
func NewXingoCluterServer ¶
func NewXingoCluterServer(nodename, cfg string) *clusterserver.ClusterServer
func NewXingoMaster ¶
func NewXingoMaster(cfg string) *clusterserver.Master
func NewXingoTcpServer ¶
Types ¶
This section is empty.
Source Files
Directories