網(wǎng)吧廣告系統(tǒng)概要

1、盛世華銀網(wǎng)吧廣告系統(tǒng)概要設計說明書2020-06-16版權所有，侵權必究第13頁，共16頁擬制審核審核批準秦成金日期日期日期日期2006-09-27SunRisingSoftwareCo.,Ltd.辰日理想軟件有限公司Allrightsreserved版權所有侵權必究修訂記錄Date日期Revisionversion修訂版本Description描述Author作者分發(fā)記錄CopyNo.Holder'sName&Role持有者和角色IssueDate分發(fā)日期1<PDTR&DRepresentative>2<ProjectManager>3<

2、Teammembers4<CustomerRepresentative>5<Others>目錄摘要：41簡介51.1目的51.2范圍51.2.1軟件名稱51.2.2軟件功能51.2.3軟件應用52系統(tǒng)說明62.1系統(tǒng)架構設計62.2開發(fā)環(huán)境62.3系統(tǒng)總體設計62.4系統(tǒng)模塊劃分及功能描述62.4.1遠程管理端(RemoteUI)模塊劃分72.4.2服務端(Server)模塊劃分72.4.3代理端(Agent)模塊劃分73功能模塊說明83.1 遠程管理端模塊詳纟田描述83.1.1用戶界面模塊83.1.2用戶管理模塊113.1.3 Server管理模塊123.1.4消息處

3、理模塊123.1.5HTTP消息通訊模塊133.2 服務端(Server)模塊詳細描述133.2.1管理功能模塊133.2.2消息處理模塊143.2.3 HTTP消息通訊模塊143.2.4 TCP/UDP通信模塊153.3代理端(Agent)模塊詳細描述163.3.1管理功能模塊163.3.2顯示功能模塊164通訊協(xié)議設定18盛世華銀網(wǎng)吧廣告系統(tǒng)概要設計說明書關鍵詞：RemoteUI,Server,Agent摘要：本文主要描述了一個廣告的發(fā)布平臺，由遠程管理端、服務端和代理端三部分組成。遠程管理端主要完成廣告數(shù)據(jù)的錄入及通過網(wǎng)絡對服務端進行控制。服務端用于對代理端的數(shù)據(jù)進行維護與更新。代理端用

4、于播放廣告，播放的形式由桌面廣告、IE廣告、IE間隙廣告、登陸廣告及彈出廣告等幾部分組成。本文檔面向的主要對象為開發(fā)人員、設計人員、測試人員，并作為指導開發(fā)的唯一來源。縮略語清單:RemoteUI:據(jù)的錄入及Server的管理。Server:維護及管理Agent的廣告數(shù)據(jù)。Agent:管理客戶端的廣告顯示方式。DLL：TCPIP:DynamicLinkLibrary動態(tài)鏈接庫。TransmissionControlProtocol傳輸控制協(xié)議。InternetProtocol網(wǎng)際協(xié)議。UDPUserDatagramProtocol用戶數(shù)據(jù)報協(xié)議。HTTP:HyperTextTransferPr

5、otocol超文本傳輸協(xié)議。1簡介1.1目的本文將要描述盛世華銀網(wǎng)吧廣告系統(tǒng)的組成結構，各組成部分內(nèi)部的模塊劃分、模塊結構、模塊間的關系、模塊間的數(shù)據(jù)流以及網(wǎng)絡通訊協(xié)議定義，用于指導軟件系統(tǒng)的設計和開發(fā)。1.2范圍1.2.1軟件名稱系統(tǒng)名稱為盛世華銀網(wǎng)吧廣告系統(tǒng)。1.2.2軟件功能系統(tǒng)主要功能是通過遠程管理端、網(wǎng)吧內(nèi)服務器程序、客戶代理端對客戶機器進行控制，實現(xiàn)客戶端的桌面廣告的更改及更新，IE瀏覽器內(nèi)容頂端的廣告更改及更新，IE瀏覽器瀏覽間隙廣告更改及更新，系統(tǒng)登陸時彈出廣告的更改及更新，系統(tǒng)彈出廣告的更改及更新。1.2.3軟件應用系統(tǒng)適用于大型網(wǎng)吧，作為一種廣告發(fā)布平臺向網(wǎng)吧用戶提供豐富的

