真正有效的防腐层应分离职责:用原型继承管理内部模型复用与演进,用组合模式封装外部系统适配与隔离;前者定义干净结构,后者安全对接外部世界。

直接用原型继承“实现”防腐层是误区;真正有效的做法,是用原型继承管好内部模型的复用与演进,用组合模式封装对外部系统的适配与隔离。两者分工明确:原型负责“怎么定义干净的内部结构”,组合负责“怎么安全地对接脏乱的外部世界”。
原型继承:定义统一、可扩展的内部数据契约
防腐层的核心目标之一,是把外部千奇百怪的数据(比如祖传接口返回的 user_name、status=2、嵌套三层的 data.result.items[0].info)清洗成前端内部一致、语义清晰的模型。这个内部模型本身适合用原型继承来组织:
- 定义一个轻量基类(如
BaseResponse),只放通用方法:isValid()、toPlainObject()、timestamp等,不存业务字段 - 具体业务模型(如
OrderModel、UserModel)通过Object.create(BaseResponse.prototype)继承,只声明自己独有的字段和校验逻辑 - 所有模型共享基类方法,避免重复创建函数;字段全部挂在实例上,确保状态隔离
- 当需要新增字段或调整校验规则时,只需修改对应模型类,不影响其他模型——这是原型继承带来的可维护性
组合模式:把外部适配逻辑封装成可插拔的“翻译器”
真正的防腐动作发生在与外部系统交互的边界上。这里不用继承,而用组合——让防腐层本身成为一个容器,动态持有多个适配器:
- 为每个外部系统(如 legacy-API、third-party-payment、old-cms)编写独立的适配器类(如
LegacyOrderAdapter、PaySDKAdapter) - 每个适配器只关心一件事:输入原始响应 → 输出标准模型。它内部可调用上面定义的
OrderModel构造函数,但不继承它 - 防腐层主类(如
AntiCorruptionService)持有一个适配器映射表:{ 'legacy': new LegacyOrderAdapter(), 'pay': new PaySDKAdapter() } - 调用时按场景选择适配器:
service.fetch('order', 'legacy').pipe(map(res => adapter.transform(res)))
数据流设计:一次请求,两次转换
一个典型请求在防腐层内的流转是清晰分段的:
PigX UI Pro 前端开发指南 - Vue 3 + TypeScript + Element Plus。当用户提到 PigX UI、PigX 前端、lgb-mgui 项目、Vue 3 企业级后台开发、Element Plus 后台开发时使用此技能。
立即学习“前端免费学习笔记(深入)”;
- 第一段(网络层):发请求,拿到原始响应(可能是混乱 JSON、XML 或字符串)
- 第二段(适配层):交给对应适配器,做字段映射、状态码归一、错误分类、空值兜底等——这一步是“防腐”的核心操作
-
第三段(建模层):用原型继承体系下的模型类(如
new OrderModel(raw))构造干净实例,供业务组件消费
这种分段让每一层职责单一:适配器不碰 UI,模型不碰网络,组件只认模型——改祖传接口?只动适配器;加新字段?只扩模型类;换渲染方式?完全不影响防腐逻辑。
配套增强:缓存、Mock 与可观测性
防腐层不是静态胶水,而是活的中间件。结合组合结构,可以自然注入增强能力:
-
缓存策略:在适配器外层包装一个
CacheDecorator,它组合原始适配器,并用 Map 或 localStorage 缓存结果,键由请求参数哈希生成 -
Mock 支持:开发阶段,把真实适配器替换成
MockAdapter,它同样实现transform()接口,但返回预设的 Observable(如of(new OrderModel(mockData))) - 日志与监控:用装饰器模式包裹适配器,自动记录请求耗时、失败率、字段缺失统计,这些信息不侵入业务逻辑,只依赖组合关系
不复杂但容易忽略:防腐层的价值不在代码多酷,而在每次后端改字段时,你只需要打开一个适配器文件,改三行映射,其余照常运行。

















