Documentation ¶
Index ¶
- func NewDataPack() ziface.Packet
- func NewLimiter() ziface.ILimiter
- func NewServer(opts ...Option) ziface.IServer
- type BaseRouter
- type ConnManager
- func (connMgr *ConnManager) Add(conn ziface.IConnection)
- func (connMgr *ConnManager) ClearConn()
- func (connMgr *ConnManager) ClearOneConn(connID int64)
- func (connMgr *ConnManager) Get(connID int64) (ziface.IConnection, error)
- func (connMgr *ConnManager) Len() int
- func (connMgr *ConnManager) Remove(conn ziface.IConnection)
- type Connection
- func (c *Connection) GetConnID() int64
- func (c *Connection) GetProperty(key string) (interface{}, error)
- func (c *Connection) GetTCPConnection() *net.TCPConn
- func (c *Connection) GetTcpServer() ziface.IServer
- func (c *Connection) IsAlive() bool
- func (c *Connection) KeepAlive()
- func (c *Connection) RemoteAddr() net.Addr
- func (c *Connection) RemoveProperty(key string)
- func (c *Connection) SendBuffMsg(msgId uint32, data []byte) error
- func (c *Connection) SendMsg(msgId uint32, data []byte) error
- func (c *Connection) SendServerPem(msgId uint32, data []byte) error
- func (c *Connection) SetProperty(key string, value interface{})
- func (c *Connection) SetSPublicKey(key sm2.PublicKey)
- func (c *Connection) Start()
- func (c *Connection) StartReader()
- func (c *Connection) StartWriter()
- func (c *Connection) Stop()
- type DataPack
- type Gate
- type Limier
- type Message
- type MsgHandle
- func (mh *MsgHandle) AddRouter(msgId uint32, router ziface.IRouter)
- func (mh *MsgHandle) DoMsgHandler(request ziface.IRequest)
- func (mh *MsgHandle) SendMsgToTaskQueue(request ziface.IRequest)
- func (mh *MsgHandle) StartOneWorker(workerID int, taskQueue chan ziface.IRequest)
- func (mh *MsgHandle) StartWorkerPool()
- type Option
- type Request
- type Server
- func (s *Server) AddRouter(msgId uint32, router ziface.IRouter)
- func (s *Server) CallOnConnStart(conn ziface.IConnection)
- func (s *Server) CallOnConnStop(conn ziface.IConnection)
- func (s *Server) GetConnMgr() ziface.IConnManager
- func (s *Server) Packet() ziface.Packet
- func (s *Server) Serve()
- func (s *Server) SetOnConnStart(hookFunc func(ziface.IConnection))
- func (s *Server) SetOnConnStop(hookFunc func(ziface.IConnection))
- func (s *Server) Start()
- func (s *Server) Stop()
Constants ¶
This section is empty.
Variables ¶
This section is empty.
Functions ¶
func NewLimiter ¶
Types ¶
type BaseRouter ¶
type BaseRouter struct{}
BaseRouter 实现router时,先嵌入这个基类,然后根据需要对这个基类的方法进行重写
func (*BaseRouter) Handle ¶
func (br *BaseRouter) Handle(ziface.IRequest)
func (*BaseRouter) PostHandle ¶
func (br *BaseRouter) PostHandle(ziface.IRequest)
func (*BaseRouter) PreHandle ¶
func (br *BaseRouter) PreHandle(ziface.IRequest)
type ConnManager ¶
type ConnManager struct {
// contains filtered or unexported fields
}
ConnManager 连接管理模块
func (*ConnManager) ClearOneConn ¶
func (connMgr *ConnManager) ClearOneConn(connID int64)
ClearOneConn 利用ConnID获取一个链接 并且删除
func (*ConnManager) Get ¶
func (connMgr *ConnManager) Get(connID int64) (ziface.IConnection, error)
Get 利用ConnID获取链接
func (*ConnManager) Remove ¶
func (connMgr *ConnManager) Remove(conn ziface.IConnection)
Remove 删除连接
type Connection ¶
type Connection struct { //当前Conn属于哪个Server TcpServer ziface.IServer //当前连接的socket TCP套接字 Conn *net.TCPConn //当前连接的ID 也可以称作为SessionID,ID全局唯一 ConnID int64 //消息管理MsgId和对应处理方法的消息管理模块 MsgHandler ziface.IMsgHandle sync.RWMutex //服务端的密钥信息 ServerPem utils.ServerPem //服务端的私钥-用于解密数据 SPrivateKey sm2.PrivateKey //客户端的公钥-用于加密数据 CPublicKey sm2.PublicKey // contains filtered or unexported fields }
func NewConntion ¶
func NewConntion(server ziface.IServer, conn *net.TCPConn, connID int64, msgHandler ziface.IMsgHandle) *Connection
NewConntion 创建连接的方法
func (*Connection) GetProperty ¶
func (c *Connection) GetProperty(key string) (interface{}, error)
GetProperty 获取链接属性
func (*Connection) GetTCPConnection ¶
func (c *Connection) GetTCPConnection() *net.TCPConn
GetTCPConnection 从当前连接获取原始的socket TCPConn
func (*Connection) GetTcpServer ¶
func (c *Connection) GetTcpServer() ziface.IServer
GetTcpServer 获取服务端句柄
func (*Connection) RemoveProperty ¶
func (c *Connection) RemoveProperty(key string)
RemoveProperty 移除链接属性
func (*Connection) SendBuffMsg ¶
func (c *Connection) SendBuffMsg(msgId uint32, data []byte) error
func (*Connection) SendMsg ¶
func (c *Connection) SendMsg(msgId uint32, data []byte) error
SendMsg 直接将Message数据发送数据给远程的TCP客户端
func (*Connection) SendServerPem ¶
func (c *Connection) SendServerPem(msgId uint32, data []byte) error
SendServerPem 直接将服务端公钥发送给远程的TCP客户端
func (*Connection) SetProperty ¶
func (c *Connection) SetProperty(key string, value interface{})
SetProperty 设置链接属性
func (*Connection) SetSPublicKey ¶
func (c *Connection) SetSPublicKey(key sm2.PublicKey)
func (*Connection) StartReader ¶
func (c *Connection) StartReader()
StartReader 读消息Goroutine,用于从客户端中读取数据
func (*Connection) StartWriter ¶
func (c *Connection) StartWriter()
StartWriter 写消息Goroutine, 用户将数据发送给客户端
type DataPack ¶
type DataPack struct{}
DataPack 封包拆包类实例,暂时不需要成员
type Gate ¶
type Gate struct { Name string `json:"name"` //客户端名字 UA []byte `json:"ua"` // 连接统一认证码 Sign []byte `json:"sign"` // 认证码的签名 PublicKey []byte `json:"public-key"` // 客户端的公钥 }
Gate 网关模块 客户端请求格式------------------
type Limier ¶
func (*Limier) IsAvailable ¶
type Message ¶
func NewMsgPackage ¶
NewMsgPackage 创建一个Message消息包
type MsgHandle ¶
type MsgHandle struct { Apis map[uint32]ziface.IRouter //存放每个MsgId 所对应的处理方法的map属性 WorkerPoolSize int64 //业务工作Worker池的数量 TaskQueue []chan ziface.IRequest //Worker负责取任务的消息队列 }
func NewMsgHandle ¶
func NewMsgHandle() *MsgHandle
func (*MsgHandle) DoMsgHandler ¶
DoMsgHandler 马上以非阻塞方式处理消息
func (*MsgHandle) SendMsgToTaskQueue ¶
SendMsgToTaskQueue 将消息交给TaskQueue,由worker进行处理
func (*MsgHandle) StartOneWorker ¶
StartOneWorker 启动一个Worker工作流程
func (*MsgHandle) StartWorkerPool ¶
func (mh *MsgHandle) StartWorkerPool()
StartWorkerPool 启动worker工作池
type Option ¶
type Option func(s *Server)
func WithPacket ¶
WithPacket 只要实现 Packet 接口可自由实现数据包解析格式,如果没有则使用默认解析格式
type Request ¶
type Request struct {
// contains filtered or unexported fields
}
func (*Request) GetConnection ¶
func (r *Request) GetConnection() ziface.IConnection
GetConnection 获取请求连接信息
type Server ¶
type Server struct { //服务器的名称 Name string //tcp4 or other IPVersion string //服务绑定的IP地址 IP string //服务绑定的端口 Port int //当前Server的链接管理器 ConnMgr ziface.IConnManager //该Server的连接创建时Hook函数 OnConnStart func(conn ziface.IConnection) //该Server的连接断开时的Hook函数 OnConnStop func(conn ziface.IConnection) // contains filtered or unexported fields }
Server 接口实现,定义一个Server服务类
func (*Server) CallOnConnStart ¶
func (s *Server) CallOnConnStart(conn ziface.IConnection)
CallOnConnStart 调用连接OnConnStart Hook函数
func (*Server) CallOnConnStop ¶
func (s *Server) CallOnConnStop(conn ziface.IConnection)
CallOnConnStop 调用连接OnConnStop Hook函数
func (*Server) SetOnConnStart ¶
func (s *Server) SetOnConnStart(hookFunc func(ziface.IConnection))
SetOnConnStart 设置该Server的连接创建时Hook函数
func (*Server) SetOnConnStop ¶
func (s *Server) SetOnConnStop(hookFunc func(ziface.IConnection))
SetOnConnStop 设置该Server的连接断开时的Hook函数