liusheng
2026-10-10 0afac42fb2e9d6e5291304dd0044ce3042b45d2b
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
package com.ruoyi.message.sms.provider.ls;
 
/**
 * 丽水机构级配置 / token 提供方(扩展点 SPI)。
 * <p>
 * 现状:丽水的「短信地址 / 租户信息 / 发送人」存在数据库表 {@code sys_config} 的 {@code ls.msg.info} 里,
 * 而表访问在 {@code ruoyi-system} / {@code smartor} 模块;token 换取逻辑在 {@code smartor} 的
 * {@code LSHospTokenUtil}。
 * <p>
 * 为了让 {@code ruoyi-message} 保持「不依赖业务模块」的干净分层,这里定义 SPI,
 * 由业务模块(smartor)实现并注册为 Spring Bean;若容器里没有实现,本模块会退化为使用
 * 代码内静态配置(等价于 {@code MsgLSEnum})且不换 token。
 * <p>
 * 推荐实现放在 smartor 模块,内部通过 {@code ISysConfigService} 查询 {@code ls.msg.info}。
 */
public interface LishuiMessageConfigProvider {
 
    /**
     * 查询指定机构的丽水短信配置
     *
     * @param orgid 机构ID
     * @return 配置;查不到返回 {@code null}
     */
    LishuiMessageConfig getConfig(String orgid);
 
    /**
     * 获取丽水 360 平台 token
     *
     * @param orgid    机构ID
     * @param tokenUrl token 获取地址
     * @return token;获取失败返回 {@code null}
     */
    String getToken(String orgid, String tokenUrl);
}