6、廣告信息。2系統(tǒng)說明2.1系統(tǒng)架構設計盛世華銀網(wǎng)吧廣告系統(tǒng)基于C/S結構開發(fā)，由遠程管理端（RemoteUI）,服務端（Server）,代理端（Agent）組成。遠程管理端與服務端間通過HTTP協(xié)議進行交流，服務端與代理端間適用TCP和UDP的方式進行通信，服務端與代理端都以系統(tǒng)服務的形式安裝于網(wǎng)吧服務器與用戶機器上。2.2開發(fā)環(huán)境具體開發(fā)環(huán)境客戶端操作系統(tǒng)為Windows2000,WindowsXP,Windows2003；整個系統(tǒng)米用C+語言編寫，使用VC6.0進行編譯。2.3系統(tǒng)總體設計ServerRemoteUI主功能區(qū)添加艮、用戶管理模塊修改查看修改Server管理模塊消息收發(fā)區(qū)HT

7、TP通信模塊主功能區(qū)更新*消息處理模塊檢測通知更新管理功能模塊TCP/UDP通TCP/UDP通信模塊信模塊2.4系統(tǒng)模塊劃分及功能描述241遠程管理端（RemoteUI）模塊劃分用戶界面模塊：提供用戶操作界面，包括服務端管理界面、用戶管理界面、參數(shù)設置界面三部分。用戶管理模塊：用戶信息管理模塊，具有對用戶信息讀取、修改功能。Server管理模塊：主要實現(xiàn)與服務端（server）聯(lián)機后對其進行管理，包括對服務端的當前狀態(tài)的瀏覽、廣告數(shù)據(jù)的修改、系統(tǒng)模塊更新等功能。消息處理模塊：主要是分別對發(fā)送和接收的消息進行封裝和解析。HTTP通信模塊：實現(xiàn)通過HTTP協(xié)議進行網(wǎng)絡通訊功能。2.4.2服務端（S

8、erver）模塊劃分管理功能模塊：實現(xiàn)對服務端（Server）的廣告數(shù)據(jù)及數(shù)據(jù)版本維護以及對其管理的代理端（Agent）進行實時控制，主要包括狀態(tài)檢測，數(shù)據(jù)更新，模塊更新等。消息處理模塊：實現(xiàn)了分別對發(fā)送和接收的消息進行封裝和解析的功能。HTTP通信模塊：實現(xiàn)通過HTTP協(xié)議進行網(wǎng)絡通訊功能。TCP/UDP通信模塊：實現(xiàn)通過TCP/UDP進行網(wǎng)絡通訊功能。243代理端（Agent）模塊劃分管理功能模塊：實現(xiàn)了對本地數(shù)據(jù)及數(shù)據(jù)版本的維護及更新的功能。顯示功能模塊：頭現(xiàn)了IE插入廣告、桌面廣告、系統(tǒng)登陸丿告、彈出式丿告等多種丿告的顯示功能。3功能模塊說明3.1遠程管理端模塊詳細描述3.1.1用戶界

9、面模塊用戶登錄界面：用戶管理界面:導航欄當前連接：志誠網(wǎng)吧_當前位置：用戶管理3主界面用戶管理3-切換網(wǎng)吧廣告設置品桌面廣告IE內(nèi)容廣告BIE間隙廣告巴登陸廣告彈出廣告IE默認主頁系統(tǒng)選項廣告參數(shù)3模塊更新系統(tǒng)功能退出更改用戶名確認重置盛世華銀網(wǎng)吧廣告系統(tǒng)歡迎XX登陸!2006-09-2813:39連接狀態(tài)：連接正常遠程管理端主界面:盛世華銀網(wǎng)吧廣告系統(tǒng)歡迎xx登陸！當前連接：志誠網(wǎng)吧-導航欄:白系統(tǒng)功能主界面歡迎使用用戶管理切換網(wǎng)吧盛世華銀網(wǎng)吧廣告系統(tǒng)一廣告設置vl.O:申桌面廣告m-IE內(nèi)容廣告當前連接：志誠網(wǎng)吧：BIE間隙廣告:吉登陸廣告在線數(shù)量：120臺£彈出廣告；白IE默認

