ismp网关api开发手册(java)

《ismp网关api开发手册(java)》由会员上传分享，免费在线阅读，更多相关内容在行业资料-天天文库。

1、ISMP网关API开发手册（JAVA语言版）ISMP网关API开发手册（SMGP协议JAVA语言版）深圳协尔信息系统有限公司20XX．1223ISMP网关API开发手册（JAVA语言版）修改记录用于说明对文档加附页或文档版本升级时对文档的改动情况，一般设计类文档需要日期修改版本描述作者2003.81.0初稿编写曾宪志2004.8.61.0修改JDK的版本说明（由1.4改为1.3.1）和部分描述曾宪志2004.8.301.0配置参数“RequestTimeout”单位由“秒”改为“毫秒”；新增群发的接口”SMGPSendMulti”曾宪志23ISMP网关API开发手册（JAVA

2、语言版）目录1.概述42.安装说明53.配置说明54.数据结构定义64.1submitStruct64.2deliverStruct74.3deliverMsg85.API函数介绍85.1InitSMGPAPI823ISMP网关API开发手册（JAVA语言版）5.2SMGPSendSingle85.3SMGPSendMulti95.4SMGPDeliver95.5SMGPActiveTest105.6intSMGPDisconnect()106.附录1:FAQ117.附录2错误代码118.附录3短消息格式表129.附录4短消息参数表1310.附录5Demo程序使用简介1323

3、ISMP网关API开发手册（JAVA语言版）1.概述ISMP网关SMGPAPI针对SMGP协议开发，具有良好的性能和扩展性，是为ICP提供的方便的应用开发工具。本手册介绍JAVA语言版API，具体包括如下接口函数：InitSMGPAPI获取配置文件的配置参数，初始化API的配置SMGPSendSingle发送短信SMGPDeliver接收短信和状态报告SMGPActiveTest检查短消息网关是否能够提供服务SMGPDisconnect从网关注销登录身份，中止相关线程API说明：lInitSMGPAPI只是读取配置文件初始化参数，不与网关建立连接；lAPI采用长连接的方式连接

4、网关，并维护连接，断连后自动重连，用户不需关心；l不同的接口实现模式（即配置文件中“ServiceMode”项配置）有不同的处理方式：ServiceMode＝1：23ISMP网关API开发手册（JAVA语言版）u用户应用程序的收发采用公用的收发类型接口发送和接收消息，用户在第一次调用发送或接收函数时，API自动与网关连接，建立收发类型接口，登录网关并保持连接，断连时自动重连；u这种方式下，若用户使用多个线程处理发送或接收，则所有的发送和接收都是公用同一个收发类型接口ServiceMode＝2：u用户应用程序的收发会采用独立的接收类型接口和发送类型接口方式工作，当用户第一次调用

5、发送函数或接收函数时API自动与网关连接建立发送类型或接收类型的接口，登录网关并自动与网关握手保持连接。发送或接收接口建立后若连接中断，API都会自动重连并保持连接u这种方式下，若用户使用多个线程处理发送或接收，所有的接收都共用同一个接收类型接口，所有的发送都共用同一个发送类型接口。l用户调用SMGPSendSingle、SMGPDeliver函数时，若API发现还没有连接登录网关或断连，API将自动连接登录。lSMGPActiveTest只是检测系统连接状态，不触发登录网关的操作；lSMGPDisconnect从网关注销登录身份，断开连接；lAPI提供的所有数据结构体的各属

6、性均提供get、set方法。23ISMP网关API开发手册（JAVA语言版）1.安装说明1.API是基于JDK1.3.1运行开发，如果版本比这个低，有可能会产生运行时错误；2.将smgpApi.jar文件加入CLASSPATH；3.在调用的API的class中导入：“importcom.ut.smgp.api.*”“importcom.ut.smgp.api.structure.*”2.配置说明API开发包采用配置文件smgpc.ini需要配置，以下是配置文件配置项的说明：名称说明CpIdCP编号，必须与License的一致。CpShareKeyCP的密码，如果填写不正确会导

7、致应用程序不能通过SMGP用户认证。ServiceMode23ISMP网关API开发手册（JAVA语言版）取值1为“收发公用收发类型接口”，取值2为“收发分别用独立的接收接口和发送接口”ClientIP客户主机的IP地址，必须填写接入Internet的公网地址。如果主机是通过Gateway接入Internet，就填写Gateway地址。此项配置填写错误会导致应用程序不能通过网关对CP的IP地址校验。SubmitRetry发送短消息自动重试次数（1表示只发送1次，0不重新发送）RequestTimeout