package com.ruoyi.message.sms;
|
|
import com.ruoyi.message.SendResult;
|
|
/**
|
* 短信发送方（一个渠道一个实现）。
|
* <p>
|
* 各站点对接方式差异很大 —— 报文格式、鉴权/签名、token 换取、返回码判定、配置来源都不同，
|
* 因此不要用一个实现加参数分支来做，而是一个渠道一个类，类内部保持与线上完全一致的行为。
|
*/
|
public interface SmsSender {
|
|
/**
|
* 发送方唯一 key。
|
* <p>
|
* 该 key 同时是 {@code spring.profiles.active} 的取值（xh / ls / sltd / nhfy / hzszlyy ...），
|
* 由 {@code MessageSenderFactory} 按 key 路由。
|
*/
|
String key();
|
|
/**
|
* 发送短信
|
*
|
* @param request 统一入参
|
* @return 统一结果，不抛异常（网络/解析异常也会被包装成失败结果）
|
*/
|
SendResult send(SmsSendRequest request);
|
|
/**
|
* 发送方说明，用于日志与排查
|
*/
|
default String description() {
|
return key();
|
}
|
}
|
