详细设计说明书.docx
*有限公司*XXXXVLO详细设计说明书XXXXXXX部2008年5月编制部门EPG批准日期2008/1/22文档修改记录版本修订人修订说明批准人发布日期1.0.1.0XXX初稿，X年X月X日提交同行评审。*200805071.0.1.1XXX根据同行评审的结论做了修订。*20080508本文档中所包含的信息属于商业机密信息，如无*有限公司的书面许可，任何人都无模版版本信息编辑部门：EPG批准日期：2008/1/22编制部门EPG批准日期2008/1/22目录1弓I言11.1 编写目的11.2 背景11.3 定义11.4 法律法规和参考资料12 系统详细设计22.1.1 个股行情接口模块22.1.2 股票排名接口模块42.1.3 资讯接口模块62.1.4 交易（中间层服务）模块92.1.5 行情（中间层服务）模块172.1.6 资讯（中间层服务）模块223 管理后台数据库设计283.1 基本思路283.2 数据结构描述28编制部门EPG批准日期2（三）81221引言1.1编写目的本详细设计说明是项目设计阶段的必要文件，明确了本项目的需求的实现方式。本设计把系统划分成若干个模块，决定了各个模块之间的接口、模块之间传递的信息，已经数据结构、模块接口的设计。在本阶段中，确定应该如何具体实现所以的功能，从而为编码阶段把这些描述直接翻译成具体的程序设计语言提供依据。本设计的预期读者：项目开发人员、项目评审者、项目测试和维护人员。1.2背景项目名称*XXXXVl.0项目简称XXXXV1.0英文缩写项目编号P2008XXXX版本号1.0任务提出者开发者用户同其他系统的关系1.3定义1.4法律法规和参考资料项目需要说明书项目可行性研究报告项目立项申请表金融产品销售系统一周边接口规范功能模块接口(XXXX)“XXX”XXX分析系统通讯协议设计说明书编制部门EPG批准日期2（三）81222系统详细设计2.1.1 个股行情接口模块2.1.1.1 功能描述根据股票（或期货）信息获得该股票（或期货）的行情数据。行情数据包括实时数据（包含个股五档），分时数据，K线数据等。2.1.1.2 相关需求需求功能0401,0403,0404,04052.1.1.3 输入项股票信息（Codeinfo）。2.1.1.4 输出项行情信息（AnSWerQUOteData）2.1.1.5 相关数据结构说明AnswerQuoteData (tom quote) d«HMd DateMMdCodehfo(cmquct>codeT>peshortcodeStngArsRearTime(tom rMftim)An8TrendDataAmDayOala(E窜四Equote>CodeInfo股票信息类AnswerQuoteData行情信息类AnsRealTime实时行情信息类AnsTrendData分时行情信息类编制部门EPG批准日期2（三）8122AnsDayDataK线行情信息类2.1.1.6 相关接口或者存储过程说明QuoteManager:/获得实时行情信息publicstaticAnswerQuoteDatagetRealTime(Codeinfocodeinfo)throwsQuoteException；/获得分时行情信息publicstaticAnswerQuoteDatagetTrendData(Codeinfocodeinfo)throwsQuoteException；/获得K线行情信息publicstaticQuoteDatagetTechData(Codeinfocodeinfo)throwsQuoteException；2.1.1.7 主要页面设计无2.1.1.8 关键算法说明2.1.1.9 关键流程说明a）QuoteManager通过ConnectionPool获得有效的通向行情服务器的链接QuoteConnection。b）根据请求的行情类型，将股票（或期货）信息（CodeInfo）打包成请求数据包AskDataC）将请求数据包拼成二进制数据流通过QuoteConnection发送给行情服务器d）取得行情服务器返回的行情数据，并解析打包成AnSWerQUOteDaia,返回。2.1.1.10 特殊情况说明股票（期货）实时行情信息将使用缓存存储从行情服务器主推过来的，Client需要实时行情信息时，直接从缓存里获取。编制部门EPG批准日期2（三）81222.3. 1.LIl关键错误处理说明 链接超时：取消当前服务，断开链接，重连。 请求应当超时：从请求发生到收到应当的时间超过设置值，则重新发送请求。 链接断开：定时访问服务器，防止因为长期未响应导致被服务器主动断开；如果已经被断开，则过一定间隙后尝试连接备用服务器。 上诉超时的参数从配置文件中读取。2.1.1.12尚未解决的问题2.1.2股票排名接口模块2.1.2.1 功能描述根据用户请求，排序列出相应的股票数据2.1.2.2 相关需求需求功能04022.1.2.3 输入项排名请求信息：市场类型、显示数目、升降序、排序类型等2.1.2.4 输出项AnswerQuoteData编制部门批准日期2.1.2.5 相关数据结构说明AnswerQuoteDatadataHeadOetaHMdAnsReportDataAnsGeneraISortReqAnyRePorl:排行请求类ReqGeneraISon:排行请求类AnSRePOrtData:排行返回类AnsGeneralSort:fit行返回类1.1.1.1 6相关接口或者存储过程说明QuoteManager:/获得排名报表publicstaticAnswerQuoteDatagetReportData(ReqAnyReportreq)throwsQuoteException；/获得综合排名publicstaticAnswerQuoteDatagetGeneralData(ReqGeneralSortreq)throwsQuoteException；1.1.1.2 7主要页面设计2.1.2.8 关键算法说明编制部门EPG批准日期2（三）81222.1.2.9 关键流程说明参考个股行情接口模块2.1.2.10 特殊情况说明普通排名和综合排名的区分：对下来排名使用ReqAnyRePort请求（普通排名）：上海A股涨幅排名上海B股涨幅排名深圳A股涨幅排名深圳B股涨幅排名上海债券涨幅排名深圳债券涨幅排名上海基金涨幅排名深圳基金涨幅排名对下来排名使用ReqGenareISort请求（综合排名）：上海A股综合排名上海B股综合排名深圳A股综合排名深圳B股综合排名上海债券综合排名深圳债券综合排名上海基金综合排名深圳基金综合排名2.1.2.11 关键错误处理说明参考个股行情接口模块2.1.2.12 尚未解决的问题2.1.3资讯接口模块2.1.3.1功能描述提供资讯信息访问的接口。2.1. 3.2相关需求功能需求 0501, 0502, 0503, 0504,05052.1. 3. 3输入项InfoListIdInfoId2.1. 3.4输出项资讯信息(AnSlnfOrmationData)2.1.3.5相关数据结构说明InfoListRequest编制部门EPG批准日期2(H)8122InfoContentRequestAInfbrmationRequestAnswerhfbrmationDatadataHeadDataHeadAnsInfoContentAnsInfoListInfoListRequest:资讯分类信息请求类InfoContentRequest:资讯内容信息请求类AnsInfoList:资讯分类信息类AnsInfoContent:资讯内容类2.1.3.6相关接口或者存储过程说明InformationManager:/获得资讯栏目信息或索引信息publicstaticAnswerInformationDatagetlnfoList(InfoListRequest编制部门EPG批准日期2（三）8122request)throwsQuoteException；/获得资讯内容publicstaticAnswerInformationeDatagetInfoContent(InfoContentRequestrequest)throwsQuoteException；1.1.1.1 3.7主要页面设计2.1.3.8 关键算法说明2.1.3.9 关键流程说明参考个股行情接口模块2.1.3.10 特殊情况说明资讯栏目信息的取得将采用AR,而其它资讯信息则采用Socket向服务器发送请求的方式。由于包括个股资讯在内的资讯信息都保存在行情服务器，且采用的是同一套协议机制，所以资讯的接口和行情类似。2.1.3.11关键错误处理说明参考个股行情接口模块2.1. 3.12尚未解决的问题编制部门批准日期2.1.4交易（中间层服务）模块2.1.4.1 功能描述交易模块用来实现证券、期货、基金的登录、委托买卖、查询、账单、转帐等所有交易相关的功能。IPO图：2.1.4.2 相关需求需求功能：证券：01010124开放式基金：0201-0212期货：0301-03092.1.4.3 输入项输入项：页面输入：function_idexchange_typestock_accountstock_codeentrust_amountentrust_priceentrust_propentrust_bs*编制部门EPG批准日期2008/1/22query_directionquery_modeStarJdateend_datesession输入：versionidentity-lypeop_entrust_wayop_branch_noop_stationbranch_nofund_accountpassword交易模块的输入分为从web端提交的输入和从session提取的输入。2.1.4.4 输出项Json结构的输。输出项：出错时的输出项目：error_noerror_info正常输出时：可选输出项（由业务功能决定）：1 .无表格的反馈。反馈形式：filedl=valuelfiledn=valuen如：查询客户状态（证券）（功能号：209）branch_no=xxxx
