中国移动通信 CMPP2.0 短消息网关开发接口库使用手册(V2.51)
中国移动通信 CMPP2.0 短消息网
关开发接口库使用手册
1
中国移动通信 CMPP2.0 短消息网关开发接口库使用手册(V2.51)
软件作者:
PrinceToad
联系方式:
princetoad@zealware.com
最近更新:
V2.251 2004/07/4
作者主页:
Http://www.zealware.com
MSN:
princetoad2003@hotmail.com
OICQ:
50506711
电话:
010-13901168061
目 录
1 接口说明....................................................................................................................4
2 功能特点....................................................................................................................5
2.1 接口使用简单方便..........................................................................................5
2.2 模块稳定性强..................................................................................................5
2.3 消息收发和处理效率高..................................................................................5
2.4 网关兼容性强..................................................................................................5
2.5 真正实现了 scalable........................................................................................6
2.6 可以很方便地连接多个网关..........................................................................6
3 接口函数....................................................................................................................7
3.1 客户端类 CCmppClient...................................................................................7
3.2.1 Start........................................................................................................7
3.2.2 Release....................................................................................................8
3.2.3 Submit....................................................................................................9
3.2.4 Query......................................................................................................9
3.2.5 Cancel.....................................................................................................9
3.2.6 ActiveTest.............................................................................................10
3.2.7 GetSeqId...............................................................................................10
3.2.8 SetDoublePort......................................................................................10
3.2 服务端类 CCmppServer................................................................................11
3.2.1 Start.......................................................................................................11
3.2.2 Release..................................................................................................11
2
中国移动通信 CMPP2.0 短消息网关开发接口库使用手册(V2.51)
4 使用说明..................................................................................................................12
5 示例工程..................................................................................................................13
5.1 客户端例程....................................................................................................13
5.2 服务端例程....................................................................................................16
6 作者说明..................................................................................................................18
3
中国移动通信 CMPP2.0 短消息网关开发接口库使用手册(V2.51)
1 接口说明
本接口库使用 VC6.0 开发,采用面向对象的方法和消息触发的机制,适用
于所有的 WINDOWS 平台,本接口库在 CMPP2.0 接口库 V2.0 的基础上,进行了
全面升级,对 CMPP2.0 协议进行了高度封装,使用更方便,效率更高,性能更
加稳定。通过本接口提供的 CCmppClient 类可以很方便地接入移动网关,使 SP
可以省略通信模块的开发,专注于业务处理模块的开发,提高了生产效率;通过本
接口库提供的 CCmppServer 类则可以很方便地开发 CMPP2.0 网关程序,便于二
级 SP 的接入,或者作为中继器,成为分布式多个 SP 程序的统一网关入口。由于
本接口库严格遵照 CMPP2.0 标准协议实现,同时采用了非常灵活的实现方法,
程序内部自动适应各家网关(包括单连接,双连接,双端口等类型),实现了对各
家网关的全面兼容,真正做到了一套接口,连遍天下;一次编写,到处运行!
4
中国移动通信 CMPP2.0 短消息网关开发接口库使用手册(V2.51)
2 功能特点
2.1 接口使用简单方便
由于接口库对消息收发和处理进行了高度封装,系统启动后各模块在后台
自动运行,因此使用起来非常简单方便。只需要在程序开始时调用 Start 函数,
各 个 模 块 在 后 台 自 动 运 行 , 然 后 就 可 以 进 行 各 项 操 作 了 , 如
Submit,Query,Cancel 等 ; 消 息 接 收 也 在 后 台 自 动 进 行 , 收 到 消 息 后 触 发
OnSmgMsg 函数,所有对收到消息的操作都可以在 OnSmgMsg 中处理;内置链路
检测方法和自动重连机制,自动维持长连接;接口内部自动对 MO 消息进行回复,
自动对连接活动测试进行回复。
2.2 模块稳定性强
程序中所采用的主要技术和方法均为成熟稳定,久经考验的技术,在大量
系统中长期运用,经过了长时间的测试。
2.3 消息收发和处理效率高
采用消息收发分线程异步处理的方法,采用滑动窗口机制,大大提高了短
消息收发的速度;消息处理通过内建线程池进行,采用多事件多消息的方法,
可以对大量消息进行并行处理,大大提高了消息处理的速度,同时提高了短消
息平台的总体处理速度,但是在 OnSmgMsg 函数中对全局成员进行访问时需要加
锁,以免引起冲突。
2.4 网关兼容性强
本接口的正式版能够自动适应各家网关,实现了对各家网关的全面兼容,真
正做到了一套接口,连遍天下! 能够自动适应以下网关类型:标准 cmpp 类型(单
连接,如华为,思特奇,东软标准格式),双连接类型(MO,MT 分连接进行,通过
登录包的 Version 字段区分,如亚信(ASIA)),双端口类型(MO,MT 连接不同的网
5