摘要：總結(jié)目前騰訊阿里和云之訊短信服務(wù)都進行了試驗，希望各位小伙伴能合作完成驗證，共同完善該，覺得有用請該項目。如果只想使用而騰訊云短信業(yè)務(wù)的話，按照使用即可。

短信服務(wù)在用戶注冊、登錄、找回密碼等相關(guān)操作中，可以讓用戶使用更加便捷，越來越多的公司都采用短信驗證的方式讓用戶進行操作，從而提高用戶的實用性。

由于 Spring boot 的約定大于配置的理念，使得在使用Spring變得更加方便。Spring Boot 項目組提供了很多Starter ，讓我們在使用 Spring 的時候變得非常容易。對于官方提供的Starter 采用 spring-boot-starter-xxx開頭，對于非官方提供的Spring Boot Starter ,官方建議采用 xxxx-spring-boot-starter命名。

## 1. 開發(fā)工具及編譯

IntelliJ IDEA 2018.2.5
Maven 3.5
JDK 1.8
## 2. 如何使用sms-spring-boot-starter
  ### (1). 在pom文件中引入

   
         com.github.jackieonway.sms
         sms-spring-boot-starter
         0.0.1-SNAPSHOT
     

在pom.xml中配置maven中央倉庫Snapshots地址

      
          mavenRepoCenter
          Maven Development Snapshot Repository
          https://oss.sonatype.org/content/repositories/snapshots
          
              false
          
          
              true
          
      
  

spring:
 jackieonway:
   sms:
     sms-type: tentcent  # 短信服務(wù)商 暫目前只有 騰訊和阿里的短信服務(wù)，默認為ali
     security-key: your security-key # 短信的私鑰
     appid: your appid # 短信的應(yīng)用id
     sign: your sign # 短信的簽名

@EnabledSmsAutoConfiguration

可以采用排除相關(guān)依賴的方式注入Service

可以采用加 @Qualifier("tencentSmsService")的方式注入Service ,
value的可選值目前只有 tencentSmsService 和aliSmsService兩種，

可以采用
@Autowired
private SmsService tencentSmsService;
注入，方式與方法2類似

采用方式1，最終的jar包將會比方式2和方法3小，但是最終只有一種短信模式
生效，即只能使用一個短信運營商的服務(wù)，方式2，3能快速切換短信運營商

@RestController
public class HelloController {

     /**
     * 1. 可以采用排除相關(guān)依賴的方式注入Service
     * 2. 可以采用加 @Qualifier("tencentSmsService")的方式注入Service ,
     *    value的可選值目前只有 tencentSmsService 和aliSmsService兩種，
     * 3.  可以采用
     *      @Autowired
     *      private SmsService tencentSmsService;
     *      注入，方式與方法2類似
     * 采用方式1，最終的jar包將會比方式2和方法3小，但是最終只有一種短信模式
     * 生效，即只能使用一個短信運營商的服務(wù)，方式2，3能快速切換短信運營商
     */

    @Autowired
    private SmsService tencentSmsService;

//    @Autowired
//    private SmsService aliSmsService;

    @GetMapping("/tencent")
    public Object tencent() {
        // 具體配置請參照具體運營商
        // your template params
        String[] paramst = {"5678","5"};
        TencentSmsRequest tencentSmsRequest = new TencentSmsRequest();
        tencentSmsRequest.setPhoneNumber(new String[]{"your cellphone"});
        tencentSmsRequest.setParams(paramst);
        return tencentSmsService.sendTemplateSms("328921", tencentSmsRequest);
    }

    /* @GetMapping("/ali")
     public Object ali() {
         // 具體配置請參照具體運營商
         AliSmsRequest aliSmsRequest = new AliSmsRequest();
         aliSmsRequest.setOutId("420");
         aliSmsRequest.setPhoneNumbers(new String[]{"your cellphone"});
         aliSmsRequest.setTemplateParam("{"code":"asdsads"}");
         aliSmsRequest.setSignName("123");
         return aliSmsService.sendTemplateSms("328921",aliSmsRequest);
     }*/
}

訪問 localhost:8080/tencent

    /**
     *  單個發(fā)送短信
     * @param params 根據(jù)對應(yīng)的短信服務(wù)商所需信息填寫
     */
    public Object sendSms(Integer type,Object params) throws SmsException;

    /**
     * 單個發(fā)送模板短信
     * @param tempalteId 短信模板id
     * @param params 根據(jù)對應(yīng)的短信服務(wù)商所需信息填寫
     */
    public Object sendTemplateSms(String tempalteId, Object params) throws SmsException;

    /**
     *  批量發(fā)送短信
     * @param params 根據(jù)對應(yīng)的短信服務(wù)商所需信息填寫
     */
    public Object sendBatchSms(int type,Object params) throws SmsException;

    /**
     * 批量發(fā)送模板短信
     * @param tempalteId 短信模板id
     * @param params 根據(jù)對應(yīng)的短信服務(wù)商所需信息填寫
     */
    public Object sendBatchTemplateSms(String tempalteId, Object params) throws SmsException;

該接口提供了單個和群發(fā)短信與模板短信，注意目前只提供了同步發(fā)送方法，異步發(fā)送方法，請結(jié)合線程池進行。

目前騰訊、阿里和云之訊短信服務(wù)都進行了試驗，希望各位小伙伴能合作完成驗證，共同完善該starter，覺得有用請starter該項目。如果只想使用而騰訊云短信業(yè)務(wù)的話，按照Demo使用即可。

github地址:sms-spring-boot-project