欢迎来到天天文库
浏览记录
ID:8497093
大小:117.00 KB
页数:12页
时间:2018-03-29
《交换平台产品手册》由会员上传分享,免费在线阅读,更多相关内容在应用文档-天天文库。
1、小灵通短信网关API开发手册(JAVA语言版)小灵通短信网关API开发手册(SMGP协议JAVA语言版)UT公司2003.812小灵通短信网关API开发手册(JAVA语言版)修改记录用于说明对文档加附页或文档版本升级时对文档的改动情况,一般设计类文档需要日期修改版本描述作者2003.81.0初稿编写曾宪志12小灵通短信网关API开发手册(JAVA语言版)目录1.概述42.安装说明53.配置说明54.数据结构定义64.1Submit消息体(submitStruct)64.2SubmitResponse消息体(submitRespStr
2、uct)74.3Deliver消息体(deliverStruct)74.4DeliverResponse(deliverRespStruct)85.API函数介绍85.1InitSMGPAPI85.2SMGPSendSingle95.3SMGPDeliver95.4SMGPActiveTest95.5intSMGPDisconnect()106.附录2错误代码107.附录3短消息格式表128.附录4短消息参数表129.附录5Demo程序使用简介1212小灵通短信网关API开发手册(JAVA语言版)1.概述小灵通短消息网关SMGPAP
3、I针对SMGP协议开发,具有良好的性能和扩展性,是为ICP提供的方便的应用开发工具。本手册介绍JAVA语言版API,具体包括如下接口函数:InitSMGPAPI获取配置文件的配置参数,初始化API的配置SMGPSendSingle发送短信SMGPDeliver接收短信和状态报告SMGPActiveTest检查短消息网关是否能够提供服务SMGPDisconnect从网关注销登录身份,中止相关线程API说明:lInitSMGPAPI只是读取配置文件初始化参数,不与网关建立连接;lAPI采用长连接的方式连接网关,并维护连接,断连后自动重连
4、,用户不需关心;l不同的接口实现模式(即配置文件中“ServiceMode”项配置)有不同的处理方式:ServiceMode=1:u用户应用程序的收发采用公用的收发类型接口发送和接收消息,用户在第一次调用发送或接收函数时,API自动与网关连接,建立收发类型接口,登录网关并保持连接,断连时自动重连;u这种方式下,若用户使用多个线程处理发送或接收,则所有的发送和接收都是公用同一个收发类型接口ServiceMode=2:u用户应用程序的收发会采用独立的接收类型接口和发送类型接口方式工作,当用户第一次调用发送函数或接收函数时API自动与网关
5、连接建立发送类型或接收类型的接口,登录网关并自动与网关握手保持连接。发送或接收接口建立后若连接中断,API都会自动重连并保持连接u这种方式下,若用户使用多个线程处理发送或接收,所有的接收都共用同一个接收类型接口,所有的发送都共用同一个发送类型接口。l用户调用SMGPSendSingle、SMGPDeliver函数时,若API发现还没有连接登录网关或断连,API将自动连接登录。lSMGPActiveTest只是检测系统连接状态,不触发登录网关的操作;lSMGPDisconnect从网关注销登录身份,断开连接;lAPI提供的所有数据结构
6、体的各属性均提供get、set方法。12小灵通短信网关API开发手册(JAVA语言版)1.安装说明1.API是基于JDK1.4运行开发;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用户认证。ServiceMode取值1为“收发公用收发类型接口”,取值2为“收发分别用独立的接收接口和发送接口”ClientIP客户主机的IP地址,必须填写接入Internet的公网地址。如果主机是通过Gateway接入Internet,就填写Gateway地址。此项配置填写错误会导致应用程序不能通过网关对CP的IP地址校验。SubmitRetry发送短消息自动重试次数(1表示只发送1次,0不重新发送)RequestTimeout发送请求超时时间,单位:秒ActiveTestCycle握手间隔时间,
8、单位毫秒ActiveTestRetryactivetest的重试次数,若重复多次没能连接,则重新建立通讯端口。ServerIP短消息网关的IP地址ServerPort短消息网关的端口12小灵通短信网关API开发手册(JAVA语言版)1
此文档下载收益归作者所有