Vue / 系统课时

数据转换与适配层

数据转换与适配层

接口字段直接渗透到组件后,后端一旦改名、改枚举或调整空值规则,页面就会被迫跟着改。本节用独立适配层把接口 DTO 转成稳定的页面模型,让组件只依赖业务语义,并把兼容逻辑集中在一个可测试的位置。

学习目标

  • 区分接口模型与页面模型的职责边界
  • 用 TypeScript 编写可测试的数据转换函数
  • 处理字段改名、单位转换、枚举和空值等常见差异

为什么不要让组件直接消费 DTO

后端 DTO 的目标是描述传输协议,字段通常受数据库、历史接口和跨端兼容影响;页面模型则服务于展示与交互,应使用前端稳定、易读的业务语义。两者生命周期不同,把 DTO 直接塞进组件会让协议变化扩散到模板、状态和测试。

DTO 经适配层转换为页面模型

适配层可以放在 src/adapters 或按领域与接口模块同目录。关键原则不是目录名,而是所有协议差异都在进入页面状态之前被消化,组件和 composable 不再反复判断后端字段。

编写一个稳定的转换函数

下面示例把用户接口模型转换成页面模型:后端金额使用分,时间使用 ISO 字符串,状态使用代码,并允许昵称为空;页面只接收可直接展示的字段。

ts
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))

预期输出

text
{
  id: 'u-1001',
  name: '未命名用户',
  balance: '25.99',
  createdDate: '2026-09-04',
  statusLabel: '启用'
}

实际日期显示策略可能受产品时区要求影响;如果页面要按用户本地时区显示,不应直接截取 ISO 字符串,而应统一交给日期工具或格式化服务。

把兼容逻辑留在边界上

适配层最常见的四类工作是字段改名、值规范化、枚举映射和结构重组。这里应只做确定性的转换,不发请求、不操作路由、不修改全局状态,这样函数可以用输入和输出直接测试。

当后端新增字段时,页面模型不一定要跟着增加;当后端把 status_code 从字符改为数字时,也只需要修改 DTO 类型和映射函数。只要页面模型契约不变,组件代码就不需要联动修改。

什么时候需要反向适配

提交表单时通常还需要把页面编辑模型转换回请求模型,例如把元转换成分、把展示枚举转换为接口代码。反向适配应使用单独函数,例如 toUpdateUserRequest,不要试图让同一个函数同时承担双向转换。

适配层的价值在于建立清晰边界:接口模型忠于后端协议,页面模型忠于前端业务。只要转换函数保持纯函数和显式类型,后端变化就能被限制在接口边界,而不是扩散到整个 Vue 组件树。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

数据转换与适配层

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通