MAS2.0_WebService插件接口开发手册 2.doc

中国移动代理服务器 MAS V2.0 WebService 插件接口开发手册1中国移动代理服务器 MAS V2.0 WebService 接口插件开发手册2010年 10月 中国移动代理服务器 MAS V2.0 WebService 插件接口开发手册2目 录1． 引言 .....................................................................................................................11.1 编写目的 ...........................................................................................................................11.2 相关术语与缩略语解释 ...................................................................................................12．概述 ..........................................................................................................................13．开发环境 ..................................................................................................................24．开发步骤 ..................................................................................................................24.1MAS 服务器应用插件 WebService 插件参数建立 .......................................................24.2 插件管理接口 ...................................................................................................................34.2.1 接口说明 ..................................................................................................................................34.2.2 流程说明 ..................................................................................................................................34.2.3 数据类型 ..................................................................................................................................4通讯能力 CMAbility ........................................................................................................................44.2.4 接口定义 ..................................................................................................................................64.3应用系统服务通知接口 ..................................................................................................94.3.1 接口说明 ..................................................................................................................................94.3.2 流程说明 ..................................................................................................................................94.3.3 接口定义 ................................................................................................................................104.3.4 短信接口 ................................................................................................................................114.3.5 彩信接口 ................................................................................................................................174.3.5WAP PUSH 短信接口 ............................................................................................................23 中国移动代理服务器 MAS V2.0 WebService 插件接口开发手册11． 引言本手册用于指导立通MAS2.0平台上的WebService插件开发。

1.1 编写目的本文档描述了MAS2.0基座WebService 通信接口的使用方法，文档的使用对象为MAS 开发人员、数字化部队、SI工程技术人员、SI开发人员、集团客户技术人员注：本文档的读者需要有一定的 WebService 相关知识1.2 相关术语与缩略语解释缩写词 英文解析 中文解析MAS Mobile Agent Server 移动代理服务器HTTP Hypertext Transfer Protocol 超文本传输协议HTTPS Secure HTTP 加密的 HTTP 协议SOAP Simple Object Access Protocol 简单对象访问协议DB Database DB 服务接口2．概述WebService 方式通信提供了对各种通信能力的统一封装，供集团客户应用系统和MAS服务器应用插件进行调用同时，提供统一WebService 方式封装也降低了si 的开发难度，将繁杂的通信能力协议与具体的业务应用分离开来，对si呈现简单的标准接口WebService 方式通信适配插件接口封装了以下移动通信能力： 短信 彩信 Wappush此外，还提供基座与应用插件之间的插件管理功能接口。

MAS 服务器应提供配置工具，指定对于某个集团客户应用系统或应用插件，通过WebService 方式通信适配插件或数据库方式通信适配插件接入MAS 服务器 中国移动代理服务器 MAS V2.0 WebService 插件接口开发手册23．开发环境 JDK：java6 应用服务器：Tomcat5.5  数据库版本：MySQL 5.0.21 WebService 工具：AXIS1.44．开发步骤插件在使用MAS服务器通信能力之前必须向MAS服务器注册，所以必须先在MAS服务器上建立应用插件的参数信息4.1MAS 服务器应用插件 WebService 插件参数建立1：运行 MAS2.0服务器，登录到 “系统管理”-> “MAS配置管理”->“通讯适配插件管理”中进行WebService通讯能力设置注：通讯能力依赖MAS服务器所拥有的能力而定，只要MAS服务器通过到MAS管理平台鉴权回来拥有短信、彩信、WapPush等能力，这里就可以进行设置2：创建应用插件参数，进入“配置中心”->“应用插件管理”进行参数配置，如下图红色框部分， “通讯接口方式”必须选择“WebService” ，可以根据插件功能需要选择开启某个应用能力。

中国移动代理服务器 MAS V2.0 WebService 插件接口开发手册3WebServicedi 地址：http://10.2.93.251:80/services/cmcc_mas_wbs4.2 插件管理接口4.2.1 接口说明插件管理接口实现对应用插件的注册、注销、暂停和恢复，各插件通过此接口报告插件状态插件管理具体内容包括：插件的注册、注销、启用、暂停插件状态报告WebService方式通信适配插件作为基座插件管理模块的代理，实现插件管理相关操作信息的处理和转发4.2.2 流程说明插件注册流程说明： 中国移动代理服务器 MAS V2.0 WebService 插件接口开发手册4A P R e g i s t r a t i o n R e qW e b S e r v i c e 方式通信适配插件应用插件A P R e g i s t r a t i o n R s pA P S t a t u s R e p R e qA P S t a t u s R e p R s pP a u s e A P R e qP a u s e A P R s pR e c o v e r y A P R e qR e c o v e r y A P R s pA P L o g O u t R e qA P L o g O u t R s pMAS服务器系统中应用插件必须注册通过后方可使用，WebService 方式通信适配插件将该请求转发到插件管理模块并获得结果，将结果封装在响应消息中返回给应用插件，注册及响应过程通过APRegistration操作实现。

应用插件注册通过后，要周期性地进行状态汇报并获取响应，状态报告及响应过程通APStatusRep操作完成在应用插件运行过程中，根据从MAS统一服务平台得到的业务能力信息，插件管理模块可以主动地发出命令，暂停或恢复特定的插件，这些指令经WebService方式通信适配插件通知给应用插件，通过PauseAP和RecoveryAP两个操作实现在应用插件结束之前，应用插件主动发起注销操作APLogOut 考虑到一个应用插件可能包含多个进程，因此在上述流程中，注册、状态上报和注销为进程。