核算平台通讯开发说明资料.doc

核算平台通讯开发说明 修订历史 制定日期制定/修订 内容摘要页数版本拟稿审查批准2015.01.04初稿王瑞 目录 TOC \o 1-3 \h \u  HYPERLINK \l _Toc13837 目录  PAGEREF _Toc13837 3  HYPERLINK \l _Toc13848 1. 概述  PAGEREF _Toc13848 4  HYPERLINK \l _Toc25570 2. 核算平台作为服务端  PAGEREF _Toc25570 5  HYPERLINK \l _Toc31602 2.1 说明  PAGEREF _Toc31602 5  HYPERLINK \l _Toc4582 2.2 实时通讯  PAGEREF _Toc4582 5  HYPERLINK \l _Toc14163 2.3 字段映射  PAGEREF _Toc14163 10  HYPERLINK \l _Toc19489 3. 核算平台作为客户端  PAGEREF _Toc19489 12  HYPERLINK \l _Toc42 3.1 说明  PAGEREF _Toc42 12  HYPERLINK \l _Toc18344 3.2 实时通讯  PAGEREF _Toc18344 12  HYPERLINK \l _Toc21902 3.2.1 创建通讯服务  PAGEREF _Toc21902 12  HYPERLINK \l _Toc4391 3.2.2 配置请求/响应报文  PAGEREF _Toc4391 17  HYPERLINK \l _Toc14127 3.2.3 设置参数及字段值  PAGEREF _Toc14127 19  HYPERLINK \l _Toc24724 3.3 批量通讯  PAGEREF _Toc24724 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.tc