《智能调度平台接口(地图服务系统分册)》由会员分享，可在线阅读，更多相关《智能调度平台接口(地图服务系统分册)（15页珍藏版）》请在金锄头文库上搜索。
1、智能调度配送管理平台接口规范智能调度配送管理平台接口规范 （地图服务系统分册）（地图服务系统分册）二一四年十一月智能调度平台接口规范（地图服务系统分册）目录目录1.概述概述.31.1.编写目的31.2.预期读者31.3.术语31.4.交互示意图32.接口需求接口需求.32.1.场站标注信息接口32.1.1.需求描述.32.1.2.数据类清单.32.1.3.接口交互流程图.42.1.4.流程图说明.42.1.5.WebService 服务清单42.2.气源地标注信息接口52.2.1.需求描述.52.2.2.数据类清单.52.2.3.接口交互流程图.52.2.4.流程图说明.62.2.5.WebS
2、ervice 服务清单63.WEBSERVICE 集成集成 63.1.场站标注信息接口63.1.1.场站标注信息接口服务.63.2.气源地标注信息接口73.2.1.气源地标注信息接口服务.74.WEBSERVICE 接口规约接口规约 84.1.技术架构84.1.1.技术架构概述.84.1.2.认证机制.84.2.数据规约104.2.1.Webservice 接口数据协议.104.2.2.XML 数据格式约定.114.2.3.XML 数据格式示例.114.3.WEBSERVICE WSDL124.3.1.地图服务系统 WSDL 125.示例示例.135.1.示例: 嵌套情况.135.2.示例:
3、返回 0 行.13智能调度平台接口规范（地图服务系统分册）修订历史 版本类型成稿日期责任人备注智能调度平台接口规范（地图服务系统分册）1. 概述概述1.1. 编写目的编写目的为统一智能调度管理配送平台与地图服务系统的集成接口，特制定本接口规范，以指导智能调度管理配送平台集成的设计、开发、测试及部署实施工作。1.2. 预期读者预期读者本接口规范预期读者为智能调度管理配送平台和地图服务系统接口设计开发人员。1.3. 术语术语Webservice 集成：通过 WebService 的方式进行数据传递的接口集成方式。1.4. 交互示意图交互示意图智能调度管理配送 平台地图服务系统2. 接口需求接口需求
4、2.1. 场站标注信息接口场站标注信息接口2.1.1. 需求描述需求描述根据智能调度平台业务开展的要求，需要从 GIS 系统中获取场站位置数据，为销售管理、气源采购管理、运力采购管理、智能匹配管理、运输执行等业务开展提供数据支撑。智能调度平台接口规范（地图服务系统分册）2.1.2. 数据类清单数据类清单智能调度配送管理平台：数据类型数据类型数据类数据类交互频度交互频度场站位置信息场站位置明细信息实时2.1.3. 接口交互流程图接口交互流程图场站标注信息接口服务智智能能调调度度配配送送管管理理平平台台地地图图服服务务系系统统开始标注场站位置信息场站标注信息发送请求数据存储结束接收反馈指令返回已获
5、取指令2.1.4. 流程图说明流程图说明1、智能调度管理平台在业务过程中，标注场站地图信息并存储场站地图信息。2、智能调度管理平台调用地图服务系统 Webservice 接口，通知地图服务系统将，并产生的场站位置信息发送到地图服务系统。3、地图服务系统接收到智能调度平台发送过来的场站位置信息和 Webservice 通知后，存储相关信息。4、地图服务系统将结果反馈给智能调度平台。智能调度平台接口规范（地图服务系统分册）2.1.5. WebService 服务清单服务清单服务提供者服务提供者服务分类服务分类服务名称服务名称地图服务系统?2.2. 气源地标注信息接口气源地标注信息接口2.2.1.
6、需求描述需求描述根据智能调度平台业务开展的要求，需要从 GIS 系统中获取气源地位置数据，为销售管理、气源采购管理、运力采购管理、智能匹配管理、运输执行等业务开展提供数据支撑。2.2.2. 数据类清单数据类清单智能调度配送管理平台：数据类型数据类型数据类数据类交互频度交互频度气源地位置信息气源地位置明细信息实时2.2.3. 接口交互流程图接口交互流程图智能调度平台接口规范（地图服务系统分册）气源地标注信息接口服务智智能能调调度度配配送送管管理理平平台台地地图图服服务务系系统统开始标注气源地位置信息场站标注信息发送请求数据存储结束接收反馈指令返回已获取指令2.2.4. 流程图说明流程图说明1、智
7、能调度管理平台在业务过程中，标注气源地地图信息并存储气源地地图信息。2、智能调度管理平台调用地图服务系统 Webservice 接口，通知地图服务系统，并将产生的气源地位置信息发送到地图服务系统。3、地图服务系统接收到智能调度平台发送过来的气源地位置信息和 Webservice 通知后，存储相关信息。4、地图服务系统将结果反馈给智能调度平台。2.2.5. WebService 服务清单服务清单服务提供者服务提供者服务分类服务分类服务名称服务名称地图服务系统?3. Webservice 集成集成3.1. 场站标注信息接口场站标注信息接口智能调度平台接口规范（地图服务系统分册）3.1.1. 场站标
8、注信息接口服务场站标注信息接口服务3.1.1.1. 接口说明接口说明接口说明接口说明根据智能调度平台业务开展的要求，需要从 GIS 系统中获取场站位置 数据，为销售管理、气源采购管理、运力采购管理、智能匹配管理、 运输执行等业务开展提供数据支撑。接口方式接口方式Webservice方法名称方法名称 ?服务端服务端地图服务系统调用端调用端智能调度管理配送平台数据频度数据频度实时输入参数中文输入参数中文 名名输入参数英文输入参数英文 名名参数格式参数格式非空非空含义含义?返回值中文名返回值中文名 称称返回值英文名返回值英文名 称称返回值格式返回值格式非空非空含义含义成功/失败标 志RLT_FLAG
9、STRING(8)1 成功0 失败失败原因FAIL_MEMOSTRING(256)3.1.1.2. 数据交互说明数据交互说明3.2. 气源地标注信息接口气源地标注信息接口3.2.1. 气源地标注信息接口服务气源地标注信息接口服务3.2.1.1. 接口说明接口说明接口说明接口说明根据智能调度平台业务开展的要求，需要从 GIS 系统中获取气源地位 置数据，为销售管理、气源采购管理、运力采购管理、智能匹配管理、 运输执行等业务开展提供数据支撑。接口方式接口方式Webservice智能调度平台接口规范（地图服务系统分册）方法名称方法名称 ?服务端服务端地图服务系统调用端调用端智能调度管理配送平台数据频
10、度数据频度实时输入参数中文输入参数中文 名名输入参数英文输入参数英文 名名参数格式参数格式非空非空含义含义?返回值中文名返回值中文名 称称返回值英文名返回值英文名 称称返回值格式返回值格式非空非空含义含义成功/失败标 志RLT_FLAGSTRING(8)1 成功0 失败失败原因FAIL_MEMOSTRING(256)3.2.1.2. 数据交互说明数据交互说明4. WebService 接口规约接口规约4.1. 技术架构技术架构4.1.1. 技术架构概述技术架构概述智能调度平台 WebService 接口采用 Xfire 技术实现。客户端和服务器用 SOAP 协议通过 HTTP 来交互，客户端根
11、据 WSDL 描述文档生成 SOAP 请求消息发送到服务端，服务端解析收到的 SOAP 请求，调用 Web service，然后再生成相应的 SOAP 应答送回到客户端。4.1.2. 认证机制认证机制智能调度平台的所有 WebService 服务均需要认证通过（部分需要授权）才能够被调用。智能调度平台 WebService 服务接收到请求后首先从消息上下文中获取用户名和密码，进行认证，认证通过后再调用具体服务。智能调度平台接口规范（地图服务系统分册）作为客户端，应用程序代码(使用 Xfire 的客户端编程模型来编写的)需要将用户名和密码设置到 MessageContext 中进行调用。根据客户
12、端程序语言及调用方式不同，设置的方法也不同，下面列举出客户端程序语言为 java 的两种设置方式：4.1.2.1. 客户端调用客户端调用平台使用 xfire 技术发布 webservice 服务，建议客户端也使用 XFire 来访问外部服务，以下客户端调用示例代码都是基于 xfire 技术来编写的。一、调用方式客户端可以通过如下两种方式调用外部服务：1)根据 WSDL 创建客户端调用如果服务端没有提供接口，可以使用这种简单的方式来调用，如下为客户端调用示例代码：public static void main(String args) String wsdl=“http:/172.21.0.84
13、: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(results0.toString();results = client.invoke(“getUs
14、erBySysUserName“, newString“SYSADMIN“);System.out.println(results0.toString();2)通过服务端提供的接口调用如果服务端有提供接口，或者服务参数和返回值为复杂类型时，则建议使用这种方式，客户端调用代码如下：public static void main(String args) String wsdl=“http:/127.0.0.1:7080/amber_server/pf_webservice/com.ls.pf.base.impl.auth.extramodel/userService/service“;Servi
15、ce srvcModel = newObjectServiceFactory().create(IUserService.class);XFireProxyFactory factory = new XFireProxyFactory(XFireFactory.newInstance().getXFire();智能调度平台接口规范（地图服务系统分册）try IUserService userService = (IUserService) factory.create(srvcModel, wsdl);XFireProxy proxy = (XFireProxy)Proxy.getInvoca
16、tionHandler(userService); Client client = proxy.getClient(); Boolean resut=userService.isAdmin(“SYSADMIN“); catch (MalformedURLException e) e.printStackTrace(); 二、添加验证信息头当访问的 webservice 服务需要进行认证时，客户端调用代码需要传入认证信息头，如下分别为服务端是 AuthenticationHandler 认证和 ws-security 认证时验证头添加方式服务端为 AuthenticationHandler 认证当服务端配置了 AuthenticationHandler 认证时，客户端通过如下示例代码添加验证头：Client client ;ClientAuthenticationHandler handler = new ClientAuthenticationHandler(“用户名“,“密码“);cl
