mas2.0_webservice插件接口开发手册2

《mas2.0_webservice插件接口开发手册2》由会员上传分享，免费在线阅读，更多相关内容在行业资料-天天文库。

1、中国移动代理服务器MASV2.0WebService插件接口开发手册中国移动代理服务器MASV2.0WebService接口插件开发手册2010年10月26中国移动代理服务器MASV2.0WebService插件接口开发手册目录1．引言11.1编写目的11.2相关术语与缩略语解释12．概述13．开发环境24．开发步骤24.1MAS服务器应用插件WebService插件参数建立24.2插件管理接口34.2.1接口说明34.2.2流程说明34.2.3数据类型4通讯能力CMAbility44.2.4接口定义64.3应用系统服务通知接口94.3.1接口说明94.3.2流程说明94

2、.3.3接口定义104.3.4短信接口114.3.5彩信接口174.3.5WAPPUSH短信接口2326中国移动代理服务器MASV2.0WebService插件接口开发手册1．引言本手册用于指导立通MAS2.0平台上的WebService插件开发。1.1编写目的本文档描述了MAS2.0基座WebService通信接口的使用方法，文档的使用对象为MAS开发人员、数字化部队、SI工程技术人员、SI开发人员、集团客户技术人员。注：本文档的读者需要有一定的WebService相关知识。1.2相关术语与缩略语解释缩写词英文解析中文解析MASMobileAgentServer移动代理

3、服务器HTTPHypertextTransferProtocol超文本传输协议HTTPSSecureHTTP加密的HTTP协议SOAPSimpleObjectAccessProtocol简单对象访问协议DBDatabaseDB服务接口2．概述WebService方式通信提供了对各种通信能力的统一封装，供集团客户应用系统和MAS服务器应用插件进行调用。同时，提供统一WebService方式封装也降低了si的开发难度，将繁杂的通信能力协议与具体的业务应用分离开来，对si呈现简单的标准接口。WebService方式通信适配插件接口封装了以下移动通信能力：l短信l彩信lWappu

4、sh此外，还提供基座与应用插件之间的插件管理功能接口。MAS服务器应提供配置工具，指定对于某个集团客户应用系统或应用插件，通过WebService方式通信适配插件或数据库方式通信适配插件接入MAS服务器。26中国移动代理服务器MASV2.0WebService插件接口开发手册3．开发环境lJDK：java6l应用服务器：Tomcat5.5l数据库版本：MySQL5.0.21lWebService工具：AXIS1.44．开发步骤插件在使用MAS服务器通信能力之前必须向MAS服务器注册，所以必须先在MAS服务器上建立应用插件的参数信息。4.1MAS服务器应用插件WebServ

5、ice插件参数建立1：运行MAS2.0服务器，登录到“系统管理”->“MAS配置管理”->“通讯适配插件管理”中进行WebService通讯能力设置。注：通讯能力依赖MAS服务器所拥有的能力而定，只要MAS服务器通过到MAS管理平台鉴权回来拥有短信、彩信、WapPush等能力，这里就可以进行设置。2：创建应用插件参数，进入“配置中心”->“应用插件管理”进行参数配置，如下图红色框部分，“通讯接口方式”必须选择“WebService”，可以根据插件功能需要选择开启某个应用能力。26中国移动代理服务器MASV2.0WebService插件接口开发手册WebServicedi地

6、址：http://10.2.93.251:80/services/cmcc_mas_wbs4.2插件管理接口4.2.1接口说明插件管理接口实现对应用插件的注册、注销、暂停和恢复，各插件通过此接口报告插件状态。插件管理具体内容包括：插件的注册、注销、启用、暂停插件状态报告。WebService方式通信适配插件作为基座插件管理模块的代理，实现插件管理相关操作信息的处理和转发。4.2.2流程说明插件注册流程说明：26中国移动代理服务器MASV2.0WebService插件接口开发手册MAS服务器系统中应用插件必须注册通过后方可使用，WebService方式通信适配插件将该请求转

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