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

新奥智能调度配送管理平台接口规范（GPS系统分册）二〇一四年十一月修订历史版本类型成稿日期责任人备注概述编写目的为统一智能调度管理配送平台与GPS系统的集成接口，特制定本接口规范，以指导智能调度管理配送平台集成的设计、开发、测试及部署实施工作。预期读者本接口规范预期读者为智能调度管理配送平台和GPS系统接口设计开发人员。术语Webservice集成：通过WebService的方式进行数据传递的接口集成方式。交互示意图接口需求行驶信息接口需求描述智能调度管理配送平台在运输监控过程中，根据车头牌照，定时获取相应的行驶信息，包括行驶位置（坐标）、速度、方向、采集时间等。数据类清单GPS系统提供：数据类型数据类交互频度String行驶信息30分钟/次接口交互流程图流程图说明1、智能调度平台在业务过程中，生成需要查询的车头牌照；2、智能调度平台调用GPS系统接口，定时发送车头牌照；3、GPS系统根据车头牌照，生成相应的行驶信息；4、GPS系统将车头牌照、行驶信息通过接口返回；5、智能调度平台获取车辆相应的行驶信息。WebService服务清单服务提供者服务分类服务名称GPS系统行驶信息查询服务待定？Webservice集成行驶信息接口行驶信息服务接口说明接口说明智能调度管理配送平台在运输监控过程中，根据车头牌照，定时获取相应的行驶信息接口方式WebService方法名称?(待GPS系统提供)WSDL?(待GPS系统提供)服务端GPS系统调用端智能调度管理配送平台数据频度30分钟/次输入参数中文名输入参数英文名参数格式非空含义车头牌照FRONT_NOString (32)是车辆唯一标示用户名USER_NAMEString (32)接口验证用户名密码PASSWDString (32)接口密码返回值中文名称返回值英文名称返回值格式非空含义车头牌照??是行驶位置??是经度??是维度??是速度??否方向??否采集时间??是数据交互说明WebService接口规约技术架构技术架构概述智能调度平台WebService接口采用Xfire技术实现。客户端和服务器用SOAP协议通过HTTP来交互，客户端根据WSDL描述文档生成SOAP请求消息发送到服务端，服务端解析收到的SOAP请求，调用Web service，然后再生成相应的SOAP应答送回到客户端。认证机制智能调度平台的所有WebService服务均需要认证通过（部分需要授权）才能够被调用。智能调度平台WebService服务接收到请求后首先从消息上下文中获取用户名和密码，进行认证，认证通过后再调用具体服务。作为客户端，应用程序代码(使用Xfire的客户端编程模型来编写的)需要将用户名和密码设置到MessageContext中进行调用。根据客户端程序语言及调用方式不同，设置的方法也不同，下面列举出客户端程序语言为java的两种设置方式：客户端调用平台使用xfire技术发布webservice服务，建议客户端也使用XFire来访问外部服务，以下客户端调用示例代码都是基于xfire技术来编写的。一、调用方式客户端可以通过如下两种方式调用外部服务：根据WSDL创建客户端调用如果服务端没有提供接口，可以使用这种简单的方式来调用，如下为客户端调用示例代码：public static void main(String[] args) {Stringwsdl=4:6001/athena_server/pf_webservice/com.ls.pf.base.impl.auth.extramodel/userService/service?wsdl;Client client = new Client(new URL(wsdl)); // invoke第一个参数为服务方法名，第二个参数为服务参数Object[] results = client.invoke(isAdmin, new String[]{SYSADMIN});System.out.println(results[0].toString());results = client.invoke(getUserBySysUserName, newString[]{SYSADMIN});System.out.println(results[0].toString());}通过服务端提供的接口调用如果服务端有提供接口，或者服务参数和返回值为复杂类型时，则建议使用这种方式，客户端调用代码如下：public static void main(String[] args) {String wsdl=:7080/amber_server/pf_webservice/com.ls.pf.base.impl.auth.extramodel/userService/se