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

中国移动代理服务器MAS V2.0 WebService 接口插件 开发手册 2010年10月目 录 1． 引言 1 1.1编写目的 1 1.2相关术语与缩略语解释 1 2．概述 1 3．开发环境 2 4．开发步骤 2 4.1MAS服务器应用插件WebService插件参数建立 2 4.2插件管理接口 3 4.2.1接口说明 3 4.2.2流程说明 3 4.2.3数据类型 4 通讯能力CMAbility 4 4.2.4接口定义 6 4.3应用系统服务通知接口 9 4.3.1接口说明 9 4.3.2流程说明 9 4.3.3接口定义 10 4.3.4短信接口 11 4.3.5彩信接口 17 4.3.5WAP PUSH短信接口 23  引言 本手册用于指导立通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 简单对象访问协议 Database DB服务接口 2．概述 WebService 方式通信提供了对各种通信能力的统一封装，供集团客户应用系统和MAS服务器应用插件进行调用。同时，提供统一WebService 方式封装也降低了si 的开发难度，将繁杂的通信能力协议与具体的业务应用分离开来，对si呈现简单的标准接口。WebService方式通信适配插件接口封装了以下移动通信能力： 短信 彩信 Wappush 此外，还提供基座与应用插件之间的插件管理功能接口。 MAS 服务器应提供配置工具，指定对于某个集团客户应用系统或应用插件，通过WebService方式通信适配插件或数据库方式通信适配插件接入MAS服务器。 3．开发环境 JDK：java6 应用服务器：Tomcat5.5 数据库版本：MySQL 5.0.21 WebService工具：AXIS1.4 4．开发步骤 插件在使用MAS服务器通信能力之前必须向MAS服务器注册，所以必须先在MAS服务器上建立应用插件的参数信息。 4.1MAS服务器应用插件WebService插件参数建立 1：运行 MAS2.0服务器，登录到“系统管理”-“MAS配置管理”-“通讯适配插件管理”中进行WebService通讯能力设置。 注：通讯能力依赖MAS服务器所拥有的能力而定，只要MAS服务器通过到MAS管理平台鉴权回来拥有短信、彩信、WapPush等能力，这里就可以进行设置。 2：创建应用插件参数，进入“配置中心”-“应用插件管理”进行参数配置，如下图红色框部分，“通讯接口方式”必须选择“WebService”，可以根据插件功能需要选择开启某个应用能力。 WebServicedi地址：51:80/services/cmcc_mas_wbs 4.2插件管理接口 4.2.1接口说明 插件管理接口实现对应用插件的注册、注销、暂停和恢复，各插件通过此接口报告插件 状态。插件管理具体内容包括： 插件的注册、注销、启用、暂停 插件状态报告。 WebService方式通信适配插件作为基座插件管理模块的代理，实现插件管理相关操作信息的处理和转发。 4.2.2流程说明 插件注册流程说明： MAS服务器系统中应用插件必须注册通过后方可使用，WebService方式通信适配插件将该请求转发到插件管理模块并获得结果，将结果封装在响应消息中返回给应用插件，注册及响应过程通过APRegistration操作实现。应用插件注册通过后，要周期性地进行状态汇报并获取响应，状态报告及响应过程通APStatusRep操作完成。 在应用插件运行过程中，根据从MAS统一服务平台得到的业务能力信息，插件管理模块可以主动地发出命令，暂停或恢复特定的插件，这些指令经WebService方式通信适配插件通知给应用插件，通过PauseAP和RecoveryAP两个操作实现。 在应用插件结束之前，应用插件主动发起注销操作APLogOut。 考虑到一个应用插件可能包含多个进程，因此在上述流程中，注册、状态上报和注销为进程级，而暂停和恢复为插件级。 当插件管理模块发现插件进程异常或资源占用超过阀值时，并不停止该进程，而是提示告警给指定人员。 插件分为提