0Pricing
TypeScript Academy · 课时

数据模型的可复用模式

将泛型模式应用于实际模型：Paginated 、Result 、使用 Pick/Omit/Partial 的 DTO，以及以 id 为键的映射。

数据模型的可复用模式 是 CoddyKit 上的免费 TypeScript Academy 课时。 这是第 3 节课，共 3 节。 你可以在下方免费阅读本课时的完整内容 — 然后在浏览器中使用内置代码编辑器和全天候 AI 导师进行实践。 这是 TypeScript Academy 学习路径的一部分，你的进度在网页和 CoddyKit 应用中同步。 TypeScript Academy 课程共包含 3 节课。

简介

目标：将常见的数据结构封装为泛型，从而复用结构而不牺牲类型安全性。

  • 分页结果<T>
  • 结果<T,E>
  • 使用选取类型/排除类型/部分类型构建数据传输对象
  • 按标识键控的映射

分页结果<T>

分页结果<T>集中管理元数据，并让列表中的项目类型 T保持精确。

type Paginated<T> = {
  items: T[];
  total: number;
  page: number;
  pageSize: number;
};

type User = { id: number; name: string };

const page1: Paginated<User> = {
  items: [{ id: 1, name: "Ada" }],
  total: 10,
  page: 1,
  pageSize: 5,
};

console.log(page1.items[0].name);

结果<T,E>

结果<T,E>通过判别字段（ok）明确表示成功或失败，以便安全地进行分支处理。

type Ok<T> = { ok: true; data: T };
type Err<E = string> = { ok: false; error: E };

type Result<T, E = string> = Ok<T> | Err<E>;

function readUser(id: number): Result<{ id: number; name: string }> {
  return id > 0 ? { ok: true, data: { id, name: "Ada" } } : { ok: false, error: "not found" };
}

const r = readUser(1);
if (r.ok) {
  console.log(r.data.name);
} else {
  console.error(r.error);
}

数据传输对象模式

借助选取类型/排除类型/部分类型，您可以从核心模型派生出简洁的数据传输对象类型，无需重复定义。

type User = { id: number; name: string; email?: string; role: "user" | "admin" };

type UserCreateDto = Pick<User, "name" | "email">; // fields required to create

// Update = partial editable fields
type UserUpdateDto = Partial<Pick<User, "name" | "email">>;

const createBody: UserCreateDto = { name: "Ada", email: "a@x.io" };
const updateBody: UserUpdateDto = { name: "Ada L." };

MapById<T>

MapById<T>按 id 为实体建立索引，以实现快速查找。请约束 T，确保其中存在 id。

type Key = string | number;

type MapById<T extends { id: Key }> = Record<Key, T>;

const byId: MapById<{ id: number; name: string }> = {
  1: { id: 1, name: "Ada" },
  2: { id: 2, name: "Lin" },
};

console.log(byId[1].name);

提示

提示：

  • 请让模式保持小型且可组合。
  • 对于状态机，请优先使用判别联合类型。
  • 请从模型派生数据传输对象，避免手动复制。

分页结果<T>检查

快速检查：为什么要定义泛型分页结果<T>？

回顾

回顾：请将重复出现的结构泛化：分页结果<T>、结果<T,E>、使用选取类型/排除类型/部分类型构建的数据传输对象，以及按标识索引的映射。小型辅助工具可以跨功能复用。

常见问题解答

「数据模型的可复用模式」课时是免费的吗？

是的 — 「数据模型的可复用模式」的完整文本可在网页上免费阅读。要进行交互式练习（内置代码编辑器和全天候 AI 导师）并解锁 TypeScript Academy 课程的其余内容，请升级到 CoddyKit PRO。 TypeScript Academy 课程共包含 3 节课。

「数据模型的可复用模式」这节课中我会学到什么？

将泛型模式应用于实际模型：Paginated 、Result 、使用 Pick/Omit/Partial 的 DTO，以及以 id 为键的映射。 你通过在浏览器中直接运行的动手代码来练习 TypeScript Academy，全天候 AI 导师会在你学习这节课的过程中回答你的问题。

学习 TypeScript Academy 需要有经验吗？

无需任何先前经验。CoddyKit 上的 TypeScript Academy 课程适合初学者到高级学习者，你可以从这里开始或从头开始，按照自己的节奏学习。 这是第 3 节课，共 3 节。

「数据模型的可复用模式」课时需要多长时间？

大多数 CoddyKit 课程大约需要 5–10 分钟。每节课都很精短且互动，所以你能稳步进步，并在网页和应用中从离开的地方继续。

我能在这节 TypeScript Academy 课中编写并运行代码吗？

能。每节 TypeScript Academy 课都包含内置代码编辑器，你可以在浏览器中直接编写并运行真实代码，并获得即时 AI 反馈 — 无需本地设置。

此课程中的所有课时

  1. 泛型接口与类型别名
  2. 条件类型（入门）与联合类型上的分发
  3. 数据模型的可复用模式
← 返回 TypeScript Academy