MAS应用件开发手册.docVIP

中国移动代理服务器(MAS) 应用插件 开发手册 V1.0 深圳市嘉讯软件有限公司 二○○八年四月  目 录 1 引言 1 1.1 编写目的 1 1.2 背景说明 1 1.3 缩略语和术语 1 1.4 约定 1 2 概述 2 3 应用插件开发说明 2 3.1 采用WebService方式通信适配插件开发应用插件 2 3.1.1 短消息接口 2 接口说明 2 流程说明 3 数据类型 4 接口定义 5 .1. 发送短消息 5 .2. 短消息通知 6 .3. 短消息接收 7 差错定义 7 服务策略 8 3.1.2 多媒体消息接口 8 接口说明 8 流程说明 9 数据类型 10 0 接口定义 11 0.1. 发送彩信 11 0.2. 接收彩信 12 0.3. 彩信通知 13 3.1.3 定位接口 14 1 接口说明 14 2 流程说明 14 3 数据类型 15 4 接口定义 17 4.1. 定位请求 17 4.2. 定位通知 20 5 差错定义 21 6 策略异常 22 7 服务策略 22 3.1.4 WAP PUSH接口 22 8 接口说明 22 9 流程说明 23 0 数据类型 23 1 接口定义 24 1.1. 发送PUSH消息 24 1.2. 获取PUSH发送状态 25 3.1.5 USSD业务接口 25 2 接口说明 25 3 流程说明 25 4 数据类型 26 5 接口定义 27 5.1. 连接建立 27 5.2. 信息交互 28 5.3. 连接终止 28 3.1.6 操作汇总 29 3.2 采用数据库方式通信适配插件开发应用插件 31 3.2.1 数据库表结构定义 31 短信数据库表结构 32 .1 短信待发送表（SMS_OUTBOX） 32 .2 短信已处理表(SMS_SENT) 33 .3 上行短信表(SMS_INBOX) 33 定位数据库表结构 34 .1 定位请求表(LBS_REQUEST) 34 .2 定位结果表（LBS_RESULT） 35 .3 周期定位取消表(LBS_CANCEL) 36 彩信数据库表结构 36 .1 彩信发送表(MMS_OUTBOX) 36 .2 彩信已处理(MMS_SENT) 37 .3 彩信接收表(MMS_INBOX) 38 WAPPUSH数据库表结构 38 .1 WAPPUSH待发送表（WAPPUSH_OUTBOX） 38 .2 WAPPUSH已处理表(WAPPUSH_SENT) 39 3.3 采用内部接口方式开发应用插件 40 3.3.1 MAS2开发运行环境 40 3.3.2 Step by Step 40 3.3.3 前台页面公用接口 41 js脚本 41 系统用户接口 41 通讯录接口 41 数据源接口 41 翻页控件类 42 3.3.4 通信接口 42 3.3.5 应用插件管理接口 43 3.3.6 应用插件开发发布说明 44 采用struts框架开发的页面 47 采用hibernate操作数据库 47 应用插件线程 47  引言 编写目的 本手册详细描述了中国移动代理服务器MAS应用插件开发原理及过程。用于指导利用中国移动代理服务器MAS所提供的插件管理接口实现客户的二次开发需要，满足客户基于短信、彩信、WAP、USSD、LBS等移动信息化的应用开发。 其阅读对象为需要采用中国移动代理服务器MAS完成客户应用插件开发的技术人员。 背景说明 本手册适用于产品“中国移动代理服务器MAS” V2.0版本。 缩略语和术语 缩写 英文名称 中文名称 MAS Mobile Agent Server 移动代理服务器 MMS Multimedia Messaging Service 多媒体短信服务 SMS Short Message Service 短消息业务 SI Service Integrator 服务集成商 约定 文件是以XML格式表达的。在本文档中以表格的形式表示XML格式；以下为表格中对元素约束（出现次数）的表示方法的描述： 元素的约束条件使用以下符号表示 符号 含义 ? 0..1，可选项* 0..n，可以没有，也可以有多项+ 1..n，至少有1项，也可以有多项1 数字1，代表必须且只能填1项WebService方式通信适配插件、数据库方式通信适配插件、API通信适配插件。 WebService方式通信适配插件、数据库方式通信适配插件、API通信适配插件为集团客户应用系统和MAS服务器中的应用插件提供统一的通信能力接口，同时实现应用系统和插件的移动化。 客户可以通过上述三类适配插件根据自身的业务需要开发应用插件。本文档将详细描述应用插件的开发方法。 应用插件开发说明 采