JavaScript / TypeScript / 系统课时

多层对象建模

多层对象建模

多层对象真正难的不是给每个字段写类型,而是决定哪些结构应独立命名、哪些字段是列表、哪些关系应该嵌入完整对象。本篇用一个订单模型串起嵌套对象、数组和关联结构,得到可维护且能直接参与业务计算的类型定义。

学习目标

  • 为嵌套对象拆分职责清晰的命名类型
  • 正确表达对象列表及多层组合关系
  • 根据数据语义选择嵌入对象、快照或 ID 引用

先按业务概念拆类型

面对多层 JSON,不要从最外层开始写一个巨大的匿名对象类型。更稳妥的做法是先识别具有独立含义的业务概念,例如地址、客户、商品快照和订单项,再由最外层对象组合它们。

这样拆分后,每个类型都能单独复用和修改。字段路径也更容易理解:订单拥有收货地址,订单拥有若干订单项,每个订单项再拥有一个商品快照。

用命名类型组合嵌套对象

下面的订单模型同时包含普通嵌套对象和对象数组。ProductSnapshot 表示下单时保存的商品名称与单价,而不是实时读取当前商品数据,因此它适合直接嵌入订单项。

ts
type Address = {
  city: string;
  street: string;
};

type Customer = {
  id: string;
  name: string;
};

// 快照保存下单时的数据,避免商品后续变更影响历史订单
type ProductSnapshot = {
  id: string;
  name: string;
  unitPrice: number;
};

type OrderItem = {
  product: ProductSnapshot;
  quantity: number;
};

// 最外层类型只组合已命名的业务概念,避免深层匿名结构
type Order = {
  id: string;
  customer: Customer;
  shippingAddress: Address;
  items: OrderItem[];
};

const order: Order = {
  id: "order-1001",
  customer: { id: "user-7", name: "Lin" },
  shippingAddress: { city: "Shanghai", street: "Century Avenue" },
  items: [
    {
      product: { id: "p-1", name: "Keyboard", unitPrice: 399 },
      quantity: 2
    },
    {
      product: { id: "p-2", name: "Mouse", unitPrice: 199 },
      quantity: 1
    }
  ]
};

// 业务计算可在完整类型保护下安全访问深层字段
function calculateTotal(input: Order): number {
  return input.items.reduce(
    (sum, item) => sum + item.product.unitPrice * item.quantity,
    0
  );
}

console.log(`${order.id}: ${calculateTotal(order)}`);

预期输出:

text
order-1001: 997

这个示例的重点不是层数,而是每一层都承担明确职责。Order 只负责组合关系,OrderItem[] 明确表示一对多列表,价格计算则可以在完整类型保护下访问深层字段。

列表与关联要表达真实语义

对象数组使用 T[] 或 Array<T> 都可以,关键是数组元素必须有稳定、清晰的类型。不要把 items 写成 object[],因为那会丢失元素内部字段的信息,也无法检查 quantity、unitPrice 等属性是否存在。

关联对象则需要先判断数据语义。如果订单必须保留下单时的商品名称和价格,就像示例一样嵌入 ProductSnapshot;如果只需要指向另一个独立维护的实体,通常只保存 productId: string 更合适,再由其他数据源解析该 ID。

避免把所有字段都做成可选

真实接口中某些层级可能暂时缺失,但不要为了“兼容所有情况”给每个字段都加 ?。这样会把本来确定存在的数据也变成可能为 undefined,迫使业务代码到处做无意义的空值判断。

应先确认业务约束:确实可能不存在的字段才标记为可选;如果一个子对象有多种稳定形态,则更适合使用联合类型分别建模。多层对象的可维护性来自准确表达结构,而不是把类型放宽到什么数据都能通过检查。

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

目录与阅读设置

阅读设置

17

记录一个想法

多层对象建模

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

登录哪都通