java 前置系统报文通讯方式_通讯前置使用手册.doc

通讯前置使用手册.doc

1目录第一章通讯前置概述3第二章通讯前置服务器5第一节概述5第二节安装5第三节目录结构6第三章业务配置工具10第一节概念10第二节功能介绍12第三节业务配置步骤15第四节同步短连接业务配置17第五节异步长连接业务配置37第六节异步转同步交易配置42第七节同步长连接交易配置46第四章字符监控服务器49第一节概述49第二节操作50第五章组件57第一节概述57第二节报文组件58第三节通讯组件60第四节数据库组件62第五节变量操作组件64第六节数据校验组件66第七节数据加密组件66第八节空组件67第九节组件的组合67第六章报文69第一节概述69第二节定长报文73第三节分隔符报文74第四节ISO8583报文75第五节包头报文782第七章格式化方法79第一节数字字符串工具类79第二节字符串工具类82第三节日期工具类84第八章业务资源管理86第一节接入适配器86第二节接出适配器88第三节流水号产生器90第四节数据库资源91第五节路由配置93第六节映射表配置98第九章日志100第一节日志方案100第二节日志文件配制102第三节日志分析工具1043第一章通讯前置概述通讯前置系统是一个基于TCP/IP方式的通用通讯平台，它提供了丰富的通讯、报文转换和路由选择功能，能够整合各种杂乱无序的通讯需求，作为各类客户端和服务端的通讯枢纽，为其形成统一、平滑的通讯连接，为之提供统一、方便的管理。它是一个分布式，高度可配置的，组件化的运行、开发平台，提供二次开发的方式，有力的帮助客户方便、快捷的扩展新的业务。通信前置主要包括三个部分，下面先对这三部分分别加以简介，最后再介绍通讯前置的主要功能。一、通信前置服务器通信前置服务器是通讯前置系统的核心和主体，系统所有的对外的服务都由它提供。它主要包括控制器和监听线程，控制器读取配置文件，建立起两个WEB端口来监听监控工具的管理请求，然后按照请求启动或者停止监听线程。监听线程负责监听某个具体的业务请求，在收到业务请求后，启动业务处理线程进行处理。二、通信前置服务监控工具监控工具负责对监听线程的状态进行控制。在这里可以设置监听线程的端口号，最大工作线程数等参数。可以启动和停止监听线程。管理员可以通过运行在字符终端的监控工具或者WEB浏览器进行监控和管理工作。三、通信前置业务配置工具业务配置工具是用JAVA开发的图形化用户界面，它用来收集用户的业务需求，将其转换为通讯前置服务器可读的配置文件，供通讯前置服务器读取。配置的主要内容是流程配置，报文格式配置及资源的配置等。上述三个部分相互独立，它们可以分别安装在不同的机器上，但它们也是紧密联系的，缺一不可。它们的关系如图11所示4图11通讯前置2结构示意图WEB浏览器业务配置工具服务器监控工具配置服务器配置文件控制器业务监听线程业务监听线程客户客户MAPSDSR网关四、通讯前置服务器的主要功能1通讯模式转换随着业务的拓展，第三方的通讯模式越来越多样化，有同步的，有异步的，有长连接，也有短连接，而中间业务的通讯模式也可能有以上几种模式，通讯前置支持各种通讯模式的相互转换,为第三方和中间业务提供了统一、平滑的通讯连接。2报文格式转换第三方报文格式的定义更加是千差万别的，有定长报文、分隔符报文，8583报文，NATP报文，XML报文等，甚至是同一种类型的报文，比如同样是8583报文，它们的定义也可以不相同。通讯前置服务器能够将第三方各种不同格式的报文转换成中间业务统一的报文格式，这也为第三方和中间业务通讯提供了可靠的保证。3路由选择中间业务可以同时启动多个服务，路由选择的作用可以将交易按照负载均5衡的原理或按照指定的要求分散到中间业务的各服务器上，这也保证了整个系统的稳定性。通讯前置服务器除了上述三大主要功能外，还有其它功能，比如通讯前置本身还具有集群功能，在后面章节我们介绍各种功能的实现方法。第二章通讯前置服务器第一节概述通讯前置服务器是整个通讯前置系统的核心，通讯前置的所有应用功能都是由它实现的，也是整个系统中最复杂的部分。图11是一个典型的通讯前置服务器内部的系统工作流程6图11通信前置系统流程从图11我们可以看出，通讯前置系统主要分为两部分，处理客户端流程和处理服务端流程，以后我们都简称为客户端流程和服务端流程。在这里我们重点关心的是如何安装和使用通讯前置系统。通讯前置系统是跨平台的系统，由于通讯前置服务器是基于JAVA开发的，只要操作系统能够支持JAVA，那么就可以安装和使用通讯前置服务器。通讯前置服务器支持的最低JAVA运行环境是JRE131。接下来一节讲述通讯前置服务器的安装。7第二节安装通讯前置系统目前以压缩包的形式提供给用户，整个系统分为两个压缩包，GERONIMOTESTZIP和ECIIDEZIP。其中GERONIMOTESTZIP为通信前置服务器安装包，ECZIPIIDE为通讯前置业务配置IDE环境，目前暂不提供通信前置服务监控工具安装文件。安装步骤如下一、安装JREJDK运行环境，通讯前置服务器支持的最低JAVA运行环境是JRE131，设置JAVA_HOME环境变量。二、解GERONIMOTESTZIP压缩包将GERONIMOTESTZIP解压缩到指定的安装目录下即可。转到安装目录下，输入JAVA–JARBIN/SERVERJAR在该通讯组件的后脚本计算离超时还剩多少时间，脚本写法是ENVSETVAR“TIMEOUT“,STRINGVALUEOFLONGPARSELONGENVGETVAR“TIMEOUT“SYSTEMCURRENTTIMEMILLISLONGPARSELONGENVGETVAR“CURRENTSYSTEMTIME“44图338同步长连接工作流程简易图再接下来就是拆第三方返回的数据包，由于每笔交易总有一个能够唯一标识该笔交易的标志，比如是银行系统参考号，那么此处拆包时，该字段必须使用另一个不相同的变量名来区分，假设为返回银行系统参考号，否则会将已有银行系统参考号覆盖。接下来就是要比较返回银行系统参考号同银行系统参考号是否相等，如果相等，则表明收到是同一笔交易，不是超时返回的交易，如果不相等，则表明收到的交易是超时返回的交易，应该直接丢弃，继续接收后面的交易，直到相等或超时为止。故接下来就使用了一个WHILE循环组件，它的作用是如果收到是超时交易，则一直接收第三方返回的交易，直到收到所需要的交易为止，WHILE循环的条件是{返回银行系统参考号}{银行系统参考号}。在WHILE循环中的不定长通讯组件的配置如下图339所示45图339同步长连接不定长通讯组件属性界面该通讯组件的操作是接收，自定义超时时间是变量TIMEOUT，该值初始值为60000毫秒，每通过一次循环该值都在减少，离超时时间肯定是越来越短了，故在该通讯组件中必须计算每次所花的时间，它也是通过脚本来实现的，它的前脚本和后脚本同前面的完全相同。再接下来就是在WHILE循环组件外的拼包组件和不定长通讯组件了，它的作用是拼成中间业务的包并将数据返回给中间业务，这就没什么特别之处了。通过上述介绍，我们知道同步连接的超时问题是通过脚本和WHILE循环组件来实现的，即就是通过流程来灵活配置的，在正常情况下(未超时)是不会执行WHILE循环的。46第四章字符监控