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 的兼容
网络层把字节流适配成业务消息协议与模型的接口转换