电信SMGP协议开发包源码

JAVA 源码请勿再次复制，否则追究法律责任！

深讯信科

行业短信网关 EP 端应用程序 API(smgp3.03 版)使用说明

1. 文档说明

本文档适用于 EP 接入深讯网关 Smgp 接口，对 API(Java)中函数调用的说明。

2. 配置说明

2.1 配置

用户调用接口的时候，将.jar、log4j.properties 引入到类路径，同时注意将 lib 目录下

3.1 与网关建立连接函数

int SMGP_Connect(String host, int port, String spid, String password)

返回值：

ERROR_SOCKET_CREATE socket 创建失败

ERROR_CONNECT socket 连接失败

ERROR_SOCKET_WRITE socket 写失败

ERROR_SOCKET_READ socket 读失败

ERROR_RSP_TIMEOUT 网关超时应答

ERROR_CONNECT_MOD 链接登陆方式错

>0 socket 操作成功的 socket 号

JAVA 源码请勿再次复制，否则追究法律责任！

深讯信科

int SMGP_Submit(int socketId, TSMGP_SUBMIT smgpsubmit, TSMGP_RESP resp)

返回值：

ERROR_SOCKET_WRITE socket 写失败

ERROR_SOCKET_READ socket 读失败

ERROR_RSP_TIMEOUT 网关超时应答

ERROR_OK socket success

函数参数：

param1: socket 号，是 SMGP_connect 函数的返回值；

param2: 用 户 填 写 需 要 发 送 TSMGP_SUBMIT 包 ； （ 具 体 格 式 参 考 头 文 件 ）

TSMGP_SUBMIT 中可包含 TSMGP_TLV 包

ERROR_SOCKET_WRITE socket 写失败

ERROR_SOCKET_READ socket 读失败

0 得到 MO 消息

1 得到状态报告

2 无消息返回

3 返回非 CMPP_DELIVER 消息

函数参数：

param1: socket 号，由 SGIP_Connect 函数返回.

param2: 返回 DELIVER 消息包。

3.4 断开与网关的连接

JAVA 源码请勿再次复制，否则追究法律责任！

深讯信科

如 MT 和 MO 链接都建立则需都建立链路测试包

int SMGPActiveTest(int socketId) throws IOException

返回值：

0 成功

小于 0 失败，失败后会主动关闭 Socket 套接字。

函数参数

param1: socket 号，由 SMGP_connect 函数返回.

4. 实体类说明

4.1 TSMGP_SUBMIT

public static final Log log =

LogFactory.getLog(TSMGP_SUBMIT.class);

public byte cMsgType; // 1.3: 短消息子类型（0＝取消订阅，1＝

订阅请求，2＝点播，3＝订阅） 1

// 2.0: 短消息类型（1=取消订阅，2=订

阅请求，3=点播，4=订阅，5=交互式操作，6=查询，7=点对点消息，8=电子商务，9=代码方

式）

public String sServiceID; // 服务类型 13

public String sFeeType; // 资费类型 15

// 1.3: （00：免费，01：按条收费，

02：包月，03：封顶）

// 2.0: （0：包月，1：按条，2：流量）

// 3.0: （00：免费，01：按条收费，

02：包月，03：封顶）

public String sFeeCode; // 资费代码(分) 21

public String sFixedFee; // 包月费(封顶费)071051(单位为分)

JAVA 源码请勿再次复制，否则追究法律责任！

深讯信科

27

public String sDestTermID; // 短消息接收号码(连续存储

DestTermIDCoutn个)

public byte ucMsgLength; // 短消息长度

public String sMsgContent; // 短消息内容

public String sReserve; // 保留

public TSMGP_TLV tsmgpTlv=new TSMGP_TLV(); //TLV 扩展包

4.2 TSMGP_DELIVER

public String sMsgID; // 短消息标识

public byte cIsReport; // 是否状态报告(0：不是 1：

是)

public byte ucMsgLength; // 短消息长度

public String sMsgContent; // 短消息内容

public String sReserve; // 保留

public String sIsmgMsgID; // 短消息标识

public TSMGP_TLV tsmgpTlv=new TSMGP_TLV(); //TLV 扩展包

4.3 TSMGP_TLV

public byte cPid; //PID

public boolean b_cPid=false; //cPid是

否使用

public byte cUdhi; //UDHI