教你从头写游戏服务器框架
作者:韓偉
前言
大概已經(jīng)有差不多一年沒(méi)寫(xiě)技術(shù)文章了,原因是今年投入了一些具體游戲項(xiàng)目的開(kāi)發(fā)。這些新的游戲項(xiàng)目,比較接近獨(dú)立游戲的開(kāi)發(fā)方式。我覺(jué)得公司的“祖?zhèn)鳌狈?wù)器框架技術(shù)不太適合,所以從頭寫(xiě)了一個(gè)游戲服務(wù)器端的框架,以便獲得更好的開(kāi)發(fā)效率和靈活性。現(xiàn)在項(xiàng)目將近上線(xiàn),有時(shí)間就想總結(jié)一下,這樣一個(gè)游戲服務(wù)器框架的設(shè)計(jì)和實(shí)現(xiàn)過(guò)程。
這個(gè)框架的基本運(yùn)行環(huán)境是 Linux ,采用 C++ 編寫(xiě)。為了能在各種環(huán)境上運(yùn)行和使用,所以采用了 gcc 4.8 這個(gè)“古老”的編譯器,以 C99 規(guī)范開(kāi)發(fā)。
需求
由于“越通用的代碼,就是越?jīng)]用的代碼”,所以在設(shè)計(jì)之初,我就認(rèn)為應(yīng)該使用分層的模式來(lái)構(gòu)建整個(gè)系統(tǒng)。按照游戲服務(wù)器的一般需求劃分,最基本的可以分為兩層:
我希望能有一個(gè)基本完整的“底層基礎(chǔ)功能”的框架,可以被復(fù)用于多個(gè)不同的游戲。由于目標(biāo)是開(kāi)發(fā)一個(gè) 適合獨(dú)立游戲開(kāi)發(fā) 的游戲服務(wù)器框架。所以最基本的需求分析為:
功能性需求
非功能性需求
一旦需求明確下來(lái),基本的層級(jí)結(jié)構(gòu)也可以設(shè)計(jì)了:
| 邏輯層 | 實(shí)現(xiàn)更具體的業(yè)務(wù)邏輯 | 能調(diào)用所有下層代碼,但應(yīng)主要依賴(lài)接口層 |
| 實(shí)現(xiàn)層 | 對(duì)各種具體的通信協(xié)議、存儲(chǔ)設(shè)備等功能的實(shí)現(xiàn) | 滿(mǎn)足下層的接口層來(lái)做實(shí)現(xiàn),禁止同層間互相調(diào)用 |
| 接口層 | 定義了各模塊的基本使用方式,用以隔離具體的實(shí)現(xiàn)和設(shè)計(jì),從而提供互相替換的能力 | 本層之間代碼可以互相調(diào)用,但禁止調(diào)用上層代碼 |
| 工具層 | 提供通用的 C++ 工具庫(kù)功能,如 log/json/ini/日期時(shí)間/字符串處理 等等 | 不應(yīng)該調(diào)用其他層代碼,也不應(yīng)該調(diào)用同層其他模塊 |
| 第三方庫(kù) | 提供諸如 redis/tcaplus 或者其他現(xiàn)成功能,其地位和“工具層”一樣 | 不應(yīng)該調(diào)用其他層代碼,甚至不應(yīng)該修改其源碼 |
最后,整體的架構(gòu)模塊類(lèi)似:
| 功能實(shí)現(xiàn) | TcpUdpKcpTlvLine | JsonHandlerObjectProcessor | SessionLocalCacheRedisMapRamMapZooKeeperMap | FileDataStoreRedisDataStroe |
| 接口定義 | TransferProtocol | ServerClientProcessor | DataMapSerializable | DataStore |
| 工具類(lèi)庫(kù) | ConfigLOGJSONCoroutine |
通信模塊
對(duì)于通信模塊來(lái)說(shuō),需要有靈活的可替換協(xié)議的能力,就必須按一定的層次進(jìn)行進(jìn)一步的劃分。對(duì)于游戲來(lái)說(shuō),最底層的通信協(xié)議,一般會(huì)使用 TCP 和 UDP 這兩種,在服務(wù)器之間,也會(huì)使用消息隊(duì)列中間件一類(lèi)通信軟件。框架必須要有能同事支持這幾通信協(xié)議的能力。故此設(shè)計(jì)了一個(gè)層次為: Transport
在協(xié)議層面,最基本的需求有“分包”“分發(fā)”“對(duì)象序列化”等幾種需求。如果要支持“請(qǐng)求-響應(yīng)”模式,還需要在協(xié)議中帶上“序列號(hào)”的數(shù)據(jù),以便對(duì)應(yīng)“請(qǐng)求”和“響應(yīng)”。另外,游戲通常都是一種“會(huì)話(huà)”式的應(yīng)用,也就是一系列的請(qǐng)求,會(huì)被視為一次“會(huì)話(huà)”,這就需要協(xié)眾需要有類(lèi)似 Session ID 這種數(shù)據(jù)。為了滿(mǎn)足這些需求,設(shè)計(jì)一個(gè)層次為: Protocol
擁有了以上兩個(gè)層次,是可以完成最基本的協(xié)議層能力了。但是,我們往往希望業(yè)務(wù)數(shù)據(jù)的協(xié)議包,能自動(dòng)化的成為編程中的 對(duì)象,所以在處理消息體這里,需要一個(gè)可選的額外層次,用來(lái)把字節(jié)數(shù)組,轉(zhuǎn)換成對(duì)象。所以我設(shè)計(jì)了一個(gè)特別的處理器:ObjectProcessor ,去規(guī)范通信模塊中對(duì)象序列化、反序列化的接口。
| data | Transport | 通信 | buffer |
| buffer | Protocol | 分包 | Message |
| Message | Processor | 分發(fā) | object |
| object | 處理模塊 | 處理 | 業(yè)務(wù)邏輯 |
Transport
此層次是為了統(tǒng)一各種不同的底層傳輸協(xié)議而設(shè)置的,最基本應(yīng)該支持 TCP 和 UDP 這兩種協(xié)議。對(duì)于通信協(xié)議的抽象,其實(shí)在很多底層庫(kù)也做的非常好了,比如 Linux 的 socket 庫(kù),其讀寫(xiě) API 甚至可以和文件的讀寫(xiě)通用。C# 的 Socket 庫(kù)在 TCP 和 UDP 之間,其 api 也幾乎是完全一樣的。但是由于作用游戲服務(wù)器,很多適合還會(huì)接入一些特別的“接入層”,比如一些代理服務(wù)器,或者一些消息中間件,這些 API 可是五花八門(mén)的。另外,在 html5 游戲(比如微信小游戲)和一些頁(yè)游領(lǐng)域,還有用 HTTP 服務(wù)器作為游戲服務(wù)器的傳統(tǒng)(如使用 WebSocket 協(xié)議),這樣就需要一個(gè)完全不同的傳輸層了。
服務(wù)器傳輸層在異步模型下的基本使用序列,就是:
根據(jù)上面三個(gè)特點(diǎn),可以歸納出一個(gè)基本的接口:
class Transport { public: /*** 初始化Transport對(duì)象,輸入Config對(duì)象配置最大連接數(shù)等參數(shù),可以是一個(gè)新建的Config對(duì)象。*/ virtual int Init(Config* config) = 0;/*** 檢查是否有數(shù)據(jù)可以讀取,返回可讀的事件數(shù)。后續(xù)代碼應(yīng)該根據(jù)此返回值循環(huán)調(diào)用Read()提取數(shù)據(jù)。* 參數(shù)fds用于返回出現(xiàn)事件的所有fd列表,len表示這個(gè)列表的最大長(zhǎng)度。如果可用事件大于這個(gè)數(shù)字,并不影響后續(xù)可以Read()的次數(shù)。* fds的內(nèi)容,如果出現(xiàn)負(fù)數(shù),表示有一個(gè)新的終端等待接入。*/virtual int Peek(int* fds, int len) = 0;/*** 讀取網(wǎng)絡(luò)管道中的數(shù)據(jù)。數(shù)據(jù)放在輸出參數(shù) peer 的緩沖區(qū)中。* @param peer 參數(shù)是產(chǎn)生事件的通信對(duì)端對(duì)象。* @return 返回值為可讀數(shù)據(jù)的長(zhǎng)度,如果是 0 表示沒(méi)有數(shù)據(jù)可以讀,返回 -1 表示連接需要被關(guān)閉。*/virtual int Read( Peer* peer) = 0;/*** 寫(xiě)入數(shù)據(jù),output_buf, buf_len為想要寫(xiě)入的數(shù)據(jù)緩沖區(qū),output_peer為目標(biāo)隊(duì)端,* 返回值表示成功寫(xiě)入了的數(shù)據(jù)長(zhǎng)度。-1表示寫(xiě)入出錯(cuò)。*/virtual int Write(const char* output_buf, int buf_len, const Peer& output_peer) = 0;/*** 關(guān)閉一個(gè)對(duì)端的連接*/virtual void ClosePeer(const Peer& peer) = 0;/*** 關(guān)閉Transport對(duì)象。*/virtual void Close() = 0;}在上面的定義中,可以看到需要有一個(gè) Peer 類(lèi)型。這個(gè)類(lèi)型是為了代表通信的客戶(hù)端(對(duì)端)對(duì)象。在一般的 Linux 系統(tǒng)中,一般我們用 fd (File Description)來(lái)代表。但是因?yàn)樵诳蚣苤?#xff0c;我們還需要為每個(gè)客戶(hù)端建立接收數(shù)據(jù)的緩存區(qū),以及記錄通信地址等功能,所以在 fd 的基礎(chǔ)上封裝了一個(gè)這樣的類(lèi)型。這樣也有利于把 UDP 通信以不同客戶(hù)端的模型,進(jìn)行封裝。
///@brief 此類(lèi)型負(fù)責(zé)存放連接過(guò)來(lái)的客戶(hù)端信息和數(shù)據(jù)緩沖區(qū) class Peer { public: int buf_size_; ///< 緩沖區(qū)長(zhǎng)度char* const buffer_;///< 緩沖區(qū)起始地址int produced_pos_; ///< 填入了數(shù)據(jù)的長(zhǎng)度int consumed_pos_; ///< 消耗了數(shù)據(jù)的長(zhǎng)度int GetFd() const;void SetFd(int fd); /// 獲得本地地址const struct sockaddr_in& GetLocalAddr() const;void SetLocalAddr(const struct sockaddr_in& localAddr); /// 獲得遠(yuǎn)程地址const struct sockaddr_in& GetRemoteAddr() const;void SetRemoteAddr(const struct sockaddr_in& remoteAddr);private:int fd_; ///< 收發(fā)數(shù)據(jù)用的fdstruct sockaddr_in remote_addr_; ///< 對(duì)端地址struct sockaddr_in local_addr_; ///< 本端地址 };游戲使用 UDP 協(xié)議的特點(diǎn):一般來(lái)說(shuō) UDP 是無(wú)連接的,但是對(duì)于游戲來(lái)說(shuō),是肯定需要有明確的客戶(hù)端的,所以就不能簡(jiǎn)單用一個(gè) UDP socket 的fd 來(lái)代表客戶(hù)端,這就造成了上層的代碼無(wú)法簡(jiǎn)單在 UDP 和 TCP 之間保持一致。因此這里使用 Peer 這個(gè)抽象層,正好可以接近這個(gè)問(wèn)題。這也可以用于那些使用某種消息隊(duì)列中間件的情況,因?yàn)榭赡苓@些中間件,也是多路復(fù)用一個(gè) fd 的,甚至可能就不是通過(guò)使用 fd 的 API 來(lái)開(kāi)發(fā)的。
對(duì)于上面的 Transport 定義,對(duì)于 TCP 的實(shí)現(xiàn)者來(lái)說(shuō),是非常容易能完成的。但是對(duì)于 UDP 的實(shí)現(xiàn)者來(lái)說(shuō),則需要考慮如何寵妃利用 Peer ,特別是 Peer.fd_ 這個(gè)數(shù)據(jù)。我在實(shí)現(xiàn)的時(shí)候,使用了一套虛擬的 fd 機(jī)制,通過(guò)一個(gè)客戶(hù)端的 IPv4 地址到 int 的對(duì)應(yīng) Map ,來(lái)對(duì)上層提供區(qū)分客戶(hù)端的功能。在 Linux 上,這些 IO 都可以使用 epoll 庫(kù)來(lái)實(shí)現(xiàn),在 Peek() 函數(shù)中讀取 IO 事件,在 Read()/Write() 填上 socket 的調(diào)用就可以了。
另外,為了實(shí)現(xiàn)服務(wù)器之間的通信,還需要設(shè)計(jì)和 Tansport 對(duì)應(yīng)的一個(gè)類(lèi)型:Connector 。這個(gè)抽象基類(lèi),用于以客戶(hù)端模型對(duì)服務(wù)器發(fā)起請(qǐng)求。其設(shè)計(jì)和 Transport 大同小異。除了 Linux 環(huán)境下的 Connecotr ,我還實(shí)現(xiàn)了在 C# 下的代碼,以便用 Unity 開(kāi)發(fā)的客戶(hù)端可以方便的使用。由于 .NET 本身就支持異步模型,所以其實(shí)現(xiàn)也不費(fèi)太多功夫。
/*** @brief 客戶(hù)端使用的連接器類(lèi),代表傳輸協(xié)議,如 TCP 或 UDP*/ class Connector {public: virtual ~Connector() {} /*** @brief 初始化建立連接等* @param config 需要的配置* @return 0 為成功*/virtual int Init(Config* config) = 0;/*** @brief 關(guān)閉*/virtual void Close() = 0;/*** @brief 讀取是否有網(wǎng)絡(luò)數(shù)據(jù)到來(lái)* 讀取有無(wú)數(shù)據(jù)到來(lái),返回值為可讀事件的數(shù)量,通常為1* 如果為0表示沒(méi)有數(shù)據(jù)可以讀取。* 如果返回 -1 表示出現(xiàn)網(wǎng)絡(luò)錯(cuò)誤,需要關(guān)閉此連接。* 如果返回 -2 表示此連接成功連上對(duì)端。* @return 網(wǎng)絡(luò)數(shù)據(jù)的情況*/virtual int Peek() = 0;/*** @brief 讀取網(wǎng)絡(luò)數(shù) * 讀取連接里面的數(shù)據(jù),返回讀取到的字節(jié)數(shù),如果返回0表示沒(méi)有數(shù)據(jù),* 如果buffer_length是0, 也會(huì)返回0,* @return 返回-1表示連接需要關(guān)閉(各種出錯(cuò)也返回0)*/virtual int Read(char* ouput_buffer, int buffer_length) = 0;/*** @brief 把input_buffer里的數(shù)據(jù)寫(xiě)入網(wǎng)絡(luò)連接,返回寫(xiě)入的字節(jié)數(shù)。* @return 如果返回-1表示寫(xiě)入出錯(cuò),需要關(guān)閉此連接。*/virtual int Write(const char* input_buffer, int buffer_length) = 0;protected:Connector(){} };Protocol
對(duì)于通信“協(xié)議”來(lái)說(shuō),其實(shí)包含了許許多多的含義。在眾多的需求中,我所定義的這個(gè)協(xié)議層,只希望完成四個(gè)最基本的能力:
除了以上三個(gè)功能,實(shí)際上希望在協(xié)議層處理的能力,還有很多,最典型的就是對(duì)象序列化的功能,還有壓縮、加密功能等等。我之所以沒(méi)有把對(duì)象序列化的能力放在 Protocol 中,原因是對(duì)象序列化中的“對(duì)象”本身是一個(gè)業(yè)務(wù)邏輯關(guān)聯(lián)性非常強(qiáng)的概念。在 C++ 中,并沒(méi)有完整的“對(duì)象”模型,也缺乏原生的反射支持,所以無(wú)法很簡(jiǎn)單的把代碼層次通過(guò)“對(duì)象”這個(gè)抽象概念劃分開(kāi)來(lái)。但是我也設(shè)計(jì)了一個(gè) ObjectProcessor ,把對(duì)象序列化的支持,以更上層的形式結(jié)合到框架中。這個(gè) Processor 是可以自定義對(duì)象序列化的方法,這樣開(kāi)發(fā)者就可以自己選擇任何“編碼、解碼”的能力,而不需要依靠底層的支持。
至于壓縮和加密這一類(lèi)功能,確實(shí)是可以放在 Protocol 層中實(shí)現(xiàn),甚至可以作為一個(gè)抽象層次加入 Protocol ,可能只有一個(gè) Protocol 層不足以支持這么豐富的功能,需要好像 Apache Mina 這樣,設(shè)計(jì)一個(gè)“調(diào)用鏈”的模型。但是為了簡(jiǎn)單起見(jiàn),我覺(jué)得在具體需要用到的地方,再額外添加 Protocol 的實(shí)現(xiàn)類(lèi)就好,比如添加一個(gè)“帶壓縮功能的 TLV Protocol 類(lèi)型”之類(lèi)的。
消息本身被抽象成一個(gè)叫 Message 的類(lèi)型,它擁有“服務(wù)名字”“會(huì)話(huà)ID”兩個(gè)消息頭字段,用以完成“分發(fā)”和“會(huì)話(huà)保持”功能。而消息體則被放在一個(gè)字節(jié)數(shù)組中,并記錄下字節(jié)數(shù)組的長(zhǎng)度。
enum MessageType {TypeError, ///< 錯(cuò)誤的協(xié)議TypeRequest, ///< 請(qǐng)求類(lèi)型,從客戶(hù)端發(fā)往服務(wù)器TypeResponse, ///< 響應(yīng)類(lèi)型,服務(wù)器收到請(qǐng)求后返回TypeNotice ///< 通知類(lèi)型,服務(wù)器主動(dòng)通知客戶(hù)端 };///@brief 通信消息體的基類(lèi) ///基本上是一個(gè) char[] 緩沖區(qū) struct Message { public:static int MAX_MAESSAGE_LENGTH;static int MAX_HEADER_LENGTH;MessageType type; ///< 此消息體的類(lèi)型(MessageType)信息virtual ~Message(); virtual Message& operator=(const Message& right);/*** @brief 把數(shù)據(jù)拷貝進(jìn)此包體緩沖區(qū)*/void SetData(const char* input_ptr, int input_length);///@brief 獲得數(shù)據(jù)指針inline char* GetData() const{return data_;}///@brief 獲得數(shù)據(jù)長(zhǎng)度inline int GetDataLen() const{return data_len_;}char* GetHeader() const;int GetHeaderLen() const;protected:Message();Message(const Message& message);private:char* data_; // 包體內(nèi)容緩沖區(qū)int data_len_; // 包體長(zhǎng)度};根據(jù)之前設(shè)計(jì)的“請(qǐng)求響應(yīng)”和“通知”兩種通信模式,需要設(shè)計(jì)出三種消息類(lèi)型繼承于 Message,他們是:
- Request 請(qǐng)求包
- Response 響應(yīng)包
- Notice 通知包
Request 和 Response 兩個(gè)類(lèi),都有記錄序列號(hào)的 seq_id 字段,但 Notice 沒(méi)有。Protocol 類(lèi)就是負(fù)責(zé)把一段 buffer 字節(jié)數(shù)組,轉(zhuǎn)換成 Message 的子類(lèi)對(duì)象。所以需要針對(duì)三種 Message 的子類(lèi)型都實(shí)現(xiàn)對(duì)應(yīng)的 Encode() / Decode() 方法。
class Protocol {public:virtual ~Protocol() {}/*** @brief 把請(qǐng)求消息編碼成二進(jìn)制數(shù)據(jù)* 編碼,把msg編碼到buf里面,返回寫(xiě)入了多長(zhǎng)的數(shù)據(jù),如果超過(guò)了 len,則返回-1表示錯(cuò)誤。* 如果返回 0 ,表示不需要編碼,框架會(huì)直接從 msg 的緩沖區(qū)讀取數(shù)據(jù)發(fā)送。* @param buf 目標(biāo)數(shù)據(jù)緩沖區(qū)* @param offset 目標(biāo)偏移量* @param len 目標(biāo)數(shù)據(jù)長(zhǎng)度* @param msg 輸入消息對(duì)象* @return 編碼完成所用的字節(jié)數(shù),如果 < 0 表示出錯(cuò)*/virtual int Encode(char* buf, int offset, int len, const Request& msg) = 0;/*** 編碼,把msg編碼到buf里面,返回寫(xiě)入了多長(zhǎng)的數(shù)據(jù),如果超過(guò)了 len,則返回-1表示錯(cuò)誤。* 如果返回 0 ,表示不需要編碼,框架會(huì)直接從 msg 的緩沖區(qū)讀取數(shù)據(jù)發(fā)送。* @param buf 目標(biāo)數(shù)據(jù)緩沖區(qū)* @param offset 目標(biāo)偏移量* @param len 目標(biāo)數(shù)據(jù)長(zhǎng)度* @param msg 輸入消息對(duì)象* @return 編碼完成所用的字節(jié)數(shù),如果 < 0 表示出錯(cuò)*/virtual int Encode(char* buf, int offset, int len, const Response& msg) = 0;/*** 編碼,把msg編碼到buf里面,返回寫(xiě)入了多長(zhǎng)的數(shù)據(jù),如果超過(guò)了 len,則返回-1表示錯(cuò)誤。* 如果返回 0 ,表示不需要編碼,框架會(huì)直接從 msg 的緩沖區(qū)讀取數(shù)據(jù)發(fā)送。* @param buf 目標(biāo)數(shù)據(jù)緩沖區(qū)* @param offset 目標(biāo)偏移量* @param len 目標(biāo)數(shù)據(jù)長(zhǎng)度* @param msg 輸入消息對(duì)象* @return 編碼完成所用的字節(jié)數(shù),如果 < 0 表示出錯(cuò)*/virtual int Encode(char* buf, int offset, int len, const Notice& msg) = 0;/*** 開(kāi)始編碼,會(huì)返回即將解碼出來(lái)的消息類(lèi)型,以便使用者構(gòu)造合適的對(duì)象。* 實(shí)際操作是在進(jìn)行“分包”操作。* @param buf 輸入緩沖區(qū)* @param offset 輸入偏移量* @param len 緩沖區(qū)長(zhǎng)度* @param msg_type 輸出參數(shù),表示下一個(gè)消息的類(lèi)型,只在返回值 > 0 的情況下有效,否則都是 TypeError* @return 如果返回0表示分包未完成,需要繼續(xù)分包。如果返回-1表示協(xié)議包頭解析出錯(cuò)。其他返回值表示這個(gè)消息包占用的長(zhǎng)度。*/virtual int DecodeBegin(const char* buf, int offset, int len,MessageType* msg_type) = 0;/*** 解碼,把之前DecodeBegin()的buf數(shù)據(jù)解碼成具體消息對(duì)象。* @param request 輸出參數(shù),解碼對(duì)象會(huì)寫(xiě)入此指針* @return 返回0表示成功,-1表示失敗。*/virtual int Decode(Request* request) = 0;/*** 解碼,把之前DecodeBegin()的buf數(shù)據(jù)解碼成具體消息對(duì)象。* @param request 輸出參數(shù),解碼對(duì)象會(huì)寫(xiě)入此指針* @return 返回0表示成功,-1表示失敗。*/virtual int Decode(Response* response) = 0;/*** 解碼,把之前DecodeBegin()的buf數(shù)據(jù)解碼成具體消息對(duì)象。* @param request 輸出參數(shù),解碼對(duì)象會(huì)寫(xiě)入此指針* @return 返回0表示成功,-1表示失敗。*/virtual int Decode(Notice* notice) = 0;protected:Protocol() {}};這里有一點(diǎn)需要注意,由于 C++ 沒(méi)有內(nèi)存垃圾搜集和反射的能力,在解釋數(shù)據(jù)的時(shí)候,并不能一步就把一個(gè) char[] 轉(zhuǎn)換成某個(gè)子類(lèi)對(duì)象,而必須分成兩步處理。
對(duì)于 Protocol 的具體實(shí)現(xiàn)子類(lèi),我首先實(shí)現(xiàn)了一個(gè) LineProtocol ,是一個(gè)非常不嚴(yán)謹(jǐn)?shù)?#xff0c;基于文本ASCII編碼的,用空格分隔字段,用回車(chē)分包的協(xié)議。用來(lái)測(cè)試這個(gè)框架是否可行。因?yàn)檫@樣可以直接通過(guò) telnet 工具,來(lái)測(cè)試協(xié)議的編解碼。然后我按照 TLV (Type Length Value)的方法設(shè)計(jì)了一個(gè)二進(jìn)制的協(xié)議。大概的定義如下:
協(xié)議分包: [消息類(lèi)型:int:2] [消息長(zhǎng)度:int:4] [消息內(nèi)容:bytes:消息長(zhǎng)度]
消息類(lèi)型取值:
- 0x00 Error
- 0x01 Request
- 0x02 Response
- 0x03 Notice
| Request | 服務(wù)名 | 字段:int:2[字符串內(nèi)容:chars:消息長(zhǎng)度] |
| 序列號(hào) | 字段:int:2 | |
| 會(huì)話(huà)ID | 字段:int:2 | |
| 消息體 | 字段:int:2[字符串內(nèi)容:chars:消息長(zhǎng)度] | |
| Response | 服務(wù)名 | 字段:int:2[字符串內(nèi)容:chars:消息長(zhǎng)度] |
| 序列號(hào) | 字段:int:2 | |
| 會(huì)話(huà)ID | 字段:int:2 | |
| 消息體 | 字段:int:2[字符串內(nèi)容:chars:消息長(zhǎng)度] | |
| Notice | 服務(wù)名 | 字段:int:2[字符串內(nèi)容:chars:消息長(zhǎng)度] |
| 消息體 | 字段:int:2[字符串內(nèi)容:chars:消息長(zhǎng)度] |
一個(gè)名為 TlvProtocol 的類(lèi)型完成對(duì)這個(gè)協(xié)議的實(shí)現(xiàn)。
Processor
處理器層是我設(shè)計(jì)用來(lái)對(duì)接具體業(yè)務(wù)邏輯的抽象層,它主要通過(guò)輸入?yún)?shù) Request 和 Peer 來(lái)獲得客戶(hù)端的輸入數(shù)據(jù),然后通過(guò) Server 類(lèi)的 Reply()/Inform() 來(lái)返回 Response 和 Notice 消息。實(shí)際上 Transport 和 Protocol 的子類(lèi)們,都屬于 net 模塊,而各種 Processor 和 Server/Client 這些功能類(lèi)型,屬于另外一個(gè) processor 模塊。這樣設(shè)計(jì)的原因,是希望所有 processor 模塊的代碼單向的依賴(lài) net 模塊的代碼,但反過(guò)來(lái)不成立。
Processor 基類(lèi)非常簡(jiǎn)單,就是一個(gè)處理函數(shù)回調(diào)函數(shù)入口 Process():
///@brief 處理器基類(lèi),提供業(yè)務(wù)邏輯回調(diào)接口class Processor {public:Processor();virtual ~Processor();/*** 初始化一個(gè)處理器,參數(shù)server為業(yè)務(wù)邏輯提供了基本的能力接口。*/virtual int Init(Server* server, Config* config = NULL);/*** 處理請(qǐng)求-響應(yīng)類(lèi)型包實(shí)現(xiàn)此方法,返回值是0表示成功,否則會(huì)被記錄在錯(cuò)誤日志中。* 參數(shù)peer表示發(fā)來(lái)請(qǐng)求的對(duì)端情況。其中 Server 對(duì)象的指針,可以用來(lái)調(diào)用 Reply(),* Inform() 等方法。如果是監(jiān)聽(tīng)多個(gè)服務(wù)器,server 參數(shù)則會(huì)是不同的對(duì)象。*/virtual int Process(const Request& request, const Peer& peer,Server* server);/*** 關(guān)閉清理處理器所占用的資源*/virtual int Close(); };設(shè)計(jì)完 Transport/Protocol/Processor 三個(gè)通信處理層次后,就需要一個(gè)組合這三個(gè)層次的代碼,那就是 Server 類(lèi)。這個(gè)類(lèi)在 Init() 的時(shí)候,需要上面三個(gè)類(lèi)型的子類(lèi)作為參數(shù),以組合成不同功能的服務(wù)器,如:
TlvProtocol tlv_protocol; // Type Length Value 格式分包協(xié)議,需要和客戶(hù)端一致 TcpTransport tcp_transport; // 使用 TCP 的通信協(xié)議,默認(rèn)監(jiān)聽(tīng) 0.0.0.0:6666 EchoProcessor echo_processor; // 業(yè)務(wù)邏輯處理器 Server server; // DenOS 的網(wǎng)絡(luò)服務(wù)器主對(duì)象 server.Init(&tcp_transport, &tlv_protocol, &echo_processor); // 組裝一個(gè)游戲服務(wù)器對(duì)象:TLV 編碼、TCP 通信和回音服務(wù)Server 類(lèi)型還需要一個(gè) Update() 函數(shù),讓用戶(hù)進(jìn)程的“主循環(huán)”不停的調(diào)用,用來(lái)驅(qū)動(dòng)整個(gè)程序的運(yùn)行。這個(gè) Update() 函數(shù)的內(nèi)容非常明確:
另外,Server 還需要處理一些額外的功能,比如維護(hù)一個(gè)會(huì)話(huà)緩存池(Session),提供發(fā)送 Response 和 Notice 消息的接口。當(dāng)這些工作都完成后,整套系統(tǒng)已經(jīng)可以用來(lái)作為一個(gè)比較“通用”的網(wǎng)絡(luò)消息服務(wù)器框架存在了。剩下的就是添加各種 Transport/Protocol/Processor 子類(lèi)的工作。
class Server {public:Server();virtual ~Server();/*** 初始化服務(wù)器,需要選擇組裝你的通信協(xié)議鏈*/int Init(Transport* transport, Protocol* protocol, Processor* processor, Config* config = NULL);/*** 阻塞方法,進(jìn)入主循環(huán)。*/void Start();/*** 需要循環(huán)調(diào)用驅(qū)動(dòng)的方法。如果返回值是0表示空閑。其他返回值表示處理過(guò)的任務(wù)數(shù)。*/virtual int Update();void ClosePeer(Peer* peer, bool is_clear = false); //關(guān)閉當(dāng)個(gè)連接,is_clear 表示是否最終整體清理/*** 關(guān)閉服務(wù)器*/void Close();/*** 對(duì)某個(gè)客戶(hù)端發(fā)送通知消息,* 參數(shù)peer代表要通知的對(duì)端。*/int Inform(const Notice& notice, const Peer& peer);/*** 對(duì)某個(gè) Session ID 對(duì)應(yīng)的客戶(hù)端發(fā)送通知消息,返回 0 表示可以發(fā)送,其他值為發(fā)送失敗。* 此接口能支持?jǐn)嗑€(xiàn)重連,只要客戶(hù)端已經(jīng)成功連接,并使用舊的 Session ID,同樣有效。*/int Inform(const Notice& notice, const std::string& session_id);/*** 對(duì)某個(gè)客戶(hù)端發(fā)來(lái)的Request發(fā)回回應(yīng)消息。* 參數(shù)response的成員seqid必須正確填寫(xiě),才能正確回應(yīng)。* 返回0成功,其它值(-1)表示失敗。*/int Reply(Response* response, const Peer& peer);/*** 對(duì)某個(gè) Session ID 對(duì)應(yīng)的客戶(hù)端發(fā)送回應(yīng)消息。* 參數(shù) response 的 seqid 成員系統(tǒng)會(huì)自動(dòng)填寫(xiě)會(huì)話(huà)中記錄的數(shù)值。* 此接口能支持?jǐn)嗑€(xiàn)重連,只要客戶(hù)端已經(jīng)成功連接,并使用舊的 Session ID,同樣有效。* 返回0成功,其它值(-1)表示失敗。*/int Reply(Response* response, const std::string& session_id);/*** 會(huì)話(huà)功能*/Session* GetSession(const std::string& session_id = "", bool use_this_id = false);Session* GetSessionByNumId(int session_id = 0);bool IsExist(const std::string& session_id);};有了 Server 類(lèi)型,肯定也需要有 Client 類(lèi)型。而 Client 類(lèi)型的設(shè)計(jì)和 Server 類(lèi)似,但就不是使用 Transport 接口作為傳輸層,而是 Connector 接口。不過(guò) Protocol 的抽象層是完全重用的。Client 并不需要 Processor 這種形式的回調(diào),而是直接傳入接受數(shù)據(jù)消息就發(fā)起回調(diào)的接口對(duì)象 ClientCallback。
class ClientCallback {public:ClientCallback() {}virtual ~ClientCallback() {// Do nothing}/*** 當(dāng)連接建立成功時(shí)回調(diào)此方法。* @return 返回 -1 表示不接受這個(gè)連接,需要關(guān)閉掉此連接。*/virtual int OnConnected() {return 0;}/*** 當(dāng)網(wǎng)絡(luò)連接被關(guān)閉的時(shí)候,調(diào)用此方法*/virtual void OnDisconnected() { // Do nothing}/*** 收到響應(yīng),或者請(qǐng)求超時(shí),此方法會(huì)被調(diào)用。* @param response 從服務(wù)器發(fā)來(lái)的回應(yīng)* @return 如果返回非0值,服務(wù)器會(huì)打印一行錯(cuò)誤日志。*/virtual int Callback(const Response& response) {return 0;}/*** 當(dāng)請(qǐng)求發(fā)生錯(cuò)誤,比如超時(shí)的時(shí)候,返回這個(gè)錯(cuò)誤* @param err_code 錯(cuò)誤碼*/virtual void OnError(int err_code){WARN_LOG("The request is timeout, err_code: %d", err_code);}/*** 收到通知消息時(shí),此方法會(huì)被調(diào)用*/virtual int Callback(const Notice& notice) {return 0;}/*** 返回此對(duì)象是否應(yīng)該被刪除。此方法會(huì)被在 Callback() 調(diào)用前調(diào)用。* @return 如果返回 true,則會(huì)調(diào)用 delete 此對(duì)象的指針。*/virtual bool ShouldBeRemoved() {return false;} };class Client : public Updateable {public:Client(); virtual ~Client();/*** 連接服務(wù)器* @param connector 傳輸協(xié)議,如 TCP, UDP ...* @param protocol 分包協(xié)議,如 TLV, Line, TDR ...* @param notice_callback 收到通知后觸發(fā)的回調(diào)對(duì)象,如果傳輸協(xié)議有“連接概念”(如TCP/TCONND),建立、關(guān)閉連接時(shí)也會(huì)調(diào)用。* @param config 配置文件對(duì)象,將讀取以下配置項(xiàng)目:MAX_TRANSACTIONS_OF_CLIENT 客戶(hù)端最大并發(fā)連接數(shù); BUFFER_LENGTH_OF_CLIENT客戶(hù)端收包緩存;CLIENT_RESPONSE_TIMEOUT 客戶(hù)端響應(yīng)等待超時(shí)時(shí)間。* @return 返回 0 表示成功,其他表示失敗*/int Init(Connector* connector, Protocol* protocol,ClientCallback* notice_callback = NULL, Config* config = NULL);/*** callback 參數(shù)可以為 NULL,表示不需要回應(yīng),只是單純的發(fā)包即可。*/virtual int SendRequest(Request* request, ClientCallback* callback = NULL);/*** 返回值表示有多少數(shù)據(jù)需要處理,返回-1為出錯(cuò),需要關(guān)閉連接。返回0表示沒(méi)有數(shù)據(jù)需要處理。*/virtual int Update();virtual void OnExit();void Close();Connector* connector() ;ClientCallback* notice_callback() ;Protocol* protocol() ; };至此,客戶(hù)端和服務(wù)器端基本設(shè)計(jì)完成,可以直接通過(guò)編寫(xiě)測(cè)試代碼,來(lái)檢查是否運(yùn)行正常。
此文已由騰訊云+社區(qū)在各渠道發(fā)布,一切權(quán)利歸作者所有
獲取更多新鮮技術(shù)干貨,可以關(guān)注我們騰訊云技術(shù)社區(qū)-云加社區(qū)官方號(hào)及知乎機(jī)構(gòu)號(hào)
總結(jié)
以上是生活随笔為你收集整理的教你从头写游戏服务器框架的全部?jī)?nèi)容,希望文章能夠幫你解決所遇到的問(wèn)題。
- 上一篇: OA总结
- 下一篇: POJ2774 Long Long Me