接口文档(范例).docVIP

接口详细设计文档 作者：唐为（为哥） 审核：赵锟 日期：2005-5-27 接口详细设计文档 1 1 编写目的 3 2 名词解释 3 3 组件分布图 4 4 程序结构 5 4.1 接入处理线程类图 5 4.2 接收线程类图 6 4.3 启动控制图 6 5 程序设计说明 7 5.1 对原系统的改动 7 5.2 ThreadInSvcProcessor 接入处理器 8 5.2.1 类图 8 5.2.2 时序图 9 5.2.3 流程图 9 5.2.4 ThreadInSvcProcessor类说明 11 5.3 PatternNewSyncAsyncInnerDir 同异步向内处理模式 16 5.3.1 类图 16 5.3.2 描述 17 5.3.3 流程图 17 5.3.4 类说明 19 5.4 ThreadReplySvcProcessor 异步应答返回处理器 24 5.4.1 类图 24 5.4.2 类说明 24 5.5 ClientInfo 客户端连接数据 33 5.5.1 类图 33 5.5.2 类描述 33 5.6 ClientInfoTable 客户端连接数据表 34 5.6.1 类图 34 5.6.2 类描述 34 5.7 ClientInfoTableMonitor 客户端连接数据表监控程序 38 5.7.1 类图 38 5.7.2 类说明 38 5.8 FrontMain 主控程序 40 5.8.1 类间关系 40 5.8.2 流程图 41 5.8.3 类说明 42 5.9 问题 44 编写目的 背景， 组件分布图 程序结构 接入处理线程类图 接收线程类图 启动控制图 程序设计说明 对原系统的改动 改变原有商家Trade类，不存放渠道对象在商家类中，商家类只执行商家处理，不负责渠道的管理 改动原有的系统中所有模式的处理，模式处理必须对渠道的释放负责 修改MidHstChannel，添加后台服务需要的２个FML字段,这两个字段是: FML域名 描述 S_INTERF_NO 接口标识号，整数。系统中接收异步响应程序的唯一编号。用于标识请求的来源，异步应答根据这个号码分发给具体的接口程序。 S_TX_CTRL_ATTR 交易控制属性，字符串。接口都填0，表示这是正常的交易请求。 ThreadInSvcProcessor 接入处理器 类图 时序图 预先说明： ChannelBase 渠道通信基类， ThreadInSvcProcessor类说明 功能 收取用不同渠道接入的外部商家的请求识别，解包执行处理的模式具体的流程在模式中控制,并不做控制 模式可能有3种： 无返回：发送后台，不接收应答对应模式PatternASyncInnerDir,需要修改原来的相关程序,在本文档中并不涉及 有返回,根据返回的应答判断是同步返回还是异步返回如果接收的应答表明是同步返回，按正常模式返回如果接收的应答表明是异步返回，按异步模式处理对应模式PatternNewSyncASyncInnerDirThreadInSvcProcessor后续的ProcessPattern 应该是PatternNewSyncASyncInnerDir.ThreadInSvcProcessor只负责接入后调用模式，并处理异常情况 安全异常情况的模式下，调用模式PatternErrorSyncInner来处理，必须限制： 主要的改动是渠道的释放由模式来管理涉及模式有 PatternASyncInnerDir , PatternNewSyncASyncInnerDir , PatternErrorSyncInner （可能不全面） 程序描述 ThreadInSvcProcessor ThreadInSvcProcessor Trade* ptrade , SvcChannelFactory* pfactory, bool*_bexit 功能: 构造函数 性能: 输人项pfactory 接入数据渠道工厂 bool* exit 退出标志 输出项: 注释: 程序描述SvcRun void SvcRun 功能: 主控流程 输人项 :服务商家在开始已经生成，生存周期里一直存在一个DataBus对象（数据总线），每线程一个DataBus对象。在生存周期里一直存在 DataBus对象初始化 循环处理 SINT32 ret a_process_loop Trade* ptrade , SvcChannelFactory* pfactory,DataBus* pDataBus ; if bool* exit true 释放渠道 跳出循环 为下一次使用清空DataBus对象 收尾处理,释放recv_trade 程序描述a_proce