MAS2.0二次开发手册(总则)介绍.docVIP

MAS2.0二次开发手册 总 则 V1.1 嘉讯软件 2008-11 修订记录 ID 修订历史 修改人 日期 1 初稿V1.0 邓必国 2008-07-07 2 优化V1.1 邓必国 2008-11-24 目 录 1 3 2 引言 4 2.1 编写目的 4 2.2 应用范围 4 2.3 背景说明 4 2.4 相关术语与缩略语解释 4 3 概述 4 4 运行环境 5 5 三种通信扩展方式对比 5 6 MAS服务插件规范 5 6.1 企业应用与应用插件的区别 5 6.2 MAS“插件管理”模块使用 6 6.2.1 新建企业应用或应用插件 6 6.2.2 启动企业应用或应用插件 7 6.2.3 停止企业应用或应用插件 7 6.2.4 修改企业应用或应用插件 7 7 MAS业务管理鉴权介绍 8 8 插件管理接口 9 8.1 接口说明 9 8.2 接口说明 9 8.2.1 流程说明 9 8.2.2 数据定义 11 8.2.3 接口定义 11 8.3 插件管理范例 14 8.3.1 新建插件 15 8.3.2 确认MAS运行环境 15 8.3.3 MAS插件管理服务URL 16 8.3.4 准备代码 16 9 Web服务公共数据定义 18 9.1 命名空间 18 9.2 WEB服务调用方式 18 9.3 XML数据类型 18 9.4 XML Schema数据类型定义 19 9.4.1 TimeMetricsValues 19 9.4.2 TimeMetric 19 9.4.3 ServiceError 19 9.4.4 SimpleReference 19 9.4.5 CMAbility 20 9.4.6 MessageNotificationType 20 9.5 公共异常定义 20 9.5.1 业务异常 20 9.5.2 策略异常 22 9.6 AnyUri格式说明 24 10 接口开发指导 24 11 参考文档 24 引言 编写目的 本文档描述了MAS2.0二次开发的方法，文档的使用对象为MAS开发人员、数字化部队、SI工程技术人员、SI开发人员、集团客户技术人员。 应用范围 本文档的读者需要有一定的通信知识、WEB知识、移动业务、WebService相关知识。 背景说明 相关术语与缩略语解释 缩写词 英文解析 中文解析 MAS Mobile Agent Server 移动代理服务器 HTTP Hypertext Transfer Protocol 超文本传输协议 HTTPS Secure HTTP 加密的HTTP协议 SOAP Simple Object Access Protocol 简单对象访问协议 UCA Unified Communication Agent 统一通信代理 WS WebService Web服务接口 SMS Short Message Service 短消息服务 MMS Multimedia Messaging Service 彩信服务 概述 MAS服务器作为沟通集团客户IT应用环境与移动网络之间的桥梁，根据MAS服务器所处地位，可以将MAS服务器的应用分为三个层次。 作为集团客户应用系统的统一移动接入手段：为集团客户应用系统提供包括短信、彩信、USSD、WAP、WEB、定位等在内的统一通信能力。功能的侧重点是提供通信能力的支持。在这个层次，MAS作为统一移动接入能力提供者，不参与业务的核心逻辑； 实现集团客户应用的移动化 提供新业务：可以在MAS服务器上运行一个或多个应用模块来扩展MAS的业务能力。 本文主要描述上面第一个层次的扩充能力：如何对通信能力进行扩展。目前MAS服务器支持二次开发的通信能力有： 短信 彩信 wappush 此外，还提供MAS2.0与应用插件之间的插件管理功能接口。 支持的接口方式有： DB方式 WebService方式 内部API方式。 运行环境 MAS2.0运行环境 MAS管理平台环境（或模拟管理平台） 短信网关（或模拟网关） 彩信网关（或模拟网关） 三种通信扩展方式对比 DB接口：适应性强，任何语言都有操作数据库的能力。但运行效率一般，每次操作都要跟硬盘打交道。是移动规范接口。 WebService接口：开发容易，但在多语言交互时调试比较困难，运行效率比较低。是移动规范接口。 内部API：开发容易，运行效率高，接口丰富且扩展新接口也很方便，目前只支持JAVA语言。 性能 易用性 功能完善性 DB接口 一般 容易 一般 WebService接口 低 容