JavaScript / TypeScript / 系统课时
多层对象建模
多层对象建模
多层对象真正难的不是给每个字段写类型,而是决定哪些结构应独立命名、哪些字段是列表、哪些关系应该嵌入完整对象。本篇用一个订单模型串起嵌套对象、数组和关联结构,得到可维护且能直接参与业务计算的类型定义。
学习目标
- 为嵌套对象拆分职责清晰的命名类型
- 正确表达对象列表及多层组合关系
- 根据数据语义选择嵌入对象、快照或 ID 引用
先按业务概念拆类型
面对多层 JSON,不要从最外层开始写一个巨大的匿名对象类型。更稳妥的做法是先识别具有独立含义的业务概念,例如地址、客户、商品快照和订单项,再由最外层对象组合它们。
这样拆分后,每个类型都能单独复用和修改。字段路径也更容易理解:订单拥有收货地址,订单拥有若干订单项,每个订单项再拥有一个商品快照。
用命名类型组合嵌套对象
下面的订单模型同时包含普通嵌套对象和对象数组。ProductSnapshot 表示下单时保存的商品名称与单价,而不是实时读取当前商品数据,因此它适合直接嵌入订单项。
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)}`);预期输出:
order-1001: 997这个示例的重点不是层数,而是每一层都承担明确职责。Order 只负责组合关系,OrderItem[] 明确表示一对多列表,价格计算则可以在完整类型保护下访问深层字段。
列表与关联要表达真实语义
对象数组使用 T[] 或 Array<T> 都可以,关键是数组元素必须有稳定、清晰的类型。不要把 items 写成 object[],因为那会丢失元素内部字段的信息,也无法检查 quantity、unitPrice 等属性是否存在。
关联对象则需要先判断数据语义。如果订单必须保留下单时的商品名称和价格,就像示例一样嵌入 ProductSnapshot;如果只需要指向另一个独立维护的实体,通常只保存 productId: string 更合适,再由其他数据源解析该 ID。
避免把所有字段都做成可选
真实接口中某些层级可能暂时缺失,但不要为了“兼容所有情况”给每个字段都加 ?。这样会把本来确定存在的数据也变成可能为 undefined,迫使业务代码到处做无意义的空值判断。
应先确认业务约束:确实可能不存在的字段才标记为可选;如果一个子对象有多种稳定形态,则更适合使用联合类型分别建模。多层对象的可维护性来自准确表达结构,而不是把类型放宽到什么数据都能通过检查。