棋牌游戏架构

一、物理架构说明

游戏系统组件包括：

• 服务器系统（中心服务器控制系统，服务器登陆控制系统，游戏登陆服务器，游戏房间控制系统，游戏组件系统），游戏客户端（游戏大厅，游戏组件）。
• 数据库系统：用于保存用户信息数据、游戏积分数据、游戏系统运行状态数据，系统日志数据等数据。
• 中心服务器控制系统：用于向客户端提供全局配置,初始化数据使用。
• 服务器登陆控制系统：用于房间服务控制系统登陆效验使用。
• 游戏房间控制系统：用于控制游戏房间的启动，停止，添加，删除，管理等。
• 游戏组件系统：用于具体游戏服务，被游戏房间控制系统挂接，提供游戏服务。
• 游戏大厅：游戏玩家连接游戏使用。

二、系统结构

      系统选用的开发工具是优秀的Microsoft Visual C++.net2003，系统采用客户端/服务器（C/S）编程模式，TCP/IP协议作为客户端和服务器的通信网络层，运用具有性能最优的完成端口（IOCP：Input/Output Completion Port ）网络开发模型搭建服务器软件.客户端采用WinSocket API作为网络层。

系统采用多服务器分布式架构，由一个中心服务器(CENTERSERVER),多个主服务器（MainServer）和多个从服务器（LocalServer）同时工作以实现游戏逻辑和用户管理及通讯的功能。中心服务器向客户端提供全局配置,初始化数据(主要是定位一个主服务器IP地址),主服务器管理客户端用户身份验证、登录以及管理从服务器的建立,由多个从服务器管理游戏通信,大厅及房间,从服务器可任意添加、删除、修改等。

系统首先启动中心服务器(CENTERSERVER), 中心服务器从INI文件中读取MainServer列表信息, 客户端提供全局配置,初始化数据,然后等待客户联结, 客户联结后CENTERSERVER定位一个MainServer的IP地址和端口号,发往客户端, 客户端收到后断开CENTERSERVER的联接,并马上用MainServer的IP地址和端口号,和主服务器（MainServer）连接.主服务器从数据库中读取从服务器的所有信息到主服务器的内存。首先读取ComType表以建立所有的游戏类型的基本信息，然后读取ServiceInfo（界面树结点信息表）以获得包括客户端界面结构、从服务器的信息、大厅和房间的一切信息。当有客户端请求登录并成功和主服务器连接的时候，主服务器将这所有的信息一次性发到客户端内存，客户端根据这些信息生成界面结构树。

主服务器启动后还可以在主服务器里创建多个从服务器及房间，创建完成后从服务器的IP地址及端口号就作为它的唯一标识被同时写进数据库和主服务器的内存；房间号、房间所属的游戏类型、所属的从服务器号也作为房间的唯一标识被同时写进数据库和主服务器的内存。

从服务器创建以后就在它所属的机器上启动。

客户端登录后首先和主服务器建立连接（并且一直到客户端退出才断开）连接成功后生成界面结构树（前述），当用户点击某个游戏房间的时候系统从内存中读出这个房间的所有信息（前述），根据房间所属从服务器的IP地址及端口号试图和这个从服务器建立连接，连接成功后相应的从服务器就将这个房间的所有信息发到这个客户端，客户端收到以后就根据这些信息生成房间。每当有客户端的游戏位置发生改变的时候就向从服务器发送改变信息，从服务器保存、修改所有与它连接的客户端的位置信息列表。

当一张桌子坐满时游戏开始。游戏开始后客户端也是和从服务器通信以更新游戏信息。 当客户端退出游戏后就回到大厅的这个房间，当退出大厅的时候首先和从服务器断开连接，然后和主服务器断开连接，最后终止整个客户端程序。

三、模块结构

     系统包括三大主要模块结构：MainServer，LocalServer，Com.此外还有客户端安装，更新模块等。在三大主要模块结构中还有子DLL（动态链接库）模块。

1、MainServer（EXE项目）：封装主服务器功能，包括管理客户端用户身份验证、登录以及管理从服务器的建立，数据库读写等。

2、LocalServer（EXE项目）：封装从服务器功能，包括管理客户端游戏通信,游戏逻辑，大厅及房间等。

3、Com（EXE项目）：封装客户端所有功能，包括客户端登录，大厅及房间，客户端游戏通信,游戏逻辑等。Com包括以下子模块：

1. 客户端通用库PubLib(DLL模块)封装了客户端通用的调用接口，控件，类。供客户端所有的模块调用.
2. 麻将游戏通用库MJLib(DLL模块)封装了客户端麻将游戏通用的调用接口类和十堰麻将类。通用的调用接口类供特殊的麻将游戏模块调用。
3. 扑克牌游戏通用库PisaLib(DLL模块)封装了客户端扑克牌游戏通用的调用接口类。通用的调用接口类供特殊的扑克牌游戏模块调用。
4. 大厅库RoomLib(DLL模块)封装了客户端大厅的调用接口。
5. 象棋库XQLib(DLL模块)封装了客户端象棋的调用接口。
6. 围棋库XQLib(DLL模块)封装了客户端围棋的调用接口。
7. 军棋库XQLib(DLL模块)封装了客户端军棋的调用接口。

• 服务器架构示意图：

组件模块结构示意图：

                                                            

          

       组件模块以中心数据管理模块为中心，数据库处理模块和SOCKET管理模块提供外部操作联系。以下是对每个模块的功能和接口的介绍：

