smgpAPI(JAVA).rar_doc_java SMGPApi_smgp_smgpapi_短消息

小灵通短信网关 API 开发手册

（SMGP 协议 JAVA 语言版）

目 录

1. 概述 ...........................................................................................................................................4

2. 安装说明 ...................................................................................................................................5

3. 配置说明 ...................................................................................................................................5

6. 附录 2 错误代码 ..................................................................................................................10

7. 附录 3 短消息格式表 ............................................................................................................12

8. 附录 4 短消息参数表 ............................................................................................................12

9. 附录 5 Demo 程序使用简介 ...............................................................................................12

SMGPActiveTest 检查短消息网关是否能够提供服务

SMGPDisconnect 从网关注销登录身份，中止相关线程

API 说明：

 InitSMGPAPI 只是读取配置文件初始化参数，不与网关建立连接；

 API 采用长连接的方式连接网关，并维护连接，断连后自动重连，用户不需关心；

 不同的接口实现模式（即配置文件中“ServiceMode”项配置）有不同的处理方式：

ServiceMode＝1：

 用户应用程序的收发采用公用的收发类型接口发送和接收消息，用户在第一次

调用发送或接收函数时，API 自动与网关连接，建立收发类型接口，登录网关

并保持连接，断连时自动重连；

后若连接中断，API 都会自动重连并保持连接

 这种方式下，若用户使用多个线程处理发送或接收，所有的接收都共用同一个

接收类型接口，所有的发送都共用同一个发送类型接口。

 用户调用 SMGPSendSingle、SMGPDeliver 函数时，若 API 发现还没有连接登录网关或

断连，API 将自动连接登录。

 SMGPActiveTest 只是检测系统连接状态，不触发登录网关的操作；

 SMGPDisconnect 从网关注销登录身份，断开连接；

 API 提供的所有数据结构体的各属性均提供 get、set 方法。