*有限公司*XXXXV1.0详细设计说明书XXXXXXX部2008年 5 月*编制部门EPG批准日期2008/1/22 文档修改记录版本修订人修订说明批准人发布日期1.0.1.0XXX初稿，X年X月X日提交同行评审。*200805071.0.1.1XXX根据同行评审的结论做了修订。*20080508说 明本文档中所包含的信息属于商业机密信息，如无*有限公司的书面许可，任何人都无权复制或利用。模版版本信息编辑部门：EPG批准日期：2008/1/22目录1引言11.1编写目的11.2背景11.3定义11.4法律法规和参考资料12系统详细设计22.1.1个股行情接口模块22.1.2股票排名接口模块42.1.3资讯接口模块62.1.4交易（中间层服务）模块82.1.5行情（中间层服务）模块142.1.6资讯（中间层服务）模块183管理后台数据库设计223.1基本思路223.2数据结构描述22I1 引言1.1 编写目的本详细设计说明是项目设计阶段的必要文件，明确了本项目的需求的实现方式。本设计把系统划分成若干个模块，决定了各个模块之间的接口、模块之间传递的信息，已经数据结构、模块接口的设计。在本阶段中，确定应该如何具体实现所以的功能，从而为编码阶段把这些描述直接翻译成具体的程序设计语言提供依据。本设计的预期读者：项目开发人员、项目评审者、项目测试和维护人员。1.2 背景项目名称*XXXXV1.0项目简称XXXXV1.0英文缩写项目编号P2008XXXX版本号1.0任务提出者 开发者 用户 同其他系统的关系1.3 定义1.4 法律法规和参考资料项目需要说明书项目可行性研究报告项目立项申请表金融产品销售系统周边接口规范功能模块接口（XXXX）“XXX”XXX分析系统通讯协议设计说明书2 系统详细设计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 相关数据结构说明CodeInfo股票信息类AnswerQuoteData 行情信息类AnsRealTime 实时行情信息类AnsTrendData 分时行情信息类AnsDayData K线行情信息类2.1.1.6 相关接口或者存储过程说明QuoteManager：/ 获得实时行情信息public static AnswerQuoteData getRealTime(CodeInfo codeInfo) throws QuoteException ；/ 获得分时行情信息public static AnswerQuoteData getTrendData(CodeInfo codeInfo) throws QuoteException ；/ 获得K线行情信息public static QuoteData getTechData(CodeInfo codeInfo) throws QuoteException ；2.1.1.7 主要页面设计无2.1.1.8 关键算法说明2.1.1.9 关键流程说明a) QuoteManager通过Connection Pool获得有效的通向行情服务器的链接QuoteConnection。b) 根据请求的行情类型，将股票（或期货）信息（CodeInfo）打包成请求数据包AskDatac) 将请求数据包拼成二进制数据流通过QuoteConnection发送给行情服务器d) 取得行情服务器返回的行情数据，并解析打包成AnswerQuoteData，返回。2.1.1.10 特殊情况说明股票（期货）实时行情信息将使用缓存存储从行情服务器主推过来的，Client需要实时行情信息时，直接从缓存里获取。2.1.1.11 关键错误处理说明l 链接超时：取消当前服务，断开链接，重连。l 请求应当超时：从请求发生到收到应当的时间超过设置值，则重新发送请求。l 链接断开：定时访问服务器，防止因为长期未响应导致被服务器主动断开；如果已经被断开，则过一定间隙后尝试连接备用服务器。l 上诉超时的参数从配置文件中读取。2.1.1.12 尚未解决的问题2.1.2 股票排名接口模块2.1.2.1 功能描述根据用户请求，排序列出相应的股票数据2.1.2.2 相关需求需求功能04022.1.2.3 输入项排名请求信息：市场类型、显示数目、升降序、排序类型等2.1.2.4 输出项AnswerQuoteData2.1.2.5 相关数据结构说明ReqAnyReport:排行请求类ReqGeneralSort:排行请求类AnsReportData:排行返回类AnsGeneralSort:排行返回类2.1.2.6 相关接口或者存储过程说明QuoteManager：/ 获得排名报表public static AnswerQuoteData getReportData(ReqAnyReport req) throws QuoteException ；/ 获得综合排名public static AnswerQuoteData getGeneralData(ReqGeneralSort req) throws QuoteException ；2.1.2.7 主要页面设计2.1.2.8 关键算法说明2.1.2.9 关键流程说明参考个股行情接口模块2.1.2.10 特殊情况说明普通排名和综合排名的区分：对下来排名使用ReqAnyReport请求（普通排名）:上海A股涨幅排名上海B股涨幅排名深圳A股涨幅排名 深圳B股涨幅排名上海债券涨幅排名深圳债券涨幅排名上海基金涨幅排名深圳基金涨幅排名对下来排名使用ReqGenarelSort请求（综合排名）:上海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 输出项资讯信息(AnsInformationData)2.1.3.5 相关数据结构说明InfoListRequest：资讯分类信息请求类InfoContentRequest：资讯内容信息请求类AnsInfoList：资讯分类信息类AnsInfoContent：资讯内容类2.1.3.6 相关接口或者存储过程说明InformationManager：/ 获得资讯栏目信息或索引信息public static AnswerInformationData getInfoList(InfoListRequest request) throws QuoteException ；/ 获得资讯内容public static AnswerInformationeData getInfoContent(InfoContentRequest request) throws QuoteException ；2.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_bsquery_directionquery_modestart_dateend_datesession输入：versionidentity_typeop_entrust_wayop_branch_noop_stationbranch_no fund_accountpassword交易模块的输入分为从web端提交的输入和从session提取的输入。2.1.4.4 输出项Json结构的输。输出项：出错时的输出项目：error_noerror_info正常输出时：可选输出项（由业务功能决定）：1.无表格的反馈。反馈形式：filed1=value1 filedn=valuen 如：查询客户状态（证券）（功能号：209）branch_no=xxxxfund_account=xxxxonline_time=xxxxclient_name=xxxxmoney_count=xxxxmoney_type=xxxxenable_balance=xxxxexchange_type=xxxxstock_account=xxxx（具体可参考：金融产品销售系统_周边接口规范.xls文件）2.有表格的反馈（包含无表格反馈部分）反馈形式：table0=field1,field2,field3.fieldn|value11, value12, value