datai/docs/decisions/2026-01-21-003-02-ADR-salesforce-strategy-login.md

ADR-003-02: Salesforce 策略模式登录架构决策

元数据

• ADR 编号：ADR-003-02
• 需求编号：2026-01-21-003-02
• 创建时间：2026-01-22
• 状态：已采纳
• 决策人：SSOT 架构师

背景和问题陈述

背景

Salesforce 多系统认证功能需要支持多种登录方式，包括 OAuth2 Password 登录、OAuth2 Client Credentials 登录、OAuth2 Authorization Code 登录、Session ID 登录。用户需要能够通过页面选择登录策略，系统需要支持扩展新的登录策略。

问题

1. 如何实现多种登录方式的灵活切换？
2. 如何支持用户选择登录策略？
3. 如何支持扩展新的登录策略？
4. 如何管理登录策略的依赖注入？

决策驱动因素

技术因素

1. 扩展性：需要支持未来新增登录策略
2. 可维护性：代码结构清晰，易于维护
3. 灵活性：支持用户选择登录策略
4. 解耦性：登录策略与业务逻辑解耦

业务因素

1. 用户体验：用户可以方便地选择登录策略
2. 功能完整：支持 OAuth2 Password、OAuth2 Client Credentials、OAuth2 Authorization Code、Session ID 四种登录方式
3. 未来扩展：预留接口支持新的登录策略

非功能因素

1. 性能：登录响应时间 < 3 秒
2. 安全：敏感信息加密存储，HTTPS 传输
3. 可用性：系统可用性 99.9%

考虑的选项

选项 1：使用策略模式 + 工厂方法模式

描述

使用策略模式实现不同登录策略，使用工厂方法模式进行依赖注入。

优点

1. 符合开闭原则，对扩展开放，对修改关闭
2. 策略之间相互独立，互不影响
3. 工厂方法模式管理策略实例，便于依赖注入
4. 代码结构清晰，易于理解和维护
5. 支持运行时动态选择策略

缺点

1. 需要定义策略接口和多个策略实现
2. 增加了类的数量
3. 需要额外的工厂类

影响

• 代码复杂度：中等
• 性能影响：低
• 可维护性：高
• 扩展性：高

选项 2：使用 if-else 条件判断

描述

使用 if-else 条件判断不同的登录类型，执行对应的登录逻辑。

优点

1. 实现简单，代码量少
2. 不需要额外的类和接口

缺点

1. 违反开闭原则，新增登录策略需要修改现有代码
2. 代码耦合度高，难以维护
3. 不支持运行时动态选择策略
4. 代码可读性差，if-else 嵌套多

影响

• 代码复杂度：低
• 性能影响：低
• 可维护性：低
• 扩展性：低

选项 3：使用状态模式

描述

使用状态模式管理登录状态，不同状态对应不同的登录策略。

优点

1. 状态转换清晰
2. 支持状态相关的行为

缺点

1. 状态模式适用于状态转换场景，不适合登录策略选择
2. 增加了不必要的复杂性
3. 不符合业务场景

影响

• 代码复杂度：高
• 性能影响：低
• 可维护性：中
• 扩展性：中

决策结果

选择的方案

选项 1：使用策略模式 + 工厂方法模式

决策理由

1. 扩展性：策略模式支持新增登录策略，符合开闭原则
2. 可维护性：代码结构清晰，策略之间相互独立
3. 灵活性：工厂方法模式管理策略实例，支持运行时动态选择
4. 解耦性：登录策略与业务逻辑解耦
5. 符合业务场景：用户选择登录策略的场景适合使用策略模式

拒绝其他方案的理由

1. 拒绝选项 2：if-else 条件判断违反开闭原则，不利于扩展
2. 拒绝选项 3：状态模式不适合登录策略选择的场景

决策细节

策略接口设计

public interface LoginStrategy {
    
    LoginResult login(LoginRequest request) throws LoginException;
    
