SGIP Java 长短信实现指南

目录

  1. 介绍
  2. 流程
  3. 代码实现

1. 介绍

本文将指导你如何使用 Java 实现 SGIP 协议发送长短信。SGIP（Short Message Gateway Protocol）是一种通信协议，用于在短信网关和SP之间进行短信传输。

2. 流程

流程图如下所示：

步骤 描述
步骤1 连接到网关
步骤2 发送Bind请求
步骤3 接收Bind响应
步骤4 发送Submit请求
步骤5 接收Submit响应
步骤6 发送Report请求
步骤7 接收Report响应
步骤8 断开与网关的连接

3. 代码实现

步骤1：连接到网关

import sgip.SGIPConnection;

SGIPConnection connection = new SGIPConnection();
connection.connect("网关地址", 端口号);

此代码段创建一个 SGIPConnection 类的实例，并使用 connect 方法连接到 SGIP 网关。将 "网关地址" 替换为实际的网关地址，将 端口号 替换为实际的端口号。

步骤2：发送Bind请求

import sgip.SGIPBindRequest;

SGIPBindRequest bindRequest = new SGIPBindRequest();
bindRequest.setLoginName("登录名");
bindRequest.setLoginPassword("登录密码");
bindRequest.setServiceId("服务ID");
bindRequest.setVersion(3);

connection.sendRequest(bindRequest);

此代码段创建一个 SGIPBindRequest 类的实例，并设置登录名、登录密码、服务ID和版本号。然后，使用 sendRequest 方法将请求发送到网关。

步骤3：接收Bind响应

import sgip.SGIPBindResponse;

SGIPBindResponse bindResponse = (SGIPBindResponse) connection.receiveResponse();
int result = bindResponse.getResult();
if (result == SGIPBindResponse.RESULT_SUCCESS) {
    // 绑定成功
} else {
    // 绑定失败
}

此代码段使用 receiveResponse 方法接收来自网关的绑定响应。然后，根据响应结果判断绑定是否成功。

步骤4：发送Submit请求

import sgip.SGIPSubmitRequest;
import sgip.SGIPMessage;

SGIPSubmitRequest submitRequest = new SGIPSubmitRequest();
submitRequest.setSpNumber("SP号码");
submitRequest.setUserNumber("用户号码");
submitRequest.setMessageContent("短信内容");
submitRequest.setMessageType(8);

// 判断短信内容是否过长，如果是，则分割成多个长短信
if (submitRequest.getMessageContent().length() > 70) {
    List<SGIPMessage> messageList = SGIPMessage.splitLongMessage(submitRequest);
    for (SGIPMessage message : messageList) {
        connection.sendRequest(message);
    }
} else {
    connection.sendRequest(submitRequest);
}

此代码段创建一个 SGIPSubmitRequest 类的实例，并设置 SP 号码、用户号码、短信内容和短信类型。如果短信内容超过70个字符，则将其分割成多个长短信，并使用 sendRequest 方法将每个长短信发送到网关。

步骤5：接收Submit响应

import sgip.SGIPSubmitResponse;

SGIPSubmitResponse submitResponse = (SGIPSubmitResponse) connection.receiveResponse();
int result = submitResponse.getResult();
if (result == SGIPSubmitResponse.RESULT_SUCCESS) {
    // 发送成功
} else {
    // 发送失败
}

此代码段使用 receiveResponse 方法接收来自网关的提交响应。然后，根据响应结果判断短信是否发送成功。

步骤6：发送Report请求

import sgip.SGIPReportRequest;

SGIPReportRequest reportRequest = new SGIPReportRequest();
reportRequest.setSubmitSequenceNumber(submitRequest.getSequenceNumber().getValue());

connection.sendRequest(reportRequest);

此代码段创建一个 SGIPReportRequest 类的实例，并设置 Submit Sequence Number。然后，使用 sendRequest 方法将请求发送