1. 中心数据管理模块继承于CBaseMainManage类，主要是协调各个模块的联系，处理模块的逻辑处理，保证数据的完整性和合理性和合法性。中心数据管理类是单线程类，使用单线程的目的是为了使数据的处理避免了同步问题，数据的操作不需要使用临界变量锁定数据，加快了处理速度，但前题条件是数据处理中，不能出现长时间的数据等待，锁定操作存在。中心数据管理类实现了IServerSocketService网络数据处理接口和IDataBaseResultService数据库结果处理接口，提供了网络模块和数据库模块的进入接口，这两个接口是供网络模块和数据库模块调用（意思就是调用线程不是于中心管理模块的处于同一线程内，要注意数据同步问题）。数据管理模块对于这些接口调用的处理方式是先把投入的数据处理包分类，分别分为网络定时器数据包，网络读取数据包，网络连接关闭数据包，数据库结果数据包，打包为数据管理类识别的数据形式，投递到数据管理类的处理队列，等待数据管理类处理。当中心数据管理类需要投递数据库操作的时候，就通过数据管理类的IDataBaseHandleService接口投递请求（异步方式），当数据库处理完毕后，数据库管理模块会调用中心管理类的IDataBaseResultService数据库结果接口。
2. SOCKET 管理模块CTCPSocketManage类，主要是实现了管理网络连接资源，处理网络SOCET的读写操作，主要提供了单SOCKET发送函数，群发SOCKET函数，SOCKET关闭函数，提供SOCKET事件通知。网络管理类是多线程处理类。单 SOCKET 发送函数是 SendData 函数，存在着多种重载实现，提供不同的数据发送请求，群发 SOCKET 函数是 SendDataBatch 函数，关闭 SOCKET 函数是 CloseSocket 函数，存在着多种重载实现，当发送了网络消息读取事件，此类主要是通过调用OnNetMessage 虚拟函数，利用IServerSocketService接口把数据读取数据包投递到中心数据管理类。当网络关闭的时候，也通过IServerSocketService接口把数据读取数据包投递到中心数据管理类。（详细的实现见代码）
   • static unsigned __stdcall ThreadAccept(LPVOID pThreadData) （SOCKET 连接应答线程）

   网络应答线程，等待外部连接，激活一个空闲的 SOCKET 对象，设置 SOCKET 参数，并把这新的 SOCKET 对象绑定到完成端口，然后投递缓冲区为零的数据读取操作调用，继续等待下一个外部连接，详细的算法见代码。

3. static unsigned __stdcall ThreadRSSocket(LPVOID pThreadData) （SOCKET 数据接收线程）

一个网络管理类提供了 CUP*2+2 个 SOCKET 消息响应线程，负责处理网络数据的发送，读取，关闭消息处理，详细的算法见代码。

static unsigned __stdcall ThreadBatchSend(LPVOID pThreadData) （SOCKET 批量发送数据线程）

一个网络管理类提供了一个数据群发线程，负责处理数据的群发异步操作。此线程采用优化的队列方式处理群发数据，避免了队列的数据移动而带来的数据拷贝操作，加快了处理速度，详细的算法见代码。

static unsigned __stdcall ThreadKeepActive(LPVOID pThreadData) （SOCKET 维护线程）

一个网络管理类提供了一个SOCKET 维护线程，负责维护断线或者超时的 SOCKET 对象，每个 SOCKET 对象自动被激活开始，服务器就会大约 15 秒向客户端发送一个检测数据包，客户端会在收到此检测数据包的时候马上向服务器返回同样的检测数据包。在这前题条件下，维护线程就会大约 15 秒向所有的 SOCKET 对象都发送一个检测数据包，并关闭掉没有响应的 SOCKET 对象，详细的算法见代码。

主要有的线程介绍：

数据库管理模块，主要包括了数据库管理CAFCDataBaseManage类和数据库处理CDataBaseHandle类（继承于IDataBaseHandleService接口）。CAFCDataBaseManage只实现了数据的连接、关闭操作和数据库操作请求的投递任务，而实际的数据处理是根据不同的模块进行不同的数据库处理操作，通过CDataBaseHandle实现实际的数据操作。这样就避免了不同的数据库操作重复编写数据库的维护，连接等代码。CAFCDataBaseManage在会启动一个DataServiceThread线程，等待数据库处理请求操作数据包，交到类的成员变量CDataBaseHandle指针处理。

模块编写实际类分布：

                                         

      每个游戏模块（继承于IModuleManageService接口），都包含了数据管理模块（继承于CBaseMainManage类）和数据库处理模块（继承于CDtaBaseHandle类），实现了模块的启动，停止，初始化，卸载功能，每个模块需要继承重写的部分就是数据库处理模块和数据管理模块；
      数据管理模块包含了此组件的数据信息，逻辑处理，负责处理和发送网络数据包，更具需要投递数据库处理请求，处理数据库处理结果。实现了网络数据包投递接口，数据库处理结果处理接口；
      数据库处理模块包含了处理数据库请求处理，发送数据库处理结果到数据管理模块处理。实现了根据请求，实现合适的数据库操作；
      数据库管理类和网络管理类对象存在于CBaseMainManage类中，而实际的数据库操作类是个独立的类，存在于模块管理类中，在模块初始化的时候把此类的对象指针传递到数据库管理类，供数据库管理类调用。

 

 

游戏房间模块示意说明：

      游戏房间模块是应用得最多模块之一，于其他模块最大的不同点的是中心数据管理类（继承于CbaseMainManage类的CComMainManage类；
      数据管理类继承于基础数据管理类，还存在CComUserInfoManage用户管理类和CComDesk游戏桌子类对象数据。