java實現發短信功能---騰訊雲短信

目錄

• java實現發短信功能
  • 前言
  • 開發環境
  • 騰訊雲 ---短信
  • 代碼
  • 效果
  • 結束語

java實現發短信功能

前言

現在發短信功能已經成爲互聯網公司的標配，本篇文章將一步步實現java發送短信

考察了許多提供短信服務的三方，幾乎全部都須要企業認證纔可使用，這對於我的學習很是不方便。多方比較以後，選擇了騰訊雲(此處並不是作廣告)，緣由有兩點：

1. 支持微信公衆號認證(門檻低)
2. 每個月贈送100條免費短信(適合我的學習)(這一點請礦家子弟自行忽略)

開發環境

請參照: 基於SpringBoot構建分模塊項目

騰訊雲 ---短信

1. 找到短信服務

2. 開通以後，點擊添加應用

3. 設置短信簽名(以公衆號爲例)，簽名類型選擇公衆號或小程序，其他按照要求填寫便可

4. 簽名完成以後，建立短信模板

5. 等待以上信息審覈完成以後，即可以開始使用了，騰訊短信服務須要用到SDK AppID 和App Key ，在這裏:

代碼

1. pom.xml引入依賴

   <properties>
       <java.version>1.8</java.version>
       <!-- 你的其餘依賴。。。 -->
       <tencent.qcloudsms.version>1.0.6</tencent.qcloudsms.version>
   </properties>
   
   <dependencies>
       <!-- 你的其餘依賴。。。 -->
       <!-- 騰訊短信 -->
       <dependency>
           <groupId>com.github.qcloudsms</groupId>
           <artifactId>qcloudsms</artifactId>
           <version>${tencent.qcloudsms.version}</version>
       </dependency>
   </dependencies>

2. 發送短信工具類

   package com.wayne.common.utils;
   
   import com.github.qcloudsms.*;
   import com.github.qcloudsms.httpclient.HTTPException;
   import com.wayne.common.entity.CmsMessageConfig;
   import com.wayne.common.exception.CustomException;
   import com.wayne.common.form.MessageForm;
   import org.json.JSONException;
   
   import java.io.IOException;
   
   /**
    * 發送短信工具類
    * @author Wayne
    * @date 2019/6/26
    */
   public class MessageUtils {
   
       /**
        * 按模板發送短信 支持單發和羣發
        * @param isSingle 是否單發 true: 單發，false: 羣發
        * @param form 須要發送的短信內容及收信人手機號
        * @param config 短信配置
        * @throws CustomException 發送失敗時捕獲的異常信息
        */
       public static void sendMessage(Boolean isSingle, MessageForm form, CmsMessageConfig config) throws CustomException {
           validateMessage(form, config);
           String regex = ";";
           String[] params = {form.getCaptcha()};
           String[] phoneNumbers = form.getMobiles().split(regex);
   
           SmsResultBase result;
   
           try {
               // 是否單發
               if (isSingle) {
                   SmsSingleSender ssender = new SmsSingleSender(config.getAppId(), config.getAppKey());
                   result = ssender.sendWithParam("86", phoneNumbers[0], config.getTemplateId(), params, config.getSmsSign(), "", "");
               } else {
                   SmsMultiSender msender = new SmsMultiSender(config.getAppId(), config.getAppKey());
                   result =  msender.sendWithParam("86", phoneNumbers, config.getTemplateId(), params, config.getSmsSign(), "", "");
               }
               System.out.println(result);
           } catch (HTTPException e) {
               e.printStackTrace();
               throw new CustomException("HTTP響應碼錯誤");
           } catch (JSONException e) {
               e.printStackTrace();
               throw new CustomException("json解析錯誤");
           } catch (IOException e) {
               e.printStackTrace();
               throw new CustomException("網絡IO錯誤");
           }
       }
   
       /**
        * 校驗參數
        */
       private static void validateMessage(MessageForm messageForm, CmsMessageConfig messageConfig) throws CustomException {
           ValidatorUtils.validateEntity(messageForm);
           if (null == messageConfig) {
               throw new CustomException("系統參數異常");
           }
       }
   }

3. CmsMessageConfig配置類

   package com.wayne.common.entity;
   
      import lombok.Data;
   
      import javax.persistence.*;
   
      @Data
      @Table(name = "cms_message_config")
      public class CmsMessageConfig {
          /**
           * 主鍵
           */
          @Id
          @Column(name = "ID")
          private Integer id;
   
          /**
           * AppID
           */
          @Column(name = "APP_ID")
          private Integer appId;
   
          /**
           * AppKey
           */
          @Column(name = "APP_KEY")
          private String appKey;
   
          /**
           * 短信模板ID
           */
          @Column(name = "TEMPLATE_ID")
          private Integer templateId;
   
          /**
           * 簽名內容
           */
          @Column(name = "SMS_SIGN")
          private String smsSign;
   
          /**
           * 是否刪除，0：否，1：是
           */
          @Column(name = "IS_DELETE")
          private String isDelete;
   
          /**
           * 狀態，0：使用，1：未使用 (同一時間應最多隻有一條數據處於使用狀態)
           */
          @Column(name = "IS_USE")
          private String isUse;
   
          /**
           * 建立者ID
           */
          @Column(name = "CREATE_ADMIN_ID")
          private Integer createAdminId;
   
          @Column(name = "EXTEND1")
          private String extend1;
   
          @Column(name = "EXTEND2")
          private String extend2;
   
          @Column(name = "EXTEND3")
          private String extend3;
   
          @Column(name = "EXTEND4")
          private String extend4;
   
          @Column(name = "EXTEND5")
          private String extend5;
   
          @Column(name = "EXTEND6")
          private String extend6;
      }

4. Service

   @Override
      public ResponseBean sendMessage(MessageForm messageForm) {
          ValidatorUtils.validateEntity(messageForm);
   
          // 獲取正在使用的短信配置: 此處爲 從數據庫中查詢
          CmsMessageConfig messageConfig = getCurrUseMessageConfig();
   
          try {
              // 發送短信
              MessageUtils.sendMessage(Boolean.FALSE, messageForm, messageConfig);
          } catch (CustomException e) {
              e.printStackTrace();
              return ResponseBean.createInstance(Boolean.FALSE, 401, e.getMessage());
          }
   
          return ResponseBean.createInstance();
      }

5. Controller

   @PostMapping("/message/sendMessage")
      public ResponseBean sendMessage(MessageForm messageForm) {
          return messageService.sendMessage(messageForm);
      }

效果

1. 一號短信模板

2. 二號短信模板

3. 設置短信配置信息

結束語

最後，本人已開通公衆號，歡迎你們前來灌水