棋牌游戏服务器架构: 详细设计(一) 内核设计
内核的几个组件被设计成Service,也就是说这几个模块都要实现如下接口:
图1 IService接口
Start方法用来启动服务。
Stop 方法用来关闭服务。
IsService 方法用于查询当前服务是否正在工作。
内核中的几个Service都不能够直接创建，Applications在使用这些Service的时候首先要得到一个IServiceMgr的实例，这被实现成了一个另类地单例模式。IServiceMgr的接口定义如下:
图2 IServiceMgr接口
IServiceMgr提供两类接口:
1) 获取Service的接口，这样直接得到具体的Service,是因为内核的Service比较固定。没有必要用GetService(strServiceName)这种方法。
GetAsyncService 返回AsyncService的实例
GetDBService 返回DatabaseService的实例
GetTCPService 返回TCPServerService的实例
GetTimerService 返回定时器实例
2) 一个静态的单例方法Instance。它申明在接口层，但是需要在IServiceMgr的实现中去实现它。它返回IServiceMgr的实例。
由于IServiceMgr的实现只是简单地将IAttemptService，ITCPServerServer, IDatabaseService,ITimerService的实现组合在了一起，所以它的实现不会详细描述。
1 AsyncService详细设计
图3 AsyncService的详细设计
AsyncService主要是提供给其他３个Service使用的，它实现了IService接口和IAsyncService接口。因为与异步相关的功能基本上都被boost::asio实现，所以AsyncService主要只是管理boost::asio的实例 。IAsyncService只提供了一个方法:
GetIOService 返回一个可用的boost::asio::io_service的实例
AsyncService组合了boost::asio和ThreadPool，其中boost::asio::io_service的数目和机器的cpu总数相同，而ThreadPool中线程总数为２倍的cpu数。所有ThreadPool中的线程都将作为工作线程，它们的入口函数都是io_service::run。
2 TimerService详细设计
图4 TimerService的结构图
TimerService实现了IService和ITimerService接口。ITimerService提供如下接口:
1) SetTimer(timerId,milisecs,timerFunc,repeatTimes) 设置一个id为timerId的定时器，这个定时器会被激
发repeatTimes次，每两次被小激发的时间间隔为millsecs毫秒。每次被激发都会调用 timerFunc这个函数。
2) KillTimer(timerId) 取消id为timerId的定时器。
3) KillAllTimer() 取消所有的定时器，一般用在系统关闭时调用。
TimerService管理着一些TimerItem,Applications层用一个新的timerId,调用SetTimer时，TimerService就会创建一个新的TimerItem, 而在调用KillTimer时，就会销毁掉与其相关的那个TimerItem。TimerService的实现依赖与AsyncService,因为定时器本质上也是异步操作。将由AsyncService中的io_service来统一调度。
需要注意以下几点:
1) 传给SetTimer的timerFunc这个函数要是线程安全的，因为不确定会在哪个工作线程的context中调用它，同时 如果你的好几个定时器公用同一个timerFunc, 就可能对共享资源造成竞争。
2) SetTimer进如果发现已经存在相同id的TimerItem, 不会创建一个新的TimerItem,而是取消先前的定时器。修 改其参数后启动。
3 TCPServerService详细设计
图5 TCPServerService结构图
TCPServerService实现了IService接口和ITCPServerService接口。ITCPServerService的几个主要接口说明:
1) SendData 通过指定的ISocketItem发送数据, 数据在一般情况下由4个参数: MainCmd, SubCmd, Data, DataSize (可以参与总休设计中关于协议的部分的描述) 。有的时候Data为空，就不需要Data和DataSize这两个参数了。
2) SendDataBatch 给所有连接发送数据。这是批量发送的，所有连接池中对应的客户端都会收到。
3) CloseSocket 关闭指定的连接。
4) SetObserver 设置监听者。用以接收异步通知。
TCPServerService 管理着一个客户端来的连接池。这个连接池由SocketItem组成,每一个SocketItem都与一个整数标识对应，Applications使用这个标识来发送数据和接收数据。SocketItem主要提供下面几个接口:
1) GetIndex 获取与其对应的唯一标识
2) GetRound 由于每个SocketItem都是可以重用的，所以为了防止混乱，比如说一个SocketItem在前一时刻对应着client1, 但是现在对应着client2。client1曾经的一个请求现在才要返回，这时如果没有GetRound就会把client1的处理结果错误地返回给client2。从这里也可以看出，每个SocketItem的round是在连接建立的时候会增加。
3) IsConnected 是否处于连接状态。
4) SendData 发送数据。
5) GetClientAddress 得到客户端的IP地址
6) GetConnectTimer 获取连接时间。
7) Close 关闭连接。
也许你会问了，我怎么只看到发送数据的接口，而没有接收数据的接口呢？因为这是个异步架构，在有连接到来，或者数据到来的时候，你会收到通知的。前提条件是你调用SetObserver设置了监听者。TCPServerService的监听都需要实现ITCPServiceObserver接口, TCPServerService通过这个接口提供的方法来通知你连接和读取事件:
1) OnSocketAccept 在新连接到达时，会调用你这里面的内容。
2) OnSocketRead 在数据读取完成后，会调用你提供的这个方法做进一步处理。
3) OnSocketClose 告诉你连接将要关闭。
需要注意的是如果你这三个方法中有共享的数据，要加锁保护。因为工作线程可能会产生竞争状态。
和TimerService一样，TCPServerService的异步调度依赖于IAsyncService。
4 DatabaseService详细设计
图6 DatabaseService结构图
可以对比一下DatabaseService和TCPServerService的结构图，你会发现他们是那么地相似。对的，它们的设计思路如出一辙。DatabaseService实现了IService和IDatabaseService这两个接口。IDatabaseService主要只提供了3个接口:
1) Connect 连接到一个数据库
2) Query 进行查询。 这里有两点要注意：1) Query以后不会立马得到结果，因为这是异步的; 2) 存储过程的调用也得使用这个方法，你只要将query语句写成 'select stroage_procedure(param1,param2,...)' 就行了。
3) SetObserver 设置观察者。因为查询是异步的，所以你要设一个观察者来得到通知。
DatabaseService管理着一些数据库连接DBConnect, 每一个DBConnect也与一个整数标识相关联，可以通过GetIndex获得。同时你可以通过IsConnect来查询这个DBConnect是否处于连接状态。
在实现IDBServiceObserver时，你需要实现下面两个方法:
1) OnDBConnect 在数据库连接建立时会调用
2) OnQueryEnd 在这里你可以得到一个表示查询结果的QueryResult对象。你可以通过它知道查询的状态，以及结果信息。
