搜索
1文档名称：TCC数据发布系统版本号：文档编号：文档目的：项目名称：数据发布系统执笔人：苏莉斌完成时间：完成部门：TIS相关参考文档：完成阶段：[√]草稿[]初稿[]讨论稿[]终稿文档类别：[√]部门内部交流[]部门之间交流[]对外发布等级：[]商业机密[]非商业机密审核人：其它注释：TCC数据发布系统2文档修改记录序号日期版本修改内容说明修改原因作者12007-1-50.0.1新建新建苏莉斌22007-1-150.0.2日志增强，多城市问题，发布系统模块增加,timestamp问题修改苏莉斌31引言1.1编写目的该文档编写的主要目的是描述TCC数据发布系统的详细设计需求，为开发人员开发提供依据。1.2适用范围主要提供给设计，开发和维护人员。1.3定义无。1.4参考资料TcclinkSpeed.wsdl，编码规范42总体设计2.1需求概述本系统的目的是对外提供实时交通数据。它是TCC实时交通状态采集之外的一个系统。它与实时交通状态采集系统之间有明确的界限。它利用实时交通状态采集系统产生的结果数据作为本系统的输入，经过一定的处理和封装，返回给请求数据的用户。具体关系如下图:图2-12.2软件功能列表功能名功能描述登入模块用户进入系统提取实时交通数据时必须要先登入系统登出模块用户提取数据完成后必需要登出系统取数模块在登入的前提下，根据用户的权限提取实时交通数据状态编码查询模块查询系统返回的指定的状态码的含义用户验证模块用于验证用户的访问权限，访问次数等日志模块记录系统中产生的日志告警模块向相关人员报告系统的错误2.3用户特点本软件的对外接口是其他企业的webservice客户端程序。系统会提供7*24实时交通状态采集系统实时交通数据发布系统5小时服务，用户的程序会每隔一定的周期（1分钟，2分钟等等）来取一次数据。同时本软件应该在内部提供相应的web界面来查询相关信息。2.4一般约束a．硬件的限制；由于受硬件条件的限制，本系统暂不提供集群功能。但是本软件应该在集群和非集群环境下应该有相同的表现。b．与其他应用间的接口；本系统将从TCC实时交通采集系统取得实时的数据。TCC实时交通采集系统计算得到的实时数据存放在集群数据库中。c．并行操作；本系统需要支持多用户并发操作。软件不应该受并发性及用户数的限制。d．审查功能；所有操作应该都有日志记录。e．控制功能；会针对不同的用户有不同的webservice访问权限。f．所需的高级语言；Java。JDK版本为Jdk1.5.0_05,应该服务器为Tomcat5.5.9。g．通信协议；网络通讯协议:TCP/IPSOAP协议版本:SOAP1.1Webservice访问协议:HTTPS,HTTP。(需要针对不同的用户设定其可以使用的访问协议)h．跨平台性本软件应该同时支持在windows,linux平台下运行。i．安全和保密方面的考虑。6客户使用webservice提供的功能前需要使用用户名和密码登入。用户在指定的时间内只能执行一定次数的取数据操作。目前暂定1分种两次。为了保证安全性，传输的数据需要加密。72.5软件结构2.5.1系统的硬件结构框图企业用户webservice客户端程序企业用户webservice客户端程序SiSi集群数据库网络客户端数据库实时交通状态采集系统实时交通状态发布系统2.5.2技术选型企业用户webservice客户端程序企业用户webservice客户端程序SiSi集群数据库网络客户端数据库实时交通状态采集系统实时交通状态发布系统(webservice发布)Https/SoapTCP/IPApache+tomcat+axis2+javaOracle10gRactomcat+java82.5.3系统的软件模块框图Tcclink_idspeedidTcclink_idSpeedStart_timeEnd_timeversionAuth_IDcustomer_nameLogin_timegetData_timestokenstatuscustomer_namecustomer_passwordmobileemailBegin_timeEnd_timeAllow_modulesAuth_methodflagCompnode_idModule_idTypeLevelsMessageIdDate_timeuser_name登入模块用户验证模块日志模块告警模块提取数据模块登出模块状态码查询模块group_idgroup_nameidGroup_idModule_idModule_idModule_nameModule_descCode_idStatusdescCOMMON.COMMON_USER_GROUPPUBLISH.PUBLISH_CUSTOMERPUBLISH.PUBLISH_AUTHUser_nameUser_passwordGroup_idmanagermobileemailOrder_notifyflagCOMMON.COMMON_USERCOMMON.COMMON_NOTIFY_ORDERCOMMON.COMMON_MODULETCC_V12.TBL_TCC_LOGTCC_V12.TBL_TCCLINK_SPEEDTCC_V12.TBL_TCCLINK_SPEED_HISCOMMON.COMMON_STATUSDESCNotify_IdNotify_methodNotify_descCOMMON.COMMON_NOTIFYIdCompnode_idModule_idTypeLevelsMessageDate_timeuser_nameStatusHandlerClose_timeSolution_idCOMMON.COMMON_ERROR_HANDLESolution_Idcategory_IDError_descsolutionCOMMON.COMMON_ERROR_SOLUTIONcategory_idCategory_NameCategory_descCOMMON.COMMON_ERROR_CATEGORYCity_idCity_nameTCC_V12.TBL_CITY92.5.4系统的总体流程图webservic客户端登入模块登入成功登入请求登入失败登入成功,返回加密认证码提取数据查询状态认证成功后可以调用系统内提供的相关功能身份验证模块验证成功提取数据模块验证成功返回结果登出请求状态查询模块验证成功不成功验证成功不成功登出模块日志模块告警模块维护人员102.5.6模块划分说明系统ID系统内模块ID备注101100100实时交通状态发布系统登入模块101100200实时交通状态发布系统登出模块101100300实时交通状态发布系统身份验证模块101100400实时交通状态发布系统状态查询模块101100500实时交通状态发布系统数据提取模块-城市-速度-全部101100600实时交通状态发布系统数据提取模块-城市-速度-有更新101100700实时交通状态发布系统数据提取模块-城市-速度分类-全部101100800实时交通状态发布系统数据提取模块-城市-速度分类-全部101100900实时交通状态发布系统数据提取模块-Link-速度101101100实时交通状态发布系统数据提取模块-Link-速度-有更新101101200实时交通状态发布系统数据提取模块-Link-速度分类101101300实时交通状态发布系统数据提取模块-Link-速度分类-有更新113详细设计3.1功能需求3.1.1登入模块a.引言webserive客户端程序使用webservice提供的功能前需要使用用户名和密码登入。用户登入的相关信息（用户名，登入时间，用户状态等）需要记录在用户的验证信息里。验证信息需要保存在数据库中。因为本系统对外提供了两台相同功能的服务器，，但是没有使用集群模式，因此如果客户认证的相关信息保存在内存中的话，当客户的请求转到另外一台服务器时，相关信息就会丢失。b.输入1)客户请求的数据格式要求客户程序需要通过soap协议发送基于xml的请求。2)客户请求的具体数据格式elementname=LogincomplexTypesequenceelementname=usernametype=xsd:string/elementname=passwordtype=xsd:string//sequence/complexType/element3)更信息内容请参见TcclinkSpeed.wsdl。c.加工12客户程序登入请求检查用户是否允许登入登入失败,返回相应状态码customer_namecustomer_passwordcustomer_mobilecustomer_emailBegin_timeEnd_timeAllow_modulesAuth_methodflagTBL_CUSTOMER把客户程序的登陆信息和认证码记录数据库中,便于以后对客户的取数次数进行限制Auth_IDUser_nameLogin_timegetData_timestokenstatusTBL_AUTH登陆成功返回认证码产生MD5加密的认证码定义输入数据、中间参数，以获得预期输出结果的全部操作。它包括如下的说明：1)登入用户信息的有效性检查检查包含如下内容：用户名，密码，用户有效期,用户的访问协议2)认证码在用户身份验证完成后，需要给用户产生认证码，此认证码要求每次随机产生并加密，此码在认证有效期内唯一存在，保存在数据库中。3)用户session信息保存13为了避免用户的页面请求攻击，我们需要把用户登入时的信息保存到数据库中，以控制一定时间间隔内用户取数据的次数。4)响应返回用户响应时，如果认证成功，返回成功的状态码，详见编码规范，并返回认证码。如果认证失败仅返回状态码。d.输出1)客户请求响应的数据格式要求webservice通过soap协议发送基于xml的响应。2)具体响应格式elementname=LoginResponsecomplexTypesequenceelementname=confirmationtype=int/elementname=tokentype=string//sequence/complexType/element1)更信息内容请参见TcclinkSpeed.wsdl。2)具体返回的状态码见编码规范。143.1.2日志系统a.日志系统的总体要求对于数据发布系统要求必须有详细的日志。日志应该至少提供如下内容:1.用户的登入时间2.用户在登入期间所执行的所有操作3.用户在数据提取模块提取的记录条数4.用户在数据提取模块提取的数据量(byte)5.用户提取数据所花费的时间b.日志系统的相关表1.tbl_tcc_logTCC_V12.TBL_TCC_LOGCompnode_idModule_idTypeLevelsMessageIdDate_timeuser_name其中user_name:主要记录操作此项事件的用户名像用户提取数据所花的时间这部分信息先写入message部分。2.tbl_error_handleIdCompnode_idModule_idTypeLevelsMessageDate_timeOperator_namevalueStatusHandlerClose_timeSolution_id3.tbl_auth15Auth_IDcustomer_nameLogin_timegetData_timestokenstatusc.具体实现发布系统要求的日志信息要求放到tcc_v12.tbl_tcc_log中。3.1.3数据提取模块a.数据模块的总体要求因为不同的用户对数据格式有不同的要求，针对不同的用户我们只向其提供值定格式的数据。因此我们的系统必须要针对不同的用户限制其可以访问的数据提取模块，从而来限制其可以得到的数据格式。b.提取模块设计考虑1．特定的用户只能访问指定的一个