10、主頁«系統(tǒng)選項廣告參數(shù)El模塊更新曰退出連接狀態(tài)：連接正常2006-09-2813:39參數(shù)設置界面:IE廣告設置界面:模塊更新界面:3.1.2用戶管理模塊功能描述：主要負責用戶信息的管理。主要流程如下：1）登陸界面顯示前，讀取用戶配置信息，網(wǎng)吧配置信息2）檢查用戶的帳戶和密碼3）登陸成功后，連接網(wǎng)吧服務器（server）4）連接成功后，可以修改用戶帳戶及密碼注：默認用戶為user1,user2,user3密碼都為123456。用戶名及密碼的加密方式為MD5。配置文件及相關項:配己置文件名為usercfg.xml,srvlst.xml,相關項為<userid=alic'

11、pwd=88887>,<servername=志誠網(wǎng)吧'address=/>主要類:TUserMng主要函數(shù)：讀取指定用戶信息登陸信息檢查將字符進行MD5加密改變用戶名改變用戶密碼ReadUser():Login():MD5Encode():ChangeUserlD():ChangeUserPWD()網(wǎng)吧廣告系統(tǒng)概要設計說明書請輸入密級3.1.3Server管理模塊功能描述：主要實現(xiàn)與服務端（server）聯(lián)機后對其進行管理，包括對服務端的當前狀態(tài)的瀏覽、廣告數(shù)據(jù)的修改、系統(tǒng)模塊更新等功能。主要流程如下:1）與服務端連接成功后，下載服務端（Serve

12、r）的配置文件到本地目錄2）下載各廣告信息，同時獲得服務端管理的代理端（Agent）狀態(tài)信息3）更新某項廣告數(shù)據(jù)：通知服務端（Server）某廣告數(shù)據(jù)已經(jīng)更新，等待服務端（Server）下載數(shù)據(jù)信息4）更新某個模塊：通知服務端（Server）某模塊數(shù)據(jù)已經(jīng)更新，等待服務端（Server）下載數(shù)據(jù)信息注：下載方式為一端向另一端發(fā)送獲取數(shù)據(jù)的HTTP請求，然后等待回應。配置文件及相關項:配置文件名為svrcfg.xml,廣告數(shù)據(jù)相關項為<adid=1version=2006092813321123path=srcname=1.jpg/>,模塊項為<mdlidversion=200

13、6092813321124path=srcname=sock.dll/>注：ad為廣告標識，id為具體的廣告項，version當前項的廣告版本號,path廣告的路徑,id為具體的模塊項，version當前項的模塊版本號，path模塊的路徑，name模塊文件名主要類：TSvrMng主要函數(shù)：Connect():連接服務端（Server）DownloadCfg()下載配置文件信息SendRequest():發(fā)送請求信息Updateltem():更新某一項廣告數(shù)據(jù)UpdateModule()更改某一模塊數(shù)據(jù)name廣告文件名,mdl為模塊標識,3.1.4消息處理模塊功能描述：實現(xiàn)了分別對發(fā)送和

14、接收的消息進行封裝和解析。主要流程如下:1）封裝：當有消息發(fā)送時，消息由本模塊進行封裝成固定的消息格式,然后通過通信模塊的發(fā)送函數(shù)將消息發(fā)送出去2）解析：當有消息到達時，本模塊將消息進行解析，提取消息目的及內(nèi)容，然后交給上層處主要類:2020-06-16TMsgProc主要函數(shù)：MakeMsg:建立消息ParseMsg:解析消息3.1.5 HTTP消息通訊模塊功能描述：HTTP通信協(xié)議的實現(xiàn)。主要流程如下：1）建立連接：建立HTTP連接2）發(fā)送請求信息：發(fā)送HTTP請求信息3）發(fā)送響應消息：響應HTTP請求信息4）關閉連接：關閉HTTP連接主要類：TSocketTHTTP主要函數(shù)：Connec

