智能调度平台接口(GPS系统分册)讲解.docx

新奥智能调度配送管理平台接口规范（GPS系统分册） 二〇一四年十一月 目录 1. 概述 3 1.1. 编写目的 3 1.2. 预期读者 3 1.3. 术语 3 1.4. 交互示意图 3 2. 接口需求 3 2.1. 行驶信息接口 3 2.1.1. 需求描述 3 2.1.2. 数据类清单 3 2.1.3. 接口交互流程图 4 2.1.4. 流程图说明 4 2.1.5. WebService服务清单 4 3. Webservice集成 5 3.1. 行驶信息接口 5 3.1.1. 行驶信息服务 5 3.2. 行驶信息接口 5 3.2.1. 行驶信息服务 5 4. 接口规约 6 4.1. Webservice服务接口基本规约 6 4.1.1. 技术标准 6 4.1.2. 服务设计原则 6 4.1.3. 服务调用原则 7 4.1.4. 接口说明 7  修订历史 版本 类型 成稿日期 责任人 备注  1. 概述 1.1. 编写目的 为统一智能调度管理配送平台与GPS系统的集成接口，特制定本接口规范，以指导智能调度管理配送平台集成的设计、开发、测试及部署实施工作。 1.2. 预期读者 本接口规范预期读者为智能调度管理配送平台和GPS系统接口设计开发人员。 1.3. 术语 Webservice集成：通过WebService的方式进行数据传递的接口集成方式。 1.4. 交互示意图 2. 接口需求 2.1. 行驶信息接口 2.1.1. 需求描述 智能调度管理配送平台在运输监控过程中，根据车头牌照，定时获取相应的行驶信息，包括行驶位置（坐标）、速度、方向、采集时间等。 2.1.2. 数据类清单 GPS系统提供： 数据类型 数据类 交互频度 String 行驶信息 30分钟/次 2.1.3. 接口交互流程图 2.1.4. 流程图说明 1、智能调度平台在业务过程中，生成需要查询的车头牌照； 2、智能调度平台调用GPS系统接口，定时发送车头牌照； 3、GPS系统根据车头牌照，生成相应的行驶信息； 4、GPS系统将车头牌照、行驶信息通过接口返回； 5、智能调度平台获取车辆相应的行驶信息。 2.1.5. WebService服务清单 服务提供者 服务分类 服务名称 GPS系统 行驶信息查询服务 待定？ 3. Webservice集成 3.1. 行驶信息接口 3.1.1. 行驶信息服务 . 接口说明 接口说明 智能调度管理配送平台在运输监控过程中，根据车头牌照，定时获取相应的行驶信息 接口方式 WebService 方法名称 ?(待GPS系统提供) WSDL ?(待GPS系统提供) 服务端 GPS系统 调用端 智能调度管理配送平台 数据频度 30分钟/次 输入参数中文名 输入参数英文名 参数格式 非空 含义 车头牌照 FRONT_NO String (32) 是 车辆唯一标示 用户名 USER_NAME String (32) 接口验证用户名 密码 PASSWD String (32) 接口密码 返回值中文名称 返回值英文名称 返回值格式 非空 含义 车头牌照 ? ? 是 行驶位置 ? ? 是 经度 ? ? 是 维度 ? ? 是 速度 ? ? 否 方向 ? ? 否 采集时间 ? ? 是 . 数据交互说明 4. WebService接口规约 4.1. 技术架构 4.1.1. 技术架构概述 智能调度平台WebService接口采用Xfire技术实现。客户端和服务器用SOAP协议通过HTTP来交互，客户端根据WSDL描述文档生成SOAP请求消息发送到服务端，服务端解析收到的SOAP请求，调用Web service，然后再生成相应的SOAP应答送回到客户端。 4.1.2. 认证机制 智能调度平台的所有WebService服务均需要认证通过（部分需要授权）才能够被调用。智能调度平台WebService服务接收到请求后首先从消息上下文中获取用户名和密码，进行认证，认证通过后再调用具体服务。 作为客户端，应用程序代码(使用Xfire的客户端编程模型来编写的)需要将用户名和密码设置到MessageContext中进行调用。 根据客户端程序语言及调用方式不同，设置的方法也不同，下面列举出客户端程序语言为java的两种设置方式： . 客户端调用 平台使用xfire技术发布webservice服务，建议客户端也使用XFire来访问外部服务，以下客户端调用示例代码都是基于xfire技术来编写的。 一、调用方式 客户端可以通过如下两种方式调用外部服务： 1) 根据WSDL创建客户端调用 如果服务端没有提供接口，可以使用这种简单的方式来调用，如下为客户端调用示例代码： public static void main(String[] args) { String ws