內核的幾個組件被設計成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主要是提供給其他3個Service使用的,它實現了IService接口和IAsyncService接口。因為與異步相關的功能基本上都被boost::asio實現,所以AsyncService主要只是管理boost::asio的實例 。IAsyncService只提供了一個方法:
GetIOService 返回一個可用的boost::asio::io_service的實例
AsyncService組合了boost::asio和ThreadPool,其中boost::asio::io_service的數目和機器的cpu總數相同,而ThreadPool中線程總數為2倍的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對象。你可以通過它知道查詢的狀態,以及結果信息。