#### 9.4 注冊鏈接啟動/停止自定義Hook方法功能
有的時候,在創建鏈接的時候,希望在創建鏈接之后、和斷開鏈接之前,執行一些用戶自定義的業務。那么我們就需要給Zinx增添兩個鏈接創建后和斷開前時機的回調函數,一般也稱作Hook\(鉤子\)函數。
我們可以通過Server來注冊conn的hook方法
> zinx/ziface/iserver.go
```go
type IServer interface{
//啟動服務器方法
Start()
//停止服務器方法
Stop()
//開啟業務服務方法
Serve()
//路由功能:給當前服務注冊一個路由業務方法,供客戶端鏈接處理使用
AddRouter(msgId uint32, router IRouter)
//得到鏈接管理
GetConnMgr() IConnManager
//設置該Server的連接創建時Hook函數
SetOnConnStart(func (IConnection))
//設置該Server的連接斷開時的Hook函數
SetOnConnStop(func (IConnection))
//調用連接OnConnStart Hook函數
CallOnConnStart(conn IConnection)
//調用連接OnConnStop Hook函數
CallOnConnStop(conn IConnection)
}
```
> zinx/znet/server.go
```go
//iServer 接口實現,定義一個Server服務類
type Server struct {
//服務器的名稱
Name string
//tcp4 or other
IPVersion string
//服務綁定的IP地址
IP string
//服務綁定的端口
Port int
//當前Server的消息管理模塊,用來綁定MsgId和對應的處理方法
msgHandler ziface.IMsgHandle
//當前Server的鏈接管理器
ConnMgr ziface.IConnManager
// =======================
//新增兩個hook函數原型
//該Server的連接創建時Hook函數
OnConnStart func(conn ziface.IConnection)
//該Server的連接斷開時的Hook函數
OnConnStop func(conn ziface.IConnection)
// =======================
}
```
實現添加hook函數的接口和調用hook函數的接口
```go
//設置該Server的連接創建時Hook函數
func (s *Server) SetOnConnStart(hookFunc func (ziface.IConnection)) {
s.OnConnStart = hookFunc
}
//設置該Server的連接斷開時的Hook函數
func (s *Server) SetOnConnStop(hookFunc func (ziface.IConnection)) {
s.OnConnStop = hookFunc
}
//調用連接OnConnStart Hook函數
func (s *Server) CallOnConnStart(conn ziface.IConnection) {
if s.OnConnStart != nil {
fmt.Println("---> CallOnConnStart....")
s.OnConnStart(conn)
}
}
//調用連接OnConnStop Hook函數
func (s *Server) CallOnConnStop(conn ziface.IConnection) {
if s.OnConnStop != nil {
fmt.Println("---> CallOnConnStop....")
s.OnConnStop(conn)
}
}
```
那么接下來,需要選定兩個Hook方法的調用位置。
一個是創建鏈接之后:
> zinx/znet/connection.go
```go
//啟動連接,讓當前連接開始工作
func (c *Connection) Start() {
//1 開啟用戶從客戶端讀取數據流程的Goroutine
go c.StartReader()
//2 開啟用于寫回客戶端數據流程的Goroutine
go c.StartWriter()
//==================
//按照用戶傳遞進來的創建連接時需要處理的業務,執行鉤子方法
c.TcpServer.CallOnConnStart(c)
//==================
}
```
一個是停止鏈接之前:
> zinx/znet/connection.go
```go
//停止連接,結束當前連接狀態M
func (c *Connection) Stop() {
fmt.Println("Conn Stop()...ConnID = ", c.ConnID)
//如果當前鏈接已經關閉
if c.isClosed == true {
return
}
c.isClosed = true
//==================
//如果用戶注冊了該鏈接的關閉回調業務,那么在此刻應該顯示調用
c.TcpServer.CallOnConnStop(c)
//==================
// 關閉socket鏈接
c.Conn.Close()
//關閉Writer
c.ExitBuffChan <- true
//將鏈接從連接管理器中刪除
c.TcpServer.GetConnMgr().Remove(c)
//關閉該鏈接全部管道
close(c.ExitBuffChan)
close(c.msgBuffChan)
}
```
- 一、引言
- 1、寫在前面
- 2、初探Zinx架構
- 二、初識Zinx框架
- 1. Zinx-V0.1-基礎Server
- 2.Zinx-V0.2-簡單的連接封裝與業務綁定
- 三、Zinx框架基礎路由模塊
- 3.1 IRequest 消息請求抽象類
- 3.2 IRouter 路由配置抽象類
- 3.3 Zinx-V0.3-集成簡單路由功能
- 3.4 Zinx-V0.3代碼實現
- 3.5 使用Zinx-V0.3完成應用程序
- 四、Zinx的全局配置
- 4.1 Zinx-V0.4增添全局配置代碼實現
- 4.2 使用Zinx-V0.4完成應用程序
- 五、Zinx的消息封裝
- 5.1 創建消息封裝類型
- 5.2 消息的封包與拆包
- 5.3 Zinx-V0.5代碼實現
- 5.4 使用Zinx-V0.5完成應用程序
- 六、Zinx的多路由模式
- 6.1 創建消息管理模塊
- 6.2 Zinx-V0.6代碼實現
- 6.3 使用Zinx-V0.6完成應用程序
- 七、Zinx的讀寫分離模型
- 7.1 Zinx-V0.7代碼實現
- 7.2 使用Zinx-V0.7完成應用程序
- 八、Zinx的消息隊列及多任務機制
- 8.1 創建消息隊列
- 8.2 創建及啟動Worker工作池
- 8.3 發送消息給消息隊列
- 8.4 Zinx-V0.8代碼實現
- 8.5 使用Zinx-V0.8完成應用程序
- 九、Zinx的鏈接管理
- 9.1 創建鏈接管理模塊
- 9.2 鏈接管理模塊集成到Zinx中
- 9.3 鏈接的帶緩沖的發包方法
- 9.4 注冊鏈接啟動/停止自定義Hook方法功能
- 9.5 使用Zinx-V0.9完成應用程序
- 十、Zinx的連接屬性設置
- 10.1 給鏈接添加鏈接配置接口
- 10.2 鏈接屬性方法實現
- 10.3 鏈接屬性Zinx-V0.10單元測試
- 基于Zinx的應用案例
- 一、應用案例介紹
- 二、服務器應用基礎協議
- 三、MMO多人在線游戲AOI算法
- 3.1 網絡法實現AOI算法
- 3.2 實現AOI格子結構
- 3.3 實現AOI管理模塊
- 3.4 求出九宮格
- 3.5 AOI格子添加刪除操作
- 3.6 AOI模塊單元測試
- 四、數據傳輸協議protocol buffer
- 4.1 簡介
- 4.2 數據交換格式
- 4.3 protobuf環境安裝
- 4.4 protobuf語法
- 4.5 編譯protobuf
- 4.6 利用protobuf生成的類來編碼
- 五、MMO游戲的Proto3協議
- 六、構建項目與用戶上線
- 6.1 構建項目
- 6.2用戶上線流程
- 七、世界聊天系統實現
- 7.1 世界管理模塊
- 7.2 世界聊天系統實現
- 八、上線位置信息同步
- 九、移動位置與AOI廣播(未跨越格子)
- 十、玩家下線
- 十一、移動與AOI廣播(跨越格子)