金关工程二期数据交换（核心）系统JAVA-SDK使用手册_V2.1.docx

金关工程二期数据交换子系统SDK使用手册文件状态：[√] 草稿[ ] 正式发布[ ] 正在修改文件标识：金关工程二期数据交换子系统JAVA-SDK《使用手册》当前版本：V2.0作者：完成日期：用户操作手册批准单批准人签字日期变更历史版本变更时间变更章节性质变更内容变更ID修改人批准人1.02015-05-04N创建2.02015-08-03A添加IBMMQ Tonglink注：性质可以为N-新建、A-增加、M-更改、D-删除。目录1引言11.1编写目的11.2术语解释11.3系统介绍22SDK简介23SDK介质23.1数据交换平台Java SDK介质43.2数据交换平台Java SDK文档43.3数据交换平台Java SDK配置文件44SDK运行环境55SDK配置说明56SDK接口介绍76.1获取配置属性76.2将数据封装为XML报文封86.3通过文件方式发送数据至数据交换平台96.4通过Web Service方式发送数据至数据交换平台136.5通过IBM MQ方式发送数据至数据交换平台176.6通过Tonglink消息中间件方式发送数据至数据交换平台237SDK变更历史28引言编写目的本文档介绍了金关二期数据交换子系统SDK的功能以及接口使用方法。术语解释名词解释XML一种可扩展标记语言，它与 HTML 一样，都是 SGML (Standard Generalized Markup Language, 标准通用标记语言)。Web Service是一个平台独立的，低耦合的，自包含的、基于可编程的web的应用程序，可使用开放的XML（标准通用标记语言下的一个子集）标准来描述、发布、发现、协调和配置这些应用程序，用于开发分布式的互操作的应用程序，使得运行在不同机器上的不同应用无须借助附加的、专门的第三方软件或硬件，就可相互交换数据或集成。API (Application Programming Interface)即应用程序编程接口，是一些预先定义的函数，目的是提供应用程序与开发人员基于某软件或硬件得以访问一组例程的能力，而又无需访问源码，或理解内部工作机制的细节。数据交换系统与系统之间进行电子数据交互的称谓，其特点是数据传输的自动化和即时性。系统介绍为了进一步改善海关内部信息化建设，作为海关在“十二五”时期的重大科技专项工程——金关工程二期项目于2012年通过国家立项，并进入建设阶段。2014年11月份，海关正式对数据交换平台软件进行招标，目标是将现有的复杂繁琐的数据交换系统进行替换并建设一个更加统一的、规范的、易于监控管理的新一代数据交换平台。基于海关整体性项目规划并采用厂商提供的产品工具以及技术方案，信息中心计划在2015年底之前分两个阶段建设新的数据交换平台并逐步对现有的数据交换系统进行改造或迁移。通过制定新的统一的数据交换报文规范与技术规范，实现海关与外部单位的数据交换业务以及海关内部业务系统之间以及海关总署与直属海关的数据交换业务。SDK简介数据交换系统作为应用支撑平台的一部分，为业务系统提供数据交换支持。系统对外发布SDK包，提供统一的接口，供其他应用系统进行调用。在调用过程中，SDK会首先将业务数据进行Base64编码处理，然后将编码后的内容按照规范的报文封进行格式化，并发送至数据交换平台。SDK介质SDK介质包括：SDK介质名称SDK介质说明数据交换平台Java SDK介质对待数据进行报文封装，通过文件、WebService方式将数据发送至数据交换平台的Java类。数据交换平台Java SDK文档数据交换平台Java SDK介质说明帮助文档。数据交换平台Java SDK配置文件配置SDK通过文件以及Web Service方式发送数据的文件目录以及Web Service地址等参数。第三方Jar文件记录日志:log4j-api-2.1.jarlog4j-core-2.1.jar获取配置文件路径、配置项信息:config-sdk-1.0.0.jarxml操作类:dom4j-2.0.0-ALPHA1.jarIBM MQ相关Jar包:CL3Nmonservices.jarcom.ibm.mq.headers.jarcom.ibm.mq.jarcom.ibm.mq.jmqi.jarcom.ibm.mq.pcf.jarcom.ibm.mqjms.jarconnector.jardhbcore.jarfscontext.jarjms.jarjndi.jarjta.jarldap.jarproviderutil.jarrmm.jarTonglink相关Jar包:TLQRemoteApi.jarTongJMS.jar数据交换平台Java SDK介质hde-sdk-1.0.0.jar用来Java端对待发送数据进行报文封装，以文件、