网吧广告系统概要

1、盛世华银网吧广告系统概要设计说明书2020-06-16版权所有，侵权必究第13页，共16页拟制审核审核批准秦成金日期日期日期日期2006-09-27SunRisingSoftwareCo.,Ltd.辰日理想软件有限公司Allrightsreserved版权所有侵权必究修订记录Date日期Revisionversion修订版本Description描述Author作者分发记录CopyNo.Holder'sName&Role持有者和角色IssueDate分发日期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系统说明62.1系统架构设计62.2开发环境62.3系统总体设计62.4系统模块划分及功能描述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通讯协议设定18盛世华银网吧广告系统概要设计说明书关键词：RemoteUI,Server,Agent摘要：本文主要描述了一个广告的发布平台，由远程管理端、服务端和代理端三部分组成。远程管理端主要完成广告数据的录入及通过网络对服务端进行控制。服务端用于对代理端的数据进行维护与更新。代理端用

4、于播放广告，播放的形式由桌面广告、IE广告、IE间隙广告、登陆广告及弹出广告等几部分组成。本文档面向的主要对象为开发人员、设计人员、测试人员，并作为指导开发的唯一来源。缩略语清单:RemoteUI:据的录入及Server的管理。Server:维护及管理Agent的广告数据。Agent:管理客户端的广告显示方式。DLL：TCPIP:DynamicLinkLibrary动态链接库。TransmissionControlProtocol传输控制协议。InternetProtocol网际协议。UDPUserDatagramProtocol用户数据报协议。HTTP:HyperTextTransferPr

5、otocol超文本传输协议。1简介1.1目的本文将要描述盛世华银网吧广告系统的组成结构，各组成部分内部的模块划分、模块结构、模块间的关系、模块间的数据流以及网络通讯协议定义，用于指导软件系统的设计和开发。1.2范围1.2.1软件名称系统名称为盛世华银网吧广告系统。1.2.2软件功能系统主要功能是通过远程管理端、网吧内服务器程序、客户代理端对客户机器进行控制，实现客户端的桌面广告的更改及更新，IE浏览器内容顶端的广告更改及更新，IE浏览器浏览间隙广告更改及更新，系统登陆时弹出广告的更改及更新，系统弹出广告的更改及更新。1.2.3软件应用系统适用于大型网吧，作为一种广告发布平台向网吧用户提供丰富的

6、广告信息。2系统说明2.1系统架构设计盛世华银网吧广告系统基于C/S结构开发，由远程管理端（RemoteUI）,服务端（Server）,代理端（Agent）组成。远程管理端与服务端间通过HTTP协议进行交流，服务端与代理端间适用TCP和UDP的方式进行通信，服务端与代理端都以系统服务的形式安装于网吧服务器与用户机器上。2.2开发环境具体开发环境客户端操作系统为Windows2000,WindowsXP,Windows2003；整个系统米用C+语言编写，使用VC6.0进行编译。2.3系统总体设计ServerRemoteUI主功能区添加艮、用户管理模块修改查看修改Server管理模块消息收发区HT

7、TP通信模块主功能区更新*消息处理模块检测通知更新管理功能模块TCP/UDP通TCP/UDP通信模块信模块2.4系统模块划分及功能描述241远程管理端（RemoteUI）模块划分用户界面模块：提供用户操作界面，包括服务端管理界面、用户管理界面、参数设置界面三部分。用户管理模块：用户信息管理模块，具有对用户信息读取、修改功能。Server管理模块：主要实现与服务端（server）联机后对其进行管理，包括对服务端的当前状态的浏览、广告数据的修改、系统模块更新等功能。消息处理模块：主要是分别对发送和接收的消息进行封装和解析。HTTP通信模块：实现通过HTTP协议进行网络通讯功能。2.4.2服务端（S

8、erver）模块划分管理功能模块：实现对服务端（Server）的广告数据及数据版本维护以及对其管理的代理端（Agent）进行实时控制，主要包括状态检测，数据更新，模块更新等。消息处理模块：实现了分别对发送和接收的消息进行封装和解析的功能。HTTP通信模块：实现通过HTTP协议进行网络通讯功能。TCP/UDP通信模块：实现通过TCP/UDP进行网络通讯功能。243代理端（Agent）模块划分管理功能模块：实现了对本地数据及数据版本的维护及更新的功能。显示功能模块：头现了IE插入广告、桌面广告、系统登陆丿告、弹出式丿告等多种丿告的显示功能。3功能模块说明3.1远程管理端模块详细描述3.1.1用户界

