Mas2.0接口文档技术分析.doc

Mas 2.0 接口文档 （节选自《移动代理服务器（MAS）系统接口规范V2.1.0》） 1.1. WebService方式通信适配插件接口 2 1.1.1. Web服务公共数据定义 2 1.1.2. 插件管理接口 8 1.1.3. 应用系统服务通知接口 18 1.1.4. 短消息接口 19 1.1.5. 多媒体消息接口 25 1.1.6. 定位接口 31 1.1.7. WAP PUSH接口 39 1.1.8. USSD业务接口 42 1.1.9. 操作汇总 46 1.2. 数据库方式通信适配插件接口 48 1.2.1. 数据库组网方式 48 1.2.2. 数据库表结构定义 49 WebService方式通信适配插件接口 WebService方式通信适配插件提供了对各种通信能力的统一封装，供集团客户应用系统和MAS服务器应用插件进行调用。同时，提供统一WebService方式封装也降低了SI的开发难度，将繁杂的通信能力协议与具体的业务应用分离开来，对SI呈现简单的标准接口。WebService方式通信适配插件接口封装了以下移动通信能力： 短信 彩信 wap ussd LBS 此外，还提供基座与应用插件之间的插件管理功能接口。 MAS服务器应提供配置工具，指定对于某个集团客户应用系统或应用插件，通过WebService方式通信适配插件或数据库方式通信适配插件接入MAS服务器。 Web服务公共数据定义 命名空间 公共数据类型的命名空间参见： /schema/common/v2_0 公共异常的命名空间参见： /wsdl/common_faults/v2_0 WEB服务调用方式 WEB服务应支持HTTP上的SOAP使可通过HTTP与服务器进行通信。XML Schema（W3C Recommendation (2 May 2001): XML Schema Part 2: Datatypes）。 XML Schema数据类型定义 TimeMetricsValues 数据类型为枚举型。 值 描述 Millisecond 毫秒 Second 秒 Minute 分 Hour 小时 Day 日 Week 星期 Month 月 Year 年 TimeMetric 数据类型为结构。 名称 类型 描述 Metric TimeMetricValues 计量单位 Units xsd:int 数值 ServiceError 数据类型为结构。 名称 类型 描述 MessageId xsd:string 消息标识 Text xsd:string 消息说明 Variables xsd:string [0..unbounded] 变量 SimpleReference 数据类型为结构。 名称 类型 描述 Endpoint xsd:anyURI 端口 InterfaceName xsd:string 接口名称 Correlator xsd:string 关联标识 CMAbility 数据类型为枚举。 值 描述 SMSbility 对短信能力的需求 MMSAbility 对彩信能力的需求 WAPAbility 对WAP能力的需求 USSDAbility 对USSD能力的需求 LBSAbility 对LBS能力的需求 GPRSAbility 对GPRS能力的需求 MessageNotificationType 用于集团客户应用系统和应用插件通知通信能力需求及所提供的web服务端地址。 数据类型为结构： 名称 类型 描述 CMAbility CMAbility 对应某一个通信能力 WSURI xsd:anyURI 对应该通信能力，应用系统或插件提供的WEB服务端地址 公共异常定义 业务异常 业务异常消息使用保留的消息标识符‘SVC’，并使用从0001到0999的号码来定义。其中0001至0199被保留作公共差错定义，0200至0999作为其它Web Service指定用途。从‘1000’至‘9999’为自定义。 名称 类型 描述 MessageId xsd:string 消息标识符，前缀为SVC Text xsd:string 消息文本，可变可替代部分用%来标识 Variables xsd:string [0..unbounded] 替代文本字串中的可变部分 SVC0001: 业务错误 名称 描述 Message Id SVC0001 Text 发生了一个业务错误。错误代码是%1 Variables %1－来自业务的错误码。 SVC0002: 不合法的输入值 名称 描述 Message Id SVC0002 Text 消息部分%1有不合法的输入值。 Variables %1－消息部分。 S