15、t（）:建立連接Request。：發(fā)送HTTP請求信息Response（）:發(fā)送HTTP響應消息Close（）:關閉HTTP連接3.2服務端（Server）模塊詳細描述3.2.1管理功能模塊功能描述：實現(xiàn)對服務端（Server）的廣告數(shù)據(jù)及數(shù)據(jù)版本維護以及對其管理的代理端（Agent）進行實時控制，主要包括狀態(tài)檢測，數(shù)據(jù)更新，模塊更新等。主要流程如下：1）收集代理端（Agent）的登陸消息，生成代理端（Agent）隊列，發(fā)送更新時間戳2）收到遠程管理端（RemoteUI）的更新消息，終止當前與代理端（Agent）的數(shù)據(jù)連接，下載廣告數(shù)據(jù)存儲到src文件夾，更新服務端（server）的配置文件3

16、）檢測代理端（Agent）狀態(tài)即更新代理端（Agent）隊列內(nèi)代理端（Agent）的當前狀態(tài)，當前狀態(tài)包括開關機狀態(tài)，當前廣告項是否需要更新4）每次向10個代理端（Agent）發(fā)送數(shù)據(jù)更新消息，等待10秒后，繼續(xù)輪循，直每個代理端（Agent）的更新時間戳與服務器同步注：判斷代理端的某廣告項是否需要更新目的是防止已經(jīng)更新完成的代理端再次被更新。判斷是通過比較服務端每次更新后產(chǎn)生的時間戳。版權所有，侵權必究第13頁，共16頁配置文件及相關項：配置文件名為svrcfg.xml廣告數(shù)據(jù)相關項為<adid=1version=2006092813321123path=srcname=1.jpg/&

17、gt;,模塊項為<mdlid=1version=2006092813321124path=srcname=sock.dll/>，時間戳<updatetimetime=20060929143023>TSvrAppTAgentMng主要函數(shù)：CheckState():StopDataConnect()DownloadResource()ReadCfg():WriteCfg():UpdateCfg():Updateltem():UpdateModule()注:ad為廣告標識，id為具體的廣告項，version當前項的廣告版本號path廣告的路徑name廣告文件名；mdl為模塊

18、標識，id為具體的模塊項，version當前項的模塊版本號path模塊的路徑name模塊文件名發(fā)送廣播消息，更新代理隊列終止服務端上的數(shù)據(jù)傳送連接下載廣告數(shù)據(jù)信息讀取配置文件寫入配置文件更新服務端配置文件更新某一項廣告數(shù)據(jù)更改某一模塊數(shù)據(jù)3.2.2消息處理模塊功能描述：實現(xiàn)了分別對發(fā)送和接收的消息進行封裝和解析。主要流程如下：1）封裝：當有消息發(fā)送時，消息由本模塊進行封裝成固定的消息格式，然后通過通信模塊的發(fā)送函數(shù)將消息發(fā)送出去2）解析：當有消息到達時，本模塊將消息進行解析，提取消息目的及內(nèi)容，然后交給上層處理TMsgProc主要函數(shù)：MakeMsg:建立消息ParseMsg:解析消息3.2.

19、3HTTP消息通訊模塊網(wǎng)吧廣告系統(tǒng)概要設計說明書請輸入密級功能描述：HTTP通信協(xié)議的實現(xiàn)。主要流程如下:1）建立連接：建立HTTP連接2）發(fā)送請求信息：發(fā)送HTTP請求信息3）發(fā)送響應消息：響應HTTP請求信息4）關閉連接：關閉HTTP連接THTTP主要函數(shù):Connect():建立連接Request。：發(fā)送HIIP請求信息Response()：發(fā)送HTTP響應消息Close():關閉HTTP連接3.2.4TCP/UDP通信模塊功能描述：TCP/UDP通信的實現(xiàn)。主要流程如下1)初始化socket2）建立連接3）監(jiān)聽端口4）發(fā)送信息5）接收消息6）關閉連接主要類：TSocket主要函數(shù)：Cr

20、eate。:初始化socketConnect():建立連接Send():發(fā)送消息Recv():接收消息Close():連接3.3代理端（Agent）模塊詳細描述3.3.1管理功能模塊功能描述：實現(xiàn)了對本地數(shù)據(jù)及數(shù)據(jù)版本的維護及更新的功能。主要流程如下:1）啟動，發(fā)送在線廣播消息通知服務端（server）,開始本地更新2）本地更新：拷貝update文件夾下的廣告或模塊數(shù)據(jù)分別到src文件夾和程序主目錄下3）收到服務端（Server）的更新消息，比較收到項的版本號與本地項的版本號，發(fā)送是否更新的回應消息4）等待下載開始命令，下載相應的廣告數(shù)據(jù)到本地的update文件夾，更改配置文件注：本地更新首先

