中国移动代理服务器MAS V2.0
DB接口插件
开发手册
深圳市嘉讯软件有限公司
2008年11月
1.引言 (4)
1.1.编写目的 (4)
1.2.相关术语与缩略语解释 (4)
2. 概述 (4)
3. 运行环境 (4)
4. 开发步骤 (4)
4.1. 在Mas服务器新建一个企业应用 (4)
4.2.打开DB插件开关 (5)
4.3.接口开发及使用举例 (6)
4.3.1. 短信接口 (6)
4.3.1.1. 发送短信操作 (6)
4.3.1.1.1. 开发代码举例 (6)
4.3.1.2. 获取状态报告操作 (6)
4.3.1.2.1. 开发代码举例 (6)
4.3.1.3. 获取短信MO操作 (6)
4.3.1.3.1. 开发代码举例 (6)
4.3.2. 彩信接口 (7)
4.3.2.1. 发送彩信操作 (7)
4.3.2.1.1. 发送彩信开发代码举例 (7)
4.3.2.2. 获取彩信状态报告操作 (7)
4.3.2.2.1. 开发代码举例 (7)
4.3.2.3. 获取彩信MO操作 (7)
4.3.2.3.1. 开发代码举例 (7)
4.3.3. Wappush短信接口 (7)
4.3.3.1. 发送Wappush短信操作说明 (7)
4.3.3.1.1. 开发代码举例 (7)
4.3.3.2. 获取wappush短信状态报告操作 (8)
4.3.3.2.1. 开发代码举例 (8)
5. 接口描述 (8)
5.1.短信接口描述 (8)
5.1.1. 接口说明 (8)
5.1.2. 流程说明 (8)
5.2. 彩信接口描述 (9)
5.2.1. 接口说明 (9)
5.2.2. 流程说明 (9)
5.3. Wappush短信接口描述 (9)
5.3.1. 接口说明 (9)
5.3.2. 流程说明 (9)
6. 数据库及相关表定义 (10)
6.1.短信数据库表结构 (10)
6.1.1. 短信相关表说明 (10)
6.1.2. 短信数据表ER图 (10)
6.1.3. 短信待发送表（SMS_OUTBOX） (10)
6.1.4. 短信已处理表(SMS_SENT) (11)
6.1.5. 上行短信表(SMS_INBOX) (12)
6.2.彩信数据库表结构 (13)
6.2.1. 彩信相关表说明 (13)
6.2.2. 彩信数据表ER图 (13)
6.2.3. 彩信发送表(MMS_OUTBOX) (13)
6.2.4. 彩信已处理表(MMS_SENT) (14)
6.2.5. 彩信接收表(MMS_INBOX) (15)
6.3.WAPPUSH数据库表结构 (15)
6.3.1. WAPPUSH相关表说明 (15)
6.3.2. WAPPUSH表ER图 (15)
6.3.3. WAPPUSH待发送表（W APPUSH_OUTBOX） (15)
6.3.4. WAPPUSH已处理表(WAPPUSH_SENT) (16)
7. 彩信多媒体消息内容格式定义说明 (17)
7.1. 彩信多媒体内容类型 (17)
7.2. 彩信多媒体内容加密 (17)
7.3. 彩信多媒体内容编码 (17)
7.4. 彩信多媒体内容编码 (17)
7.5. 彩信多媒体消息内容示例 (17)
7.6. 彩信多媒体消息具体加密前后内容示例 (18)
8. 参考文档 (19)
1.引言
1.1.编写目的
本文档描述了MAS2.0 DB通信接口的使用方法，文档的使用对象为MAS开发人员、数字化部队、SI工程技术人员、SI开发人员、集团客户技术人员。
1.2.相关术语与缩略语解释
2.概述
数据库方式通信适配插件为MAS服务器内部各模块和插件以及集团客户应用之间提供统一格式的接口，用于实现通信请求及响应。并将繁杂的通信能力协议与具体的业务应用分离开来。
DB方式通信适配插件接口封装了以下移动通信能力：
●短信
●彩信
●wappush
通过本文档的学习，将获知如何进行DB插件的开发。
3.运行环境
●MAS2.0基座运行环境
●MAS管理平台环境
●DB适配插件开关打开
4.开发步骤
4.1.在Mas服务器新建一个企业应用
在MAS2.0插件管理平台中新增一个DB插件，如图：
注意：新建时“通信接口方式”选择“Database”。
新建成功后，在插件列表页面显示如下图：
要新建的插件DB接口可用，需要点击“开关”列的运行按钮。否则在使用DB接口通信时可能会报POL0906错误。
4.2.打开DB插件开关
在系统管理->配置管理->参数设置->DB接口一栏中，将DB接口所需要的服务能力启动。如下图：
数据库用户名：请输入DB数据库用户名。
数据库密码：请输入DB数据库密码。
4.3.接口开发及使用举例
4.3.1.短信接口
4.3.1.1.发送短信操作
发送短信是由DB插件发起，向DB插件数据库dbadapter中的等待发送表sms_outbox表中插件要发送的相关记录。
4.3.1.1.1.开发代码举例
例如：新建一个DB插件，插件标识为“333”,发送短信代码实现如下：
4.3.1.2.获取状态报告操作
4.3.1.2.1.开发代码举例
获取状态报告代码实现如下：
4.3.1.3.获取短信MO操作
4.3.1.3.1.开发代码举例
获取短信MO代码实现如下：
4.3.2.彩信接口
4.3.2.1.发送彩信操作
发送彩信是由DB插件发起，向DB插件数据库dbadapter中的等待发送表mms_outbox表中插件要发送的相关记录。
4.3.2.1.1.发送彩信开发代码举例
输入：代码实现如下：
注：’?’彩信内容很长，是标准彩信文件格式的Base64encode，具体请参考本手册中第7节彩信多媒体消息内容格式定义说明。
4.3.2.2.获取彩信状态报告操作
4.3.2.2.1.开发代码举例
输入：代码实现如下：
4.3.2.3.获取彩信MO操作
4.3.2.3.1.开发代码举例
输入：代码实现如下：
4.3.3.Wappush短信接口
4.3.3.1.发送Wappush短信操作说明
发送Wappush短信是由DB插件发起，向DB插件数据库dbadapter中的等待发送表wappush _outbox表中插件要发送的相关记录。
4.3.3.1.1.开发代码举例
输入：代码实现如下：
4.3.3.2.获取wappush短信状态报告操作
4.3.3.2.1.开发代码举例
5.接口描述
5.1.短信接口描述
5.1.1.接口说明
集团客户应用系统和应用插件通过此接口收发短消息。DB方式通信适配插件收到应用插件的发送请求后，通过MAS服务器基座中的SMS通信协议模块发送SMS；当从SMS通信协议模块收到SMS后，通过此接口将短消息发送给集团客户应用系统和应用插件。5.1.2.流程说明
DB适配插件的短信发送以及接收过程说明：
●MAS启动
●DB插件往DB插件数据库dbadapter中的等待发送表sms_outbox表插入要发
送的相关数据
●MAS从待发送表（sms_outbox）获取该内容并将该记录删除，马上写入已发
送记录表（sms_sent），同时将短信发送出去
●当短信的发送报告回来后，更新已发送记录表（sms_sent）的状态
●获取报告并在处理后删除所获取的记录
●MAS获取MO后，写入短信接收表（sms_inbox）
●DB插件读取短信接收表（sms_inbox），并在处理后删除所获取的记录
5.2.彩信接口描述
5.2.1.接口说明
应用系统或应用插件调用发送接口给目的用户发送一条彩信。通信适配插件采用非同步的通知机制将彩信提交状态通知给应用系统或应用插件。对于彩信接收，可以由通信适配插件主动通知应用系统或应用插件有彩信到达，应用系统或应用插件也可通过接口从通信适配插件接收彩信。
5.2.2.流程说明
DB适配插件的彩信发送以及接收过程说明：
●MAS启动
●DB插件往DB插件数据库dbadapter中的等待发送表（mms_outbox）插入要
发送的相关数据
●MAS从待发送表（mms_outbox）获取该内容并将该记录删除，马上写入已发
送记录表（mms_sent），同时将彩信发送出去
●当彩信的发送报告回来后，更新已发送记录表（mms_sent）的状态
●获取报告并在处理后删除所获取的记录
●MAS获取MO后，写入彩信接收表（mms_inbox）
●DB插件读取彩信接收表（mms_inbox），并在处理后删除所获取的记录
5.3.W appush短信接口描述
5.3.1.接口说明
应用系统或应用插件通过此接口发送W AP PUSH并获取PUSH发送状态。
5.3.2.流程说明
DB适配插件发送W APPush
●MAS启动
●DB插件往DB插件数据库dbadapter中的待发送表(wappush_outbox)插入要发
送的相关数据
●MAS从待发送表（wappush_outbox）获取该内容并将该记录删除，马上写入
已发送记录表（wappush _sent），同时将短信发送出去
●当短信的发送报告回来后，更新已发送记录表（wappush _sent）的状态
●获取报告并在处理后删除所获取的记录
6.数据库及相关表定义
DB插件数据库名为：dbadapter
DB插件数据库编码格式为：utf8
6.1.短信数据库表结构
6.1.1.短信相关表说明
短信发送表：sms_outbox
短信已处理表：sms_sent
上行短信表：sms_inbox
6.1.2.短信数据表ER图
6.1.3.短信待发送表（SMS_OUTBOX）
适配插件读取相关数据后，自行删除该记录，并转存储到SMS_SENT内。
6.1.4.短信已处理表(SMS_SENT)
6.1.5.上行短信表(SMS_INBOX)
EC 应用/SI 应用插件可SELECT ，可DELETE ，不可INSERT 和UPDA TE ；要求EC 应用/SI 应用插件定期5天内清理，数据库方式适配插件定期7天内清理此表。
6.2. 彩信数据库表结构
6.2.1.
彩信相关表说明
彩信发送表：mms_outbox 彩信已处理表：mms_sent 彩信接收表：mms _inbox
6.2.2. 彩信数据表ER 图
6.2.3.
彩信发送表(MMS_OUTBOX)
EC 应用/SI 应用插件仅有插入的权限，无读取权限，插入彩信也无法取消；数据库方式适配插件读取相关数据后，自行删除该记录，并转存储到MMS_SENT 内。
6.2.4.
彩信已处理表(MMS_SENT)
EC 应用/SI 应用插件可SELECT ，可DELETE ，不可INSERT 和UPDA TE ；要求EC 应用/SI 应用插件定期5天内清理，数据库方式适配插件定期7天内清理此表。
6.2.5.彩信接收表(MMS_INBOX) Array EC应用/SI应用插件可SELECT，可DELETE，不可INSERT和UPDA TE；要求EC应用/SI应用插件定期5天内清理，数据库方式适配插件定期7天内清理此表。
6.3.WAPPUSH数据库表结构
6.3.1.WAPPUSH相关表说明
WAPPUSH待发送表：wappush _outbox
WAPPUSH已处理表：wappush_sent
6.3.2. WAPPUSH表ER图
6.3.3.WAPPUSH待发送表（WAPPUSH_OUTBOX）
6.3.4.WAPPUSH已处理表(WAPPUSH_SENT)
EC 应用/SI 应用插件可SELECT ，可DELETE ，不可INSERT 和UPDA TE ；要求EC 应用/SI 应用插件定期5天内清理，数据库方式适配插件定期7天内清理此表。
7. 彩信多媒体消息内容格式定义说明
7.1. 彩信多媒体内容类型
mas 提供的各种彩信发送接口，彩信内容（content ）一项均是字符串类型。
7.2. 彩信多媒体内容加密
彩信多媒体消内容必须经是过BASE64的字符串。
7.3. 彩信多媒体内容编码
彩信多媒体消内容文本附件内容必须采用utf-8编码。
7.4. 彩信多媒体内容编码
text/plain, text/xml, application/smil, audio/amr, audio/midi, text/i-melody,
text/e-melody,image/gif, image/jpeg, image/vnd.wap.wbm, image/png
7.5. 彩信多媒体消息内容示例
gif附件内容……
--SubPart_7452684322002_77645
Content-Type:text/plain;charset=UTF-8
Content-Transfer-Encoding:8bit
Content-ID:200808151030000231.txt
Content-Location:200808151030000231.txt
文本附件内容……
--SubPart_7452684322002_77645--
----NextPart_0_2817_24856—
示例内容说明，内容中可以存在多个附件，每个附件前必须“--SubPart_7452684322002_77645
”开始，最后一个附件后加--SubPart_7452684322002_77645--
----NextPart_0_2817_24856—
附件内容属性说明
Content-Type 附件类型
Content-Transfer-Encoding 附件编码位数，默认采用8位编码
Content-ID 附件名称
Content-Location 附件名称
7.6.彩信多媒体消息具体加密前后内容示例
加密前：
--SubPart_7452684322002_77645
Content-Type:application/smil
Content-Transfer-Encoding:8bit
Content-ID:20080815114700048.smil
Content-Location:20080815114700048.smil
height="100%" /> fit="scroll"/> fit="scroll"/> fit="fill"/> fit="fill"/> /> region="all" />
--SubPart_7452684322002_77645
Content-Type:text/plain;charset=UTF-8
Content-Transfer-Encoding:8bit
Content-ID:200808151147000481.txt
Content-Location:200808151147000481.txt
HELLO MMS!
--SubPart_7452684322002_77645--
----NextPart_0_2817_24856—
加密后：
LS1TdWJQYXJ0Xzc0NTI2ODQzMjIwMDJfNzc2NDUNCkNvbnRlbnQtVHlwZTphc
HBsaWNhdGlvbi9zbWlsDQpDb250ZW50LVRyYW5zZmVyLUVuY29kaW5nOjhiaX
QNCkNvbnRlbnQtSUQ6MjAwODA4MTUxMTQ3MDAwNDguc21pbA0KQ29udGVu
dC1Mb2NhdGlvbjoyMDA4MDgxNTExNDcwMDA0OC5zbWlsDQoNCjxzbWlsPjxoZ
WFkPjxtZXRhIG5hbWU9InRpdGxlIiBjb250ZW50PSIiLz48bGF5b3V0Pjxyb290LWxh
eW91dCB3aWR0aD0iMTAwJSIgaGVpZ2h0PSIxMDAlIiAgLz48cmVnaW9uIGlkPSJ0
eHRfdG9wIiB3aWR0aD0iMTAwJSIgaGVpZ2h0PSIxNiUiIGxlZnQ9IjAiIHRvcD0iMC
IgZml0PSJzY3JvbGwiLz48cmVnaW9uIGlkPSJ0eHRfYnV0dG9uIiB3aWR0aD0iMTA
wJSIgaGVpZ2h0PSIxNiUiIGxlZnQ9IjAiIHRvcD0iODQlIiBmaXQ9InNjcm9sbCIvPjx
yZWdpb24gaWQ9ImltZ190b3AiIHdpZHRoPSIxMDAlIiBoZWlnaHQ9Ijg0JSIgbGVm
dD0iMCIgdG9wPSIwIiBmaXQ9ImZpbGwiLz48cmVnaW9uIGlkPSJpbWdfYnV0dG9
uIiB3aWR0aD0iMTAwJSIgaGVpZ2h0PSI4NCUiIGxlZnQ9IjAiIHRvcD0iMTYlIiBma
XQ9ImZpbGwiLz48cmVnaW9uIGlkPSJhbGwiIHdpZHRoPSIxMDAlIiBoZWlnaHQ9Ij
EwMCUiIGxlZnQ9IjAiIHRvcD0iMCIgZml0PSJmaWxsIiAvPjwvbGF5b3V0PjwvaGV
hZD48Ym9keT48cGFyIGR1cj0iMTAwMDBtcyI+PHRleHQgc3JjPSIyMDA4MDgxNT
ExNDcwMDA0ODEudHh0IiByZWdpb249ImFsbCIgLz48L3Bhcj48L2JvZHk+PC9zb
WlsPg0KDQoNCi0tU3ViUGFydF83NDUyNjg0MzIyMDAyXzc3NjQ1DQpDb250ZW
50LVR5cGU6dGV4dC9wbGFpbjtjaGFyc2V0PVVURi04DQpDb250ZW50LVRyYW5z
ZmVyLUVuY29kaW5nOjhiaXQNCkNvbnRlbnQtSUQ6MjAwODA4MTUxMTQ3MD
AwNDgxLnR4dA0KQ29udGVudC1Mb2NhdGlvbjoyMDA4MDgxNTExNDcwMDA0
ODEudHh0DQoNCkhFTExPIE1NUyENCg0KDQotLVN1YlBhcnRfNzQ1MjY4NDMy
MjAwMl83NzY0NS0tDQotLS0tTmV4dFBhcnRfMF8yODE3XzI0ODU2LS0NCg==
8.参考文档
<<中国移动移动代理服务器（MAS）系统接口规范2.0.doc>>
<< MAS2.0安装手册.doc>>
<< MAS2.0二次开发手册(总则).doc>>