    LoginResult refreshToken(RefreshTokenRequest request) throws RefreshTokenException;
    
    void logout(LogoutRequest request) throws LoginException;
    
    String getLoginType();
    
    boolean supportRefreshToken();
}

策略实现

1. OAuth2LoginStrategy：实现 OAuth2 登录策略
2. SessionIdLoginStrategy：实现 Session ID 登录策略
3. 预留接口：支持扩展新的登录策略

工厂方法设计

@Component
public class LoginStrategyFactory {
    
    private final Map<String, LoginStrategy> strategyMap;
    
    @Autowired
    public LoginStrategyFactory(List<LoginStrategy> strategies) {
        this.strategyMap = strategies.stream()
            .collect(Collectors.toMap(LoginStrategy::getLoginType, Function.identity()));
    }
    
    public LoginStrategy getStrategy(String loginType) {
        LoginStrategy strategy = strategyMap.get(loginType);
        if (strategy == null) {
            throw new IllegalArgumentException("不支持的登录类型: " + loginType);
        }
        return strategy;
    }
    
    public List<String> getSupportedLoginTypes() {
        return new ArrayList<>(strategyMap.keySet());
    }
    
    public void registerStrategy(String loginType, LoginStrategy strategy) {
        strategyMap.put(loginType, strategy);
    }
}

依赖注入方式

使用 Spring 的依赖注入机制，通过 @Autowired 注入 List<LoginStrategy>，工厂类自动收集所有策略实现。

后果

正面后果

1. 扩展性：新增登录策略只需实现 LoginStrategy 接口，无需修改现有代码
2. 可维护性：策略之间相互独立，易于维护和测试
3. 灵活性：工厂方法模式支持运行时动态选择策略
4. 解耦性：登录策略与业务逻辑解耦，降低耦合度
5. 代码质量：符合设计模式最佳实践，代码结构清晰

负面后果

1. 类数量增加：需要定义策略接口、多个策略实现和工厂类
2. 学习成本：需要理解策略模式和工厂方法模式
3. 初始化复杂度：工厂类需要收集和管理所有策略实例

风险

1. 策略实例管理：需要确保策略实例正确初始化和管理
2. 异常处理：需要统一处理策略执行过程中的异常
3. 性能考虑：频繁创建策略实例可能影响性能

实施计划

阶段 1：策略接口和工厂实现

1. 定义 LoginStrategy 接口
2. 实现 LoginStrategyFactory 工厂类
3. 配置 Spring 依赖注入

阶段 2：OAuth2 登录策略实现

1. 实现 OAuth2LoginStrategy 类
2. 实现登录、刷新令牌、登出方法
3. 集成 Salesforce OAuth2 API

阶段 3：Session ID 登录策略实现

1. 实现 SessionIdLoginStrategy 类
2. 实现登录、登出方法
3. 集成 Salesforce Identity API

阶段 4：服务层和控制器实现

1. 实现 ISalesforceAuthService 接口
2. 实现 SalesforceAuthServiceImpl 服务类
3. 实现 SalesforceAuthController 控制器类

阶段 5：测试和优化

1. 编写单元测试
2. 编写集成测试
3. 性能优化

监控和评估

监控指标

1. 登录成功率：监控登录成功率，目标 ≥ 95%
2. 登录响应时间：监控登录响应时间，目标 < 3 秒
3. 异常率：监控登录异常率，目标 < 5%

评估周期

1. 短期评估：上线后 1 周内评估
2. 中期评估：上线后 1 个月内评估
3. 长期评估：上线后 3 个月内评估

评估标准

1. 功能完整性：所有功能点是否实现
2. 性能指标：是否达到性能目标
3. 用户体验：用户反馈是否良好
4. 扩展性：是否易于扩展新的登录策略

相关决策

• ADR-003-01: Salesforce 多系统配置架构决策

相关文档

• 需求文档
• 设计文档