21、需要檢查本地配置文件，若存在改動標志，則進行更新，否則不進行操作配置文件及相關項：配置文件名為agtcfg.xml廣告數(shù)據(jù)相關項為<adid=1version=2006092813321123path=srcname=1.jpgupdate=1/>,模塊項為<mdlid=1version=2006092813321124path=srcname=sock.dllupdate=1/>注:ad為廣告標識，id為具體的廣告項，version當前項的廣告版本號path廣告的路徑name廣告文件名；mdl為模塊標識，id為具體的模塊項，version當前項的模塊版本號path模塊

22、的路徑name模塊文件名,update為是否更新標識，1需要更新，0不更新TSocketTAgentApp發(fā)送登陸消息檢查本地是否需要更新下載需要更新的數(shù)據(jù)信息下載某項的數(shù)據(jù)的版本信息主要函數(shù)：SendLogin():CheckUpdate():Downloadltem()DownloadVersion():3.3.2顯示功能模塊功能描述：實現(xiàn)了IE插入廣告、桌面廣告、系統(tǒng)登陸廣告、彈出式廣告等多種廣告的顯示功能。主要流程如下：1）IE內(nèi)容廣告：讀取src文件夾下相應廣告數(shù)據(jù)，顯示到每個Web頁面內(nèi)容的頂端2）IE瀏覽間隙廣告：讀取src文件夾下相應廣告數(shù)據(jù)，每當頁面改變時，顯示3秒間隙廣告3

23、）桌面廣告：讀取src文件夾下相應廣告數(shù)據(jù)，當有更新時，改變桌面的廣告4）系統(tǒng)登陸廣告：讀取src文件夾下相應廣告數(shù)據(jù)，每當系統(tǒng)登陸時彈出對話框播放廣告5）彈出式廣告：讀取src文件夾下相應廣告數(shù)據(jù)，每隔固定的時間彈出對話框播放廣告配置文件及相關項：配置文件名為agtcfg.xml廣告數(shù)據(jù)相關項為<adid=1version=2006092813321123path=srcname=1.jpgupdate=1/>,模塊項為<mdlid=1version=2006092813321124path=srcname=sock.dllupdate=1/>，可更改選項<op

24、tid=3value=3>注:ad為廣告標識，id為具體的廣告項，version當前項的廣告版本號path廣告的路徑name廣告文件名；mdl為模塊標識，id為具體的模塊項，version當前項的模塊版本號path模塊的路徑name模塊文件名，update為是否更新標識，1需要更新，0不更新；opt為選項標識，id為某具體參數(shù)標識，value為此參數(shù)的值2020-06-16版權所有，侵權必究第23頁，共16頁4通訊協(xié)議設定通訊協(xié)議格式：消息頭：消息號：命令號：參數(shù)消息頭=IMSG_TITLE=0x1，消息號=當前時間（精確到秒），分隔符為''號，命令和參數(shù)內(nèi)不能出現(xiàn)分號。

25、公用消息:命令類型報文類型參數(shù)報文說明IMSGNOOP0x1010無操作IMSGCLOSE0x1020連接關閉遠程管理端（RemoteUI）消息:命令類型報文類型參數(shù)報文說明IMSGRGETITEM0x201項號獲取服務端某項數(shù)據(jù)IMSGRUPDATEITEM10x202項號更新某一項數(shù)據(jù)IMSGRUPDATEAGENT0x2030開始更新代理端服務端（Server）消息:命令類型報文類型參數(shù)報文說明IMSGSGETITEM0x301項號獲取某一項數(shù)據(jù)IMSGSUPDATETIMEE0x302時間戳更新時間戳IMSGSUPDATEITEM10x303項號更新某一項IMSGSDOWNLOAD卜IOW0x304項號下載開始IMSGSCHECKSTA'0x3050檢杳代理端狀態(tài)代理端（Agent）消息:命令類型報文類型參數(shù)報文說明IMSGALOGIN0x4010代理端登陸消息IMSGALOGOUT0x4020代理端登