Vue / 系统课时
数据转换与适配层
数据转换与适配层
接口字段直接渗透到组件后,后端一旦改名、改枚举或调整空值规则,页面就会被迫跟着改。本节用独立适配层把接口 DTO 转成稳定的页面模型,让组件只依赖业务语义,并把兼容逻辑集中在一个可测试的位置。
学习目标
- 区分接口模型与页面模型的职责边界
- 用 TypeScript 编写可测试的数据转换函数
- 处理字段改名、单位转换、枚举和空值等常见差异
为什么不要让组件直接消费 DTO
后端 DTO 的目标是描述传输协议,字段通常受数据库、历史接口和跨端兼容影响;页面模型则服务于展示与交互,应使用前端稳定、易读的业务语义。两者生命周期不同,把 DTO 直接塞进组件会让协议变化扩散到模板、状态和测试。

适配层可以放在 src/adapters 或按领域与接口模块同目录。关键原则不是目录名,而是所有协议差异都在进入页面状态之前被消化,组件和 composable 不再反复判断后端字段。
编写一个稳定的转换函数
下面示例把用户接口模型转换成页面模型:后端金额使用分,时间使用 ISO 字符串,状态使用代码,并允许昵称为空;页面只接收可直接展示的字段。
type UserDto = {
user_id: string
display_name: string | null
balance_cents: number
created_at: string
status_code: 'A' | 'D'
}
type UserViewModel = {
id: string
name: string
balance: string
createdDate: string
statusLabel: '启用' | '停用'
}
const statusLabelMap: Record<UserDto['status_code'], UserViewModel['statusLabel']> = {
A: '启用',
D: '停用',
}
function toUserViewModel(dto: UserDto): UserViewModel {
const created = new Date(dto.created_at)
return {
id: dto.user_id,
name: dto.display_name?.trim() || '未命名用户',
balance: (dto.balance_cents / 100).toFixed(2),
createdDate: created.toISOString().slice(0, 10),
statusLabel: statusLabelMap[dto.status_code],
}
}
const dto: UserDto = {
user_id: 'u-1001',
display_name: null,
balance_cents: 2599,
created_at: '2026-09-04T08:30:00.000Z',
status_code: 'A',
}
console.log(toUserViewModel(dto))预期输出
{
id: 'u-1001',
name: '未命名用户',
balance: '25.99',
createdDate: '2026-09-04',
statusLabel: '启用'
}实际日期显示策略可能受产品时区要求影响;如果页面要按用户本地时区显示,不应直接截取 ISO 字符串,而应统一交给日期工具或格式化服务。
把兼容逻辑留在边界上
适配层最常见的四类工作是字段改名、值规范化、枚举映射和结构重组。这里应只做确定性的转换,不发请求、不操作路由、不修改全局状态,这样函数可以用输入和输出直接测试。
当后端新增字段时,页面模型不一定要跟着增加;当后端把 status_code 从字符改为数字时,也只需要修改 DTO 类型和映射函数。只要页面模型契约不变,组件代码就不需要联动修改。
什么时候需要反向适配
提交表单时通常还需要把页面编辑模型转换回请求模型,例如把元转换成分、把展示枚举转换为接口代码。反向适配应使用单独函数,例如 toUpdateUserRequest,不要试图让同一个函数同时承担双向转换。
适配层的价值在于建立清晰边界:接口模型忠于后端协议,页面模型忠于前端业务。只要转换函数保持纯函数和显式类型,后端变化就能被限制在接口边界,而不是扩散到整个 Vue 组件树。