摘要
本文详细介绍了适配器设计模式，包括其定义、核心思想、角色、结构、实现方式、适用场景及实战示例。适配器模式是一种结构型设计模式，通过将一个类的接口转换成客户端期望的另一个接口，解决接口不兼容问题，提高系统灵活性和可复用性，符合“开闭原则”。文中还探讨了对象适配器和类适配器两种实现方式，以及如何结合策略模式动态选择适配器。
1. 适配器设计模式定义
适配器模式：将一个类的接口转换成客户希望的另一个接口，使得原本由于接口不兼容而不能一起工作的那些类可以一起工作。适配器就是“中间翻译层”，用一个类把“不兼容”的类封装起来，让它们看起来“兼容”，从而可以被别的类调用。
1.1.1. 适配器模式的核心思想
- 解决接口不兼容问题：通过适配器，将一个类的接口“包装”成另一个接口，供客户端调用。
- 提高系统的灵活性和可复用性：客户端无需修改现有代码即可调用新的类或组件。
- 符合“开闭原则”：对扩展开放，对修改关闭。
1.1.2. 📌 核心点总结：
| 点位 | 含义 |
| 目标接口 | 客户端期望使用的接口。 |
| 适配者（Adaptee） | 已有的类（接口不兼容） |
| 适配器（Adapter） | 封装 Adaptee，实现 Target 接口，实现“转换”逻辑。 |
1.1.3. 适配器模式的角色
| 角色 | 说明 |
| 目标接口 (Target) | 客户端期望的接口。客户端通过这个接口与适配器交互。 |
| 需要适配的类 (Adaptee) | 现有的接口或类，功能符合需求，但接口不兼容。 |
| 适配器 (Adapter) | 实现目标接口，内部持有需要适配的类的实例，并通过调用其方法来实现目标接口。 |
2. 适配器设计模式结构
适配器模式包含如下角色：
- Target：目标抽象类
- Adapter：适配器类
- Adaptee：适配者类
- Client：客户类
适配器模式有对象适配器和类适配器两种实现：
2.1. 对象适配器：
2.2. 类适配器：
2.3. 时序图
3. 适配器设计模式实现方式
3.1. 对象适配器（Object Adapter）
实现方式：适配器类内部通过组合的方式，持有被适配者类（Adaptee）的实例。
特点：
- 适配器实现目标接口（Target），
- 内部调用被适配者实例的方法实现目标接口的方法，
- 适配灵活，适配器和被适配者解耦，
- 适配器可以适配多个被适配者实例。
结构示例
// 目标接口
interface Target {void request();
}// 被适配者
class Adaptee {void specificRequest() {System.out.println("被适配者的具体请求");}
}// 适配器（对象适配器）
class Adapter implements Target {private Adaptee adaptee;public Adapter(Adaptee adaptee) {this.adaptee = adaptee;}@Overridepublic void request() {// 通过调用被适配者的方法完成目标接口功能adaptee.specificRequest();}
}3.2. 类适配器（Class Adapter）
实现方式：适配器通过继承的方式，同时继承被适配者类（Adaptee），并实现目标接口（Target）。
特点：
- 适配器类是被适配者的子类，
- 可以直接调用被适配者的受保护或公共方法，
- 只能适配一个被适配者类（Java单继承限制），
- 适配器和被适配者耦合度较高。
结构示例
// 目标接口
interface Target {void request();
}// 被适配者
class Adaptee {void specificRequest() {System.out.println("被适配者的具体请求");}
}// 适配器（类适配器）
class Adapter extends Adaptee implements Target {@Overridepublic void request() {// 直接调用父类的方法super.specificRequest();}
}3.3. 适配器示例总结
| 特性 | 对象适配器 | 类适配器 |
| 适配方式 | 组合（持有被适配者实例） | 继承（直接继承被适配者） |
| 灵活性 | 高，可以动态切换适配对象 | 低，继承限制，固定继承一个类 |
| 耦合度 | 低 | 高 |
| Java单继承限制 | 无限制 | 只能继承一个被适配者类 |
4. 适配器设计模式适合场景
4.1. ✅ 适合使用适配器设计模式的场景
| 使用场景 | 说明 |
| 对接多个第三方接口，接口风格不一致 | 比如接多个风控、支付、短信、物流等服务，不同厂商接口差异很大。→ 使用适配器封装不同厂商接口，统一成系统期望的接口。 |
| 封装老旧系统/遗留代码 | 老系统接口风格与新系统不一致，但又不能修改旧代码。→ 使用适配器包装旧接口，提供符合新接口的使用方式。 |
| 统一Controller参数处理逻辑 | Spring MVC 中自定义参数解析器 |
| 消息中间件适配 | Kafka、RabbitMQ、RocketMQ 提供的消息结构不一致，可使用适配器封装统一消费接口。 |
| 统一日志、监控、埋点等系统接入方式 | 不同日志系统（如 Logback、Log4j、ELK）、监控平台（如 Prometheus、SkyWalking）API 不统一，使用适配器将其统一为系统内部日志接口。 |
| 兼容不同规则引擎或插件机制 | 接入 Drools、EasyRules、自研规则引擎，通过适配器统一规则执行接口。 |
| 跨平台资源访问 | 比如统一适配本地文件系统、FTP、OSS、MinIO 等多种文件服务的上传/下载接口。 |
4.2. ❌ 不适合使用适配器设计模式的场景
| 场景 | 原因 |
| 接口已经统一，只需调用不同实现 | 用策略模式或 Spring Bean 多实现注入更合适 |
| 功能非常简单，仅调用一行代码 | 直接调用原类，无需适配 |
| 高性能要求场景，不能增加中间层 | 适配器可能增加调用链层次 |
| 适配器维护成本高于直接重构原类 | 如果可控代码建议重构，而不是套一层适配器 |
4.3. 📌 适配器设计模式总结
| 项目 | 适配器设计模式适用 | 不适用 |
| 是否接口不兼容但需协同工作 | ✅ 是 | ❌ 否 |
| 是否需要复用现有类且不改代码 | ✅ 是 | ❌ 否 |
| 是否频繁变更需求接口 | ❌ 否 | ✅ 是 |
| 是否对性能极度敏感 | ❌ 否 | ✅ 是 |
| 是否适配类与目标接口差异大 | ❌ 否 | ✅ 是 |
5. 适配器设计模式实战示例
背景：风控系统中，有多个第三方风险评分服务接口（接口不统一），需要统一成系统期望的接口供业务调用。使用适配器模式实现不同第三方服务的适配。
5.1. 场景描述
- 系统需要调用不同第三方风控服务接口（比如：
AlphaRiskService、BetaRiskService），它们方法名、参数不同。 - 系统定义统一的风控评分接口
RiskScoreService，所有第三方服务通过适配器实现该接口。 - Spring管理适配器bean，业务直接调用统一接口。
5.2. 定义统一风控评分接口（目标接口）
public interface RiskScoreService {/*** 计算用户的风险评分* @param userId 用户ID* @return 风险评分分数，范围0-100*/int calculateRiskScore(String userId);
}5.3. 第三方风控服务接口及实现（被适配者）
// 第三方A风险服务，接口不统一
public class AlphaRiskService {public double getUserRisk(String userId) {// 模拟调用第三方接口，返回0.0~1.0的风险概率return Math.random();}
}// 第三方B风险服务，接口不同
public class BetaRiskService {public int fetchRiskLevel(String userId) {// 返回风险等级 1~5，5最高风险return (int)(Math.random() * 5) + 1;}
}5.4. 适配器实现统一接口
import org.springframework.stereotype.Component;// Alpha适配器，组合方式（对象适配器）
@Component
public class AlphaRiskAdapter implements RiskScoreService {@Autowiredprivate final AlphaRiskService alphaRiskService;@Overridepublic int calculateRiskScore(String userId) {double riskProb = alphaRiskService.getUserRisk(userId);// 将0.0~1.0风险概率转为0~100分return (int)(riskProb * 100);}
}// Beta适配器，组合方式
@Component
public class BetaRiskAdapter implements RiskScoreService {@Autowiredprivate final BetaRiskService betaRiskService;@Overridepublic int calculateRiskScore(String userId) {int riskLevel = betaRiskService.fetchRiskLevel(userId);// 将风险等级1~5映射为0~100分return (riskLevel - 1) * 25;}
}5.5. 业务服务调用统一接口
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Service;@Service
public class RiskEvaluationService {@Autowiredprivate final RiskScoreService riskScoreService;// 自定义注解@Qualifier来选择注入哪个适配器。// @Qualifier("")// private final RiskScoreService riskScoreService;public void evaluateUserRisk(String userId) {int score = riskScoreService.calculateRiskScore(userId);System.out.println("用户 " + userId + " 的风险评分为：" + score);// 根据风险评分做后续风控策略处理...}
}5.6. Spring配置说明
- 你可以通过Spring配置或自定义注解@Qualifier来选择注入哪个适配器。
- 或者用策略模式管理多个适配器，根据业务动态选择。
6. 适配器设计模式思考
6.1. 用策略模式管理多个适配器，根据业务动态选择（策略模式 + 适配器模式结合示例）。
下面给你一个策略模式 + 适配器模式结合的示例，用于风控系统中动态选择不同适配器实现。
6.1.1. 设计思路
- 各个第三方风控服务适配成实现统一接口
RiskScoreService的适配器。 - 定义策略上下文
RiskScoreContext，根据业务传入的标识动态选择具体适配器（策略）执行。 - Spring管理多个适配器Bean，使用
@Qualifier或自定义注解区分。 - 业务调用上下文，动态选择适配器执行。
6.1.2. 统一接口（适配器接口）
public interface RiskScoreService {int calculateRiskScore(String userId);
}6.1.3. 2. 两个适配器实现（对象适配器）
import org.springframework.stereotype.Component;@Component("alphaAdapter")
public class AlphaRiskAdapter implements RiskScoreService {private final AlphaRiskService alphaRiskService = new AlphaRiskService();@Overridepublic int calculateRiskScore(String userId) {double riskProb = alphaRiskService.getUserRisk(userId);return (int) (riskProb * 100);}
}@Component("betaAdapter")
public class BetaRiskAdapter implements RiskScoreService {private final BetaRiskService betaRiskService = new BetaRiskService();@Overridepublic int calculateRiskScore(String userId) {int riskLevel = betaRiskService.fetchRiskLevel(userId);return (riskLevel - 1) * 25;}
}6.1.4. 策略上下文类，注入所有适配器
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Component;import java.util.Map;@Component
public class RiskScoreContext {private final Map<String, RiskScoreService> strategyMap;@Autowiredpublic RiskScoreContext(Map<String, RiskScoreService> strategyMap) {this.strategyMap = strategyMap;}/*** 根据key选择对应的适配器执行* @param strategyKey 适配器标识，如 "alphaAdapter"、"betaAdapter"* @param userId 用户ID* @return 风险评分*/public int calculate(String strategyKey, String userId) {RiskScoreService service = strategyMap.get(strategyKey);if (service == null) {throw new IllegalArgumentException("未知的风险评分策略：" + strategyKey);}return service.calculateRiskScore(userId);}
}6.1.5. 业务调用示例
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Service;@Service
public class RiskEvaluationService {private final RiskScoreContext riskScoreContext;@Autowiredpublic RiskEvaluationService(RiskScoreContext riskScoreContext) {this.riskScoreContext = riskScoreContext;}public void evaluateUserRisk(String userId, String strategyKey) {int score = riskScoreContext.calculate(strategyKey, userId);System.out.println("使用策略[" + strategyKey + "]，用户" + userId + "风险评分为：" + score);// 这里可根据score做风控决策处理}
}6.1.6. 测试调用示例
// 假设有Spring Boot主程序启动后，调用如下：@Autowired
RiskEvaluationService evaluationService;public void test() {evaluationService.evaluateUserRisk("user123", "alphaAdapter");evaluationService.evaluateUserRisk("user456", "betaAdapter");
}6.1.7. 说明
- Spring会自动将所有实现了
RiskScoreService接口的Bean注入到strategyMap中，key为Bean的名称（如alphaAdapter、betaAdapter）。 - 业务调用时传入策略key，根据key动态选择对应适配器。
- 这样便实现了“策略模式管理多个适配器，根据业务动态选择”的需求
博文参考
- 适配器模式（Adapter Pattern） | design-patterns
- https://refactoringguru.cn/design-patterns/adapter
