ESB项目_技术规范指引_V1.71.doc

苏州银行 ESB 技术规范指引 文 档 编 号 保 密 等 级 作 者 谭年华4-01-16 审 核 人 最后审批日期 批 准 人 最后批准日期  修订记录 日期 版本 修订说明 修订人 2013-10-20 v1.0 初稿 王维斗 2014-1-16 v1.5 根据规划部修订的该文档年华V1.7 在4.7章节中增加消费者系统对交易成功/失败的判断 谭年华 目录 1. 概述 1 1.1. 编写目的 1 1.2. ESB技术规范 1 1.3. 预期使用者 2 1.4. 相关术语 2 2. ESB使用指引 4 2.1. 接入ESB的步骤 4 2.2. ESB环境说明 5 2.3. 报文数据结构说明 6 2.3.1. 逻辑结构 6 2.3.2. 公共报文 8 . 系统头(SYS_HEAD) 8 . 应用头(APP_HEAD) 11 . 本地扩展头(LOCAL_HEAD) 12 2.4. 标准XML报文 12 2.4.1. 标准XML报文示例 12 3. ESB基本法 14 3.1. 系统功能 14 3.2. 接入原则 15 3.3. 使用原则 15 3.3.1. 服务消费者 15 3.3.2. 服务提供者 16 4. 技术规范 17 4.1. 技术总则 17 4.2. 标准接入 18 4.3. 非标准接入 18 4.4. 应用系统编码管理 19 4.4.1. 系统编号编码规则 19 4.4.2. 应用系统简称编码规则 19 4.4.3. 应用系统简称及编号表 20 4.5. 渠道类型管理 22 4.5.1. 渠道类型编码规则 22 4.5.2. 渠道类型列表 23 4.6. 流水号设计 23 4.6.1. 流水号编码规则 23 4.6.2. 流水号使用规则 24 4.6.3. 对各系统的要求 24 4.6.4. 流水号对照表 24 4.7. 返回信息码设计 25 4.7.1. 信息码编码规则 25 4.7.2. 规则的使用 25 4.7.3. 交易成功/失败的判断 26 4.7.4. 在系统中传递的规则 26 4.8. 服务编码 27 4.8.1. 服务编码规则 27 5. ESB与外围系统的工作流程 27 6. 安全机制 28 6.1. 通用安全技术 29 6.2. 基于密钥同步安全控制 29 6.3. 松耦合的安全架构 30 概述 编写目的 本文档是苏州银行ESB产品的使用说明书。ESB产品作为企业的服务总线对外提供服务，服务的消费者需要调用ESB系统上的服务，服务的提供者需要在ESB系统上发布服务，相关的系统都需要遵循ESB提出来的技术规范。 为了简化相关系统遵循规范带来的麻烦，避免出现各个系统都需要根据ESB的规范开发重复的程序，ESB产品提供了一个API供服务的消费者和服务的提供者使用。该API主要是解决XML报文格式转换、报文编码、系统安全认证和通讯上的相关问题。 ESB的API主要提供了两种语言的API包： JAVA API：针对JAVA系统编写的API。 C语言 API：针对C、C++语言系统编写的API。 ESB技术规范 ESB的技术规范主要包括4个方面的内容： 报文格式：采用XML的报文进行通讯，报文的格式请参见本文4.3章节“报文数据结构说明”，报文内容需要根据服务规范来确定。 报文编码：ESB的报文编码，对于JAVA语言的系统，要求使用的编码是UTF-8；对于C语言的系统，要求报文编码是GBK。 MBSD服务规范用double定义金额类型，如果外围系统需要用金额类型做计算推荐转换成bigdecimal对象后再进行计算。 通讯方式：ESB的通讯方式，对于JAVA语言的系统，要求采用HTTP Servlet的通讯方式；对于C语言的系统，要求通讯方式是Socket。 服务的消费者请求ESB的服务，ESB需要对服务的消费者进行安全的认证。服务的提供者可以参考ESB系统的系统安全认证方案对ESB系统进行认证。 ESB的技术规范旨在指导企业新建系统和需要改造系统的技术实现，对于存量并且暂定不改造的系统，其与ESB的通讯方式，报文格式，报文编码和交易的接口不受此约束。ESB系统作为开放性的一个交易平台可以实现适配的功能，实现服务规范与系统接口的转换功能。 预期使用者 ESB产品研发人员； ESB实现项目组的架构师、系统分析员和软件开发配置人员； ESB服务消费者的系统分析员、软件开发人员及相关人员； ESB服务提供者的系统分析员、软件开发人员及相关人员。 相关术语 序号 术语/缩略语 全称和说明 ESB Bank Enterprise Service Bus，企业级服务总线，简称ESB。本文中如无特殊说明为系统的简称。