9、面模块用户登录界面：用户管理界面:导航栏当前连接：志诚网吧_当前位置：用户管理3主界面用户管理3-切换网吧广告设置品桌面广告IE内容广告BIE间隙广告巴登陆广告弹出广告IE默认主页系统选项广告参数3模块更新系统功能退出更改用户名确认重置盛世华银网吧广告系统欢迎XX登陆!2006-09-2813:39连接状态：连接正常远程管理端主界面:盛世华银网吧广告系统欢迎xx登陆！当前连接：志诚网吧-导航栏:白系统功能主界面欢迎使用用户管理切换网吧盛世华银网吧广告系统一广告设置vl.O:申桌面广告m-IE内容广告当前连接：志诚网吧：BIE间隙广告:吉登陆广告在线数量：120台£弹出广告；白IE默认

10、主页«系统选项广告参数El模块更新曰退出连接状态：连接正常2006-09-2813:39参数设置界面:IE广告设置界面:模块更新界面:3.1.2用户管理模块功能描述：主要负责用户信息的管理。主要流程如下：1）登陆界面显示前，读取用户配置信息，网吧配置信息2）检查用户的帐户和密码3）登陆成功后，连接网吧服务器（server）4）连接成功后，可以修改用户帐户及密码注：默认用户为user1,user2,user3密码都为123456。用户名及密码的加密方式为MD5。配置文件及相关项:配己置文件名为usercfg.xml,srvlst.xml,相关项为<userid=alic'

11、pwd=88887>,<servername=志诚网吧'address=/>主要类:TUserMng主要函数：读取指定用户信息登陆信息检查将字符进行MD5加密改变用户名改变用户密码ReadUser():Login():MD5Encode():ChangeUserlD():ChangeUserPWD()网吧广告系统概要设计说明书请输入密级3.1.3Server管理模块功能描述：主要实现与服务端（server）联机后对其进行管理，包括对服务端的当前状态的浏览、广告数据的修改、系统模块更新等功能。主要流程如下:1）与服务端连接成功后，下载服务端（Serve

12、r）的配置文件到本地目录2）下载各广告信息，同时获得服务端管理的代理端（Agent）状态信息3）更新某项广告数据：通知服务端（Server）某广告数据已经更新，等待服务端（Server）下载数据信息4）更新某个模块：通知服务端（Server）某模块数据已经更新，等待服务端（Server）下载数据信息注：下载方式为一端向另一端发送获取数据的HTTP请求，然后等待回应。配置文件及相关项:配置文件名为svrcfg.xml,广告数据相关项为<adid=1version=2006092813321123path=srcname=1.jpg/>,模块项为<mdlidversion=200

13、6092813321124path=srcname=sock.dll/>注：ad为广告标识，id为具体的广告项，version当前项的广告版本号,path广告的路径,id为具体的模块项，version当前项的模块版本号，path模块的路径，name模块文件名主要类：TSvrMng主要函数：Connect():连接服务端（Server）DownloadCfg()下载配置文件信息SendRequest():发送请求信息Updateltem():更新某一项广告数据UpdateModule()更改某一模块数据name广告文件名,mdl为模块标识,3.1.4消息处理模块功能描述：实现了分别对发送和

14、接收的消息进行封装和解析。主要流程如下:1）封装：当有消息发送时，消息由本模块进行封装成固定的消息格式,然后通过通信模块的发送函数将消息发送出去2）解析：当有消息到达时，本模块将消息进行解析，提取消息目的及内容，然后交给上层处主要类:2020-06-16TMsgProc主要函数：MakeMsg:建立消息ParseMsg:解析消息3.1.5 HTTP消息通讯模块功能描述：HTTP通信协议的实现。主要流程如下：1）建立连接：建立HTTP连接2）发送请求信息：发送HTTP请求信息3）发送响应消息：响应HTTP请求信息4）关闭连接：关闭HTTP连接主要类：TSocketTHTTP主要函数：Connec

15、t（）:建立连接Request。：发送HTTP请求信息Response（）:发送HTTP响应消息Close（）:关闭HTTP连接3.2服务端（Server）模块详细描述3.2.1管理功能模块功能描述：实现对服务端（Server）的广告数据及数据版本维护以及对其管理的代理端（Agent）进行实时控制，主要包括状态检测，数据更新，模块更新等。主要流程如下：1）收集代理端（Agent）的登陆消息，生成代理端（Agent）队列，发送更新时间戳2）收到远程管理端（RemoteUI）的更新消息，终止当前与代理端（Agent）的数据连接，下载广告数据存储到src文件夹，更新服务端（server）的配置文件3

16、）检测代理端（Agent）状态即更新代理端（Agent）队列内代理端（Agent）的当前状态，当前状态包括开关机状态，当前广告项是否需要更新4）每次向10个代理端（Agent）发送数据更新消息，等待10秒后，继续轮循，直每个代理端（Agent）的更新时间戳与服务器同步注：判断代理端的某广告项是否需要更新目的是防止已经更新完成的代理端再次被更新。判断是通过比较服务端每次更新后产生的时间戳。版权所有，侵权必究第13页，共16页配置文件及相关项：配置文件名为svrcfg.xml广告数据相关项为<adid=1version=2006092813321123path=srcname=1.jpg/&

