接口详细设计文档

..接口详细设计文档作者：唐为（为哥）审核：赵锟日期：2005-5-27接口详细设计说明书第2页，共45页接口详细设计文档.............................................................11编写目的.................................................................42名词解释.................................................................43组件分布图...............................................................54程序结构.................................................................64.1接入处理线程类图.................................................64.2接收线程类图.....................................................74.3启动控制图.......................................................75程序设计说明.............................................................85.1对原系统的改动...................................................85.2ThreadInSvcProcessor接入处理器..................................95.2.1类图.........................................................95.2.2时序图......................................................105.2.3流程图......................................................105.2.4ThreadInSvcProcessor类说明.................................125.3PatternNewSyncAsyncInnerDir同异步向内处理模式.................175.3.1类图........................................................175.3.2描述........................................................185.3.3流程图......................................................185.3.4类说明......................................................205.4ThreadReplySvcProcessor异步应答返回处理器......................255.4.1类图........................................................255.4.2类说明......................................................255.5ClientInfo客户端连接数据.......................................345.5.1类图........................................................345.5.2类描述......................................................345.6ClientInfoTable客户端连接数据表................................355.6.1类图........................................................355.6.2类描述......................................................355.7ClientInfoTableMonitor客户端连接数据表监控程序.................395.7.1类图........................................................39接口详细设计说明书第3页，共45页5.7.2类说明......................................................395.8FrontMain主控程序..............................................415.8.1类间关系....................................................415.8.2流程图......................................................425.8.3类说明......................................................435.9问题............................................................45接口详细设计说明书第4页，共45页1编写目的预期读者：对接口行为和目的有一定了解的人背景说明软件系统名称：接口前端接入服务器描述接口接收不同商家的接入，接收数据转发给主机服务器，并同步/异步将返回数据发给接入商家的行为2名词解释ChannelBase渠道,通信基类，提供数据收发和释放的方法接口用子类实现来封装了不同通信方式目前有TCP短连接接入，从ACEMessage_Queue中读取（IPCMessageQueue-ACE_Message_Queue）Trade*trade商家对象，代表的其实是针对该商家处理方法的集合将接入数据的商家称为服务商家而将请求面向的商家称为主机商家，主机商家负责同步/异步返回交易的应答数据给接口平台而接口（数据交换）平台是在两者之间的交换平台渠道工厂：把接入数据的渠道工厂统一定为服务渠道工厂，发送数据的渠道工厂统一定为主机通道工厂服务商家接口平台主机商家接口详细设计说明书第5页，共45页3组件分布图ATM查不到,丢弃返回应答线程组ATM接入服务器ATM连接队列TCP渠道IPC消息队列渠道commserverIPC消息队列注各种服务渠道和主机通道抽象类都是相同的基类ChannelBase，只是作用不同渠道工厂生成各种渠道IPC消息队列commserver银联接入服务渠道抽象代表各种接入服务渠道接出服务渠道抽象TCP渠道IPC消息队列渠道发送请求线程组后台服务器连接监视器IPC消息队列通知清除超时间连接记录表接收线程接收IPC消息总控接入主机通道抽象IPC消息队列渠道接口详细设计说明书第6页，共45页4程序结构4.1接入处理线程类图PatternNewSyncAsyncInnerDir是ProcessPattern的一个子类，实现发送主机服务器并判断同/异步返回同步直接返回给接入商家异步只做相应记录ThreadInSvcProcessor是接入处理线程的主流程收数，接包无误后将处理控制权交给ProcessPatternProcessPattern是后续处理的全部流程抽象类子类实现对应不同流程接口详细设计说明书第7页，共45页4.2接收线程类图4.3启动控制图接口详细设计说明书第8页，共45页5程序设计说明5.1对原系统的改动改变原有商家Trade类，不存放渠道对象在商家类中，商家类只执行商家处理，不负责渠道的管理改动原有的系统中所有模式的处理，模式处理必须对渠道的释放负责修改MidHstChannel，添加后台服务需要的２个FML字段,这两个字段是:接口详细设计说明书第9页，共45页FML域名描述S_INTERF_NO接口标识号，整数。系统中接收异步响应程序的唯一编号。用于标识请求的来源，异步应答根据这个号码分发给具体的接口程序。S_TX_CTRL_ATTR交易控制属性，字符串。接口都填0，表示这是正常的交易请求。5.2ThreadInSvcProcessor接入处理器5.2.1类图接口详细设计说明书第10页，共45页5.2.2时序图预先说明：ChannelBase渠道通信基类，提供数据收发和释放的方法接口用子类实现来封装了不同通信方式。目前有TCP短连接接入。从ACEMessage_Queue中读取（IPCMessageQueue-ACE_Message_Queue）Trade*trade商家：代表的其实是针对该商家处理方法的集合5.2.3流程图接口详细设计说明书第11页，共45页服务商家商家渠道工厂GetChannel商家通过渠道收取数据商家的输入处理渠道没取到退出？超时？安全出错？请求:执行安全出错模式PatternErrorSyncInner处理模式请求/应答YesNo执行识别出的模式处理Yes同异步模式PatternNewSyncASyncInnerDirPatternASyncInnerDir应答丢弃接口详细设计说明书第12页，共45页5.2.4ThreadInSvcProcessor类说明5.2.4.1功能收取用不同渠道接入的外部商家的请求识别，解包执行处理的模式具体的流程在模式中控制,并不做控制模式可能有3种：1.无返回：发送后台，不接收应答对应模式PatternASyncInnerDir,需要修改原来的相关程序,在本文档中并不涉及2.有返回,根据返回的应答判断是同步返回还是异步返回如果接收的应答表明是同步返回，按正常模式返回如果接收的应答表明是异步返回，按异步模式处理对应模式PatternNewSyncASyncInnerDirThreadInSvcProcessor后续的ProcessPattern应该是PatternNewSyncASyncInnerDir.ThreadInSvcProcessor只负责接入后调用模式，并处理异常情况3.安全异常情况的模式下，调用模式PatternErrorSyncInner来处理，必须限制：主要的改动是渠道的释放由模式来管理涉及模式有PatternASyncInnerDir,PatternNewSyncASyncInnerDir,PatternErrorSyncInner（可能不全面）5.2.4.2程序描述ThreadInSvcProcessorThreadInSvcProcessor(Trade*ptrade,SvcChannelFactory*pfactory,bool*_bexit)功能:构造函数性能:输人项:Trade*trade接入数据处理的商家类SvcChannelFactory*pfactory接入数据渠道工厂bool*exit退出标志输出项:注释:接口详细设计说明书第13页，共45页5.2.4.3程序描述SvcRunvoidSvcRun()功能:主控流程输人项:无输出项:无流程:服务商家在开始已经生成，生存周期里一直存在一个DataBus对象（数据总线），每线程一个DataBus对象。在生存周期里一直存在DataBus对象初始化循环处理{SINT32ret=a_process_loop(Trade*ptrade,SvcChannelFactory*pfactory,DataBu