- 1、本文档共28页,可阅读全部内容。
- 2、有哪些信誉好的足球投注网站(book118)网站文档一经付费(服务费),不意味着购买了该文档的版权,仅供个人/单位学习、研究之用,不得用于商业用途,未经授权,严禁复制、发行、汇编、翻译或者网络传播等,侵权必究。
- 3、本站所有内容均由合作方或网友上传,本站不对文档的完整性、权威性及其观点立场正确性做任何保证或承诺!文档内容仅供研究参考,付费前请自行鉴别。如您付费,意味着您自己接受本站规则且自行承担风险,本站不退款、不进行额外附加服务;查看《如何避免下载的几个坑》。如果您已付费下载过本站文档,您可以点击 这里二次下载。
- 4、如文档侵犯商业秘密、侵犯著作权、侵犯人身权等,请点击“版权申诉”(推荐),也可以打举报电话:400-050-0827(电话支持时间:9:00-18:30)。
查看更多
MAS2.0_WebService插件接口开发手册 2
中国移动代理服务器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。
考虑到一个应用插件可能包含多个进程,因此在上述流程中,注册、状态上报和注销为进程级,而暂停和恢复为插件级。
当插件管理模块发现插件进程异常或资源占用超过阀值时,并不停止该进程,而是提示告警给指定人员。
插件分为提
文档评论(0)