江苏省新型农村合作医疗_省级平台_接口技术标准(杭州创业).docVIP

[√] 初稿 [ ] 发布 [ ] 修订 编 撰： 曹小健 编撰日期： 2009-02-09 保密级别： 机密 文档版本： 2．2 文件编号： Q/BS-QH-3-09 省级平台-接口技术标准 杭州创业软件集团股份有限公司 目 录 TOC \o 1-3 \h \z \u 1. HTTP接入 3 1.1. 概述 3 1.2. 词语解释 3 1.3. 总体描述 3 1.4. 交换模型 4 1.5. 协议模型 4 1.5.1. 请求信息所添加的HTTP头域 5 1.5.2. 回应所添加的头域 6 1.5.3. 协议样例以及说明 6 . 发送同步请求消息及返回结果消息 6 . 发送异步请求消息及返回结果消息 11 . 根据省平台消息标识获取异步请求消息的处理结果 12 2. COM接入 18 2.1. 概述 18 2.2. 词语解释 18 2.3. 总体描述 18 2.4. 交换模型 19 COM组件AdapterProxy.dll调用方法 19 方法：setAdapterHttpInboundUrl 20 syncInvoke方法说明： 20 syncInvokeMsg方法说明： 20 方法ayncInvoke说明 21 方法aquireInvokeResponse的说明 21 方法aquireInvokeResponseMsg的说明 22 2.5. COM接口调用样例以及说明 22 VC的工具OLE view 22 VC例子 23 PB例子 25 异常及错误处理 25 3. SOAP接入 26 3.1. 概述 26 3.2. 词语解释 26 3.3. 总体描述 26 3.4. 交换模型 27 3.5. SOAP方法说明 28 3.6. 样例以及说明 30 HTTP接入 概述 本文详细介绍通过HTTP协议来接入省级平台，使用HTTP协议来上传数据、请求得到省级平台信息等。在现在流行语言中，一般称这种接入方法为REST。 词语解释 HTTP协议：HTTP（HyperTextTransferProtocol）是超文本传输协议的缩写，它用于传送WWW方式的数据，关于HTTP协议的详细内容请参 考RFC2616。HTTP协议采用了请求/响应模型。客户端向服务器发送一个请求，请求头包含请求的方法、URI、协议版本、以及包含请求修饰符、客户 信息和内容的类似于MIME的消息结构。服务器以一个状态行作为响应，相应的内容包括消息协议的版本，成功或者错误编码加上包含服务器信息、实体元信息以 及可能的实体内容。 总体描述 HTTP接口主要是为了提供一个通用的接口，这个接口不需要关心接入的系统是使用什么语言编写的，只需要这种编程语言支持HTTP协议。相对其他接入方式来说，HTTP接口通用性比较强。 实例图如下： 说明：接入系统通过HTTP协议接入省级平台。 交换模型 接入系统通过HTTP协议跟省级平台通信的时候，建立跟平台的链路连接，发送数据，发送数据完之后，等待省级平台返回结果，接收结果之后，关闭跟省级平台的链接，下一次回话，再次建立跟省级平台的链路连接。 如下图所示： 说明： 接入系统主动建立跟省级平台的连接（通过HTTP协议）。 接入系统发送HTTP请求数据。 省级平台返回HTTP结果给接入系统。 接入系统以及省级平台关闭HTTP连接。 协议模型 本接入方式的传输协议建立在HTTP协议之上，通过在HTTP头域里面加入自定义的头信息以及将业务信息放入在HTTP正文里面来交互数据。同理，省级平台在回应接入系统的请求时，也是把回应结果放入到HTTP头域里面，将业务信息（如果有的话）放入到HTTP正文里面。 所有的请求都是通过POST方式将数据发送到省级平台。 请求信息所添加的HTTP头域 序号 HTTP头域 说明 1 hai.method 说明需要使用的调用类别（同步、异步、取得异步请求结果）。 2 hai.targetLogicApp 提供目标服务的系统。 3 hai.targetLogicService 需要调用的目标服务。 4 hai.sourceLogicApp 发起该次调用的源系统。 各个头域说明如下： hai.method：说明需要调用的方法，可选择的参数为： 序号 方法名称 说明 1 syncInvoke 同布发送一个请求，要求省级平台立即返回结果。 2 ayncInvoke 异步发送一个请求，但是不返回结果，返回给接入平台的是该次请求的标识，接入平台可以在适当的时机通过“aquireInvokeRes