io.github.silencelwy.smsapi.SendSmsApi Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of jf-sms-send-sdk Show documentation
a tool about send short message
There is a newer version: 1.0.3.4-RELEASE
package io.github.silencelwy.smsapi;

import io.github.silencelwy.smsapi.client.DomainEnum;
import io.github.silencelwy.smsapi.tool.SmsSendTool;
import io.github.silencelwy.smsapi.vo.SmsSendResponse;

import java.util.LinkedList;
import java.util.Map;
import java.util.Set;

public final class SendSmsApi {

    private volatile static SmsSendTool smsSendTool;

    private SendSmsApi(String domainEnumUrl,String apiKey,String accessKey){
        smsSendTool = new SmsSendTool(domainEnumUrl,apiKey,accessKey);
    }

    public static SendSmsApi getInstance(String domainUrl,String apiKey,String accessKey){
        if (domainUrl == null){
            domainUrl = DomainEnum.DEFAULT.getUrl();
        }
        return new SendSmsApi(domainUrl,apiKey,accessKey);
    }
    /**
     * 短信发送。无参短信模板内容发送，即所有手机号接收到的短信内容一样
     * @param templateCode
     * @param phones 手机号。手机号最大个数限制1000
     * @return
     */
    public SmsSendResponse send(String templateCode, Set phones) throws Exception {
        return smsSendTool.send(templateCode,phones,null);
    }
    public SmsSendResponse send(String templateCode, Set phones, String upExtendCode) throws Exception {
        return smsSendTool.send(templateCode,phones,upExtendCode);
    }

    /**
     * 短信发送。不同手机号对应相同的短信模板变量值，即所有手机号接收到的短信内容一样
     * @param templateCode
     * @param params 模板参数变量值
     * @param phones 手机号。手机号最大个数限制1000
     * @return
     */
    public SmsSendResponse sendHasVar(String  templateCode, LinkedList params, Set phones) throws Exception {
        //手机号先去重，然后再转换
        return smsSendTool.send(templateCode,params,phones,null);
    }
    public SmsSendResponse sendHasVar(String  templateCode, LinkedList params, Set phones, String upExtendCode) throws Exception {
        //手机号先去重，然后再转换
        return smsSendTool.send(templateCode,params,phones,upExtendCode);
    }

    /**
     * 短信发送。不同手机号对应不同的短信模板变量值，即所有手机号接收到的短信内容不一样
     * @param templateCode 模板ID
     * @param phonesAndParams 手机号-手机号对应的模板参数。手机号最大个数限制500
     * @return
     */
    public SmsSendResponse sendPhoneToContent(String templateCode, Map> phonesAndParams) throws Exception {
        return smsSendTool.sendBatch(templateCode,phonesAndParams,null);
    }
    public SmsSendResponse sendPhoneToContent(String templateCode, Map> phonesAndParams, String upExtendCode) throws Exception {
        return smsSendTool.sendBatch(templateCode,phonesAndParams,upExtendCode);
    }
}