核算平台通讯开发说明重点.doc

核算平台通讯开发说明 修订历史 制定日期 制定/修订 内容摘要 页数 版本 拟稿 审查 批准 2015.01.04 初稿 王瑞 目录 目录 3 1. 概述 4 2. 核算平台作为服务端 5 2.1 说明 5 2.2 实时通讯 5 2.3 字段映射 10 3. 核算平台作为客户端 12 3.1 说明 12 3.2 实时通讯 12 3.2.1 创建通讯服务 12 3.2.2 配置请求/响应报文 17 3.2.3 设置参数及字段值 19 3.3 批量通讯 21 1. 概述 核算平台对外通讯主要分两种场景，分别是核算平台作为服务端及核算平台作为客户端，下面分别进行说明。  2. 核算平台作为服务端 2.1 说明 核算平台作为服务端，对其他平台系统提供服务，即其他平台发请求到核算，核算平台收到请求之后做相应的业务逻辑处理，之后将处理结果返回给请求方。 核算平台作为服务端，通讯主要采用实时方式，下面进行详细说明。 2.2 实时通讯 常用的通讯方式有TCPIP通讯（即Socket通讯）、HTTP通讯、WebService通讯等，这里以TCPIP通讯方式为例进行说明。 首先，在EMP Explorer视图下，选中“渠道逻辑”，右键点击“新建渠道接入定义”，会弹出对话框，如下图所示。 选中“TCPIP渠道接入”，在名称栏中输入接入渠道的名称，如“QSTcpipChannel”，此处不支持中文，最后点击“Finish”按钮。此操作会在web.xml文件添加一个servlet和servlet-mapping，如下所示。 servlet中load-on-startup的值需要大于1。 接下来进行参数设置，如下图所示，默认的超时设置是600000ms，即10分钟，可根据实际情况进行设置，一般采取默认。 通讯设定处，连接方式可选“短连接”和“长连接”，短连接表示一次通讯完成之后关闭连接，长连接表示通讯完成之后连接也不关闭；双工模式可选“false”和“true”，一般情况下默认选“false”，false表示单工。 监听端口设置：如下图所示，端口根据实际需求填入端口数字，持久连接可选true或false，一般默认选false，最大连接限制、使用线程缓冲和缓冲线程数可根据实际需求填写。 解包处理设置：此处实现类是“m.CommProcessor4Xingye”，此类实现“com.ecc.emp.tcpip.CommProcessor”接口，主要包括两个接口方法readPackage和wrapMessagePackage，前者主要用于接到报文后对报文信息进行初步的解包处理，如读取报文长度，将后面的报文读取出来，可添加一些特殊的预处理，如MAC校验等，后者是在响应报文完成拼包之后，再对响应报文做些特殊处理，如加上报文头长度，MAC校验等。各个实施项目需求不一，此类一般各项目需要根据实际需求定制。 接入逻辑设置：此处实现类是com.ecc.emp.access.tcpip.EMPTCPIPRequestHandler，主要功能是对请求报文进行解包处理，响应报文进行拼包处理。对于TCPIP通讯，如果需要对报文的字段进行映射，可使用com.ecc.emp.access.tcpip.EMPTCPIPMappedRequestHandler类。serviceIdField与之后的Biz相对应，此处一般默认填“serviceId”，表示根据serviceId的值查找biz中对应的业务逻辑。“是否截去请求报文头”和“是否在返回报文中附带报文头”可根据实际需求配置。双击“请求报文头”及“响应报文头”根据实际需求配置报文头。 选中上图中的“TCPIP渠道接入”，右键“新建”，选中“TCPIP接入交易”并点击，弹出框如下图所示，选中biz，点击“Next”，在接下来的弹出框选中业务逻辑，然后点击Finish。 会创建一个TCPIP接入交易，如下图所示。描述栏可改为有意义的描述，交易码也可根据实际需求进行修改。 之后选中上图中的点击右键，“新建”，分别新建请求报文和响应报文，然后分别双击请求报文和响应报文根据实际需求配置报文格式。 2.3 字段映射 核算平台作为产品，各交易场景有自己的请求响应报文，报文中的字段由核算平台自己定义。在项目实施中，报文的字段与核算平台的字段命名不一致，这就需要进行字段映射。 目前字段映射功能只支持TCPIP通讯方式，具体配置说明如下。 配置TCPIP渠道接入时，接入逻辑应把实现类设为com.ecc.emp.access.tcpip.EMPTCPIPMappedRequestHandler。 字段映射配置文件DICTMapped.xml放在与applicationCmis2Ycloans.xml同级路径下，对于公共字段，放到comm