17、gt;,模块项为<mdlid=1version=2006092813321124path=srcname=sock.dll/>，时间戳<updatetimetime=20060929143023>TSvrAppTAgentMng主要函数：CheckState():StopDataConnect()DownloadResource()ReadCfg():WriteCfg():UpdateCfg():Updateltem():UpdateModule()注:ad为广告标识，id为具体的广告项，version当前项的广告版本号path广告的路径name广告文件名；mdl为模块

18、标识，id为具体的模块项，version当前项的模块版本号path模块的路径name模块文件名发送广播消息，更新代理队列终止服务端上的数据传送连接下载广告数据信息读取配置文件写入配置文件更新服务端配置文件更新某一项广告数据更改某一模块数据3.2.2消息处理模块功能描述：实现了分别对发送和接收的消息进行封装和解析。主要流程如下：1）封装：当有消息发送时，消息由本模块进行封装成固定的消息格式，然后通过通信模块的发送函数将消息发送出去2）解析：当有消息到达时，本模块将消息进行解析，提取消息目的及内容，然后交给上层处理TMsgProc主要函数：MakeMsg:建立消息ParseMsg:解析消息3.2.

19、3HTTP消息通讯模块网吧广告系统概要设计说明书请输入密级功能描述：HTTP通信协议的实现。主要流程如下:1）建立连接：建立HTTP连接2）发送请求信息：发送HTTP请求信息3）发送响应消息：响应HTTP请求信息4）关闭连接：关闭HTTP连接THTTP主要函数:Connect():建立连接Request。：发送HIIP请求信息Response()：发送HTTP响应消息Close():关闭HTTP连接3.2.4TCP/UDP通信模块功能描述：TCP/UDP通信的实现。主要流程如下1)初始化socket2）建立连接3）监听端口4）发送信息5）接收消息6）关闭连接主要类：TSocket主要函数：Cr

20、eate。:初始化socketConnect():建立连接Send():发送消息Recv():接收消息Close():连接3.3代理端（Agent）模块详细描述3.3.1管理功能模块功能描述：实现了对本地数据及数据版本的维护及更新的功能。主要流程如下:1）启动，发送在线广播消息通知服务端（server）,开始本地更新2）本地更新：拷贝update文件夹下的广告或模块数据分别到src文件夹和程序主目录下3）收到服务端（Server）的更新消息，比较收到项的版本号与本地项的版本号，发送是否更新的回应消息4）等待下载开始命令，下载相应的广告数据到本地的update文件夹，更改配置文件注：本地更新首先

21、需要检查本地配置文件，若存在改动标志，则进行更新，否则不进行操作配置文件及相关项：配置文件名为agtcfg.xml广告数据相关项为<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发送登陆消息检查本地是否需要更新下载需要更新的数据信息下载某项的数据的版本信息主要函数：SendLogin():CheckUpdate():Downloadltem()DownloadVersion():3.3.2显示功能模块功能描述：实现了IE插入广告、桌面广告、系统登陆广告、弹出式广告等多种广告的显示功能。主要流程如下：1）IE内容广告：读取src文件夹下相应广告数据，显示到每个Web页面内容的顶端2）IE浏览间隙广告：读取src文件夹下相应广告数据，每当页面改变时，显示3秒间隙广告3

23、）桌面广告：读取src文件夹下相应广告数据，当有更新时，改变桌面的广告4）系统登陆广告：读取src文件夹下相应广告数据，每当系统登陆时弹出对话框播放广告5）弹出式广告：读取src文件夹下相应广告数据，每隔固定的时间弹出对话框播放广告配置文件及相关项：配置文件名为agtcfg.xml广告数据相关项为<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为某具体参数标识，value为此参数的值2020-06-16版权所有，侵权必究第23页，共16页4通讯协议设定通讯协议格式：消息头：消息号：命令号：参数消息头=IMSG_TITLE=0x1，消息号=当前时间（精确到秒），分隔符为''号，命令和参数内不能出现分号。

25、公用消息:命令类型报文类型参数报文说明IMSGNOOP0x1010无操作IMSGCLOSE0x1020连接关闭远程管理端（RemoteUI）消息:命令类型报文类型参数报文说明IMSGRGETITEM0x201项号获取服务端某项数据IMSGRUPDATEITEM10x202项号更新某一项数据IMSGRUPDATEAGENT0x2030开始更新代理端服务端（Server）消息:命令类型报文类型参数报文说明IMSGSGETITEM0x301项号获取某一项数据IMSGSUPDATETIMEE0x302时间戳更新时间戳IMSGSUPDATEITEM10x303项号更新某一项IMSGSDOWNLOAD卜IOW0x304项号下载开始IMSGSCHECKSTA'0x3050检杳代理端状态代理端（Agent）消息:命令类型报文类型参数报文说明IMSGALOGIN0x4010代理端登陆消息IMSGALOGOUT0x4020代理端登