更新历史

日期 版本 说明 作者
2015/03/03 1.0 初始版 甘海涛
2017/02/18 2.0 Bus Moe Project更新版 Tsuki Sakurano

参考信息

此文档说明上海巴士集团数据中心发布的和接收的数据报文规范及接口技术规范说明。
数据中心=上海巴士集团数据中心
其他系统=上海巴士集团其他业务系统。
数据传输方式采用WEB Service的方法。如未特殊说明,则请求和响应都以UTF-8编码。
* 参数类型说明

类型 说明
CHAR(m..n) 表示可变长字符串,最小长度为m,最大长度为n
CHAR(m) 表示定长字符串,长度为m
NUMBER(m,n) 表示以类似浮点型数字形式出现的字符串,整数部分最大m位,小数部分最大n位
NUMBER(m) 表示以类似整数数字形式出现的字符串,整数部分最大m位
ENUM 枚举类型,可选的值会在字段相应说明栏中列举
BOOL Bool型的返回值,true 或者 false
BOOLEAN 表示布尔值字符串,可选值为“1”表示是,“0”表示否
DATE 表示日期型字串,格式为YYYY-MM-DD, 日期不足10位的以0补齐,如2010-01-01
DATETIME 表示日期时间型,格式为YYYY-MM-DD HH:MI:SS,日期时间不足10位的以0补齐,如2010-01-01 14:04:06
ARRAY 表示此字段是数组类型,其说明会跟随在主元素说明后,以独立报文元素出现。通常用于具有主子结构的数据元素。
OBJECT 表示此字段是对象类型,其说明会跟随在主元素说明后,以独立报文元素出现。通常用于具有复杂结构的数据元素。
DEFINDED 固定值,对应的值会在其后说明

java相关概述

java API开发文档地址:http://ws.84000.com.cn/ws/doc/index.html

调用示例 java

以车辆为例,列出部分核心代码
```
JaxWsProxyFactoryBean factory = newJaxWsProxyFactoryBean();
factory.setServiceClass(BusInfoService.class);
factory.setAddress("http://ws.84000.com.cn:8080/ws/services/bus");
BusInfoServicebusService = (BusInfoService)factory.create();
try {
//添加soap Header
List

headers = newArrayList
();
//添加ak验证码
Header tCredentialHeader = newHeader(newQName("ak"), "56487AD01D7344CF9577A9CAB8F3F3A4", newJAXBDataBinding(String.class));
headers.add(tCredentialHeader);
BindingProvider provider = (BindingProvider)busService;
Mapreq_ctx = provider.getRequestContext();
req_ctx.put(Header.HEADER_LIST, headers);
//服务器支持gzib传输,如果有需要gzib传输,请在http header 添加信息
· req_ctx.put(BindingProvider.ENDPOINT_ADDRESS_PROPERTY, "http://ws.84000.com.cn:8080/ws/services/bus?wsdl");
Map>http_headers = new HashMap>();
http_headers.put("Accept-Encoding", Collections.singletonList("gzip"));
req_ctx.put(MessageContext.HTTP_REQUEST_HEADERS, http_headers);

} catch (JAXBException e) {
logger.error(e.getLocalizedMessage(), e);
}
```
请注意soap header 和 http header的区别 如果一切正常就可以调用busService里的方法了,例如 String str = busService.selectByCompanyName("巴士一公司"); str 就是调用服务返回的结果集,格式请阅读请求响应数据样本。

WEB Service说明

线路数据详细定义

访问 这里

使用实例

1.查询巴士三公司线路基础信息使用以下调用方式

方法名 说明 参数名称 必要 数据类型
selectByCompanyName(String companyName) 获取分公司下线路基础信息 companyName Y String

Post URL: http://ws.84000.com.cn/ws/services/line?wsdl
Post Body:
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ws="http://ws.84000.com.cn/"> <soapenv:Header> <ak>AEA7D1EA980D428D8289E357C6DBF0E6</ak> </soapenv:Header> <soapenv:Body> <ws:selectByCompanyName> <companyName>巴士三公司</companyName> </ws:selectByCompanyName> </soapenv:Body> </soapenv:Envelope>


©️BusMoe Project 巴士萌化计划