1 Adapter
自动关联目录:1 Adapter
适配器把一个类的接口转换成客户端期望的另一个接口,让原本因为接口不匹配而不能一起工作的类可以协作。
它是典型的事后补救模式:现存对象已经写好且能跑,只是新环境的接口要求它不满足。
结构
| 角色 | 职责 |
|---|---|
Target | 客户端期望的接口 |
Adaptee | 已存在的、接口不匹配的那个类 |
Adapter | 实现 Target,内部转调 Adaptee |
原笔记里的写法:
class Abstract {
public:
virtual void DoNewSomething();
virtual ~Abstract(){}
};
class OldAbstract {
public:
virtual void DoOldSomething();
virtual ~Abstract(){}
};
class AbstractAdapter : public Abstract{
protected:
OldAbstract* m_OldAbstract;
public:
AbstractAdapter(OldAbstract* oldAbstract) : m_OldAbstract(oldAbstract) {}
virtual void DoNewSomething() override {
// 做兼容性逻辑
m_OldAbstract->DoOldSomething();
}
};
class User {
public:
void Do(){
auto oldAbstract = new OldAbstract();
auto abstractAdapter = AbstractAdapter(oldAbstract);
abstractAdapter->DoNewSomething();
}
};两种实现
| 方式 | 手段 | 取舍 |
|---|---|---|
| 对象适配器 | 持有 Adaptee 指针(组合) | 推荐;可适配 Adaptee 的子类,不侵入继承链 |
| 类适配器 | 多重继承 Target 与 Adaptee | 编译期绑定、少一次间接;但把 Adaptee 钉死,C++ 里还容易引发菱形继承 |
优先对象适配器——组合优于继承在这里同样成立。
何时用
| 场景 | 说明 |
|---|---|
| 接入第三方库 | 库的接口风格与项目不一致,包一层再进业务代码 |
| 组件升级/替换 | 老组件接口保留,新实现适配到老接口(或反过来) |
| 统一多个相似接口 | 多家支付、多种后端,各自适配到同一个内部接口 |
| 防腐层(ACL) | 系统边界上隔离外部模型,避免外部概念渗透进内部 |
收益不在"能跑",而在外部变化被拦在适配器里:换库只改适配器,业务代码不动。
与邻居的区别
| 目的 | 时机 | |
|---|---|---|
| Adapter | 让不兼容的能一起用 | 事后补救 |
| Facade | 让复杂的变简单 | 事前或重构时 |
| Proxy | 控制访问 | 接口本来就一致 |
| Bridge | 让两个维度各自变化 | 设计之初 |
Adapter 和 Proxy 结构几乎一样(都是包一层转发),区别只在意图:一个是"接口对不上",一个是"不该直接访问"。
常见坑
| 坑 | 说明 |
|---|---|
| 适配器越写越厚 | 业务逻辑往里漏,最后变成半个子系统,应及时重构 |
| 适配链太长 | A 适配 B,B 适配 C,调用栈全是指针转发,性能和可读性都糟 |
| 双向适配 | 两边都适配对方,改一处要动两处 |
| 用适配器掩盖设计错误 | 如果能改源码,直接改接口往往比包一层干净 |
| 忘了生命周期 | 适配器持有 Adaptee 裸指针,谁先死说不清 |
与引擎的对应
| 引擎机制 | 对应 |
|---|---|
| 平台层对第三方 SDK 的封装 | 隔离外部库接口 |
| 插件的适配层 | 不同版本引擎 API 的兼容 |
| 网络层把字节流适配成业务消息 | 协议与模型的接口转换 |
许可协议:CC BY
作者:Davids
本文链接:https://hustjjd.github.io/6d3820f7.html
更新于:2026年11月16日