JavaScript / TypeScript / 系统课时
泛型类
泛型类
数据仓库、缓存和集合类通常拥有相同操作,但保存的实体类型不同。本课在类上声明类型参数,并结合约束实现一个按 id 管理对象的通用仓库,使实例方法始终保持一致的实体类型。
学习目标
- 在类定义和实例化时使用类型参数
- 让属性、参数和返回值共享同一实体类型
- 使用约束保证类内部可访问关键字段
实现通用仓库
仓库要求实体至少包含字符串 id。创建实例时指定 User 后,所有方法都会围绕 User 工作。
// 约束标识存在,并让 Map 保存具体实体
type Entity = {
id: string;
};
class Repository<T extends Entity> {
private readonly items = new Map<string, T>();
save(item: T): void {
this.items.set(item.id, item);
}
findById(id: string): T | undefined {
return this.items.get(id);
}
findAll(): T[] {
return Array.from(this.items.values());
}
}
type User = {
id: string;
name: string;
};
const users = new Repository<User>();
users.save({ id: "u1", name: "Ada" });
users.save({ id: "u2", name: "Lin" });
console.log(users.findById("u1")?.name);
console.log(users.findAll().length);预期输出:
Ada
2save 只能接收 User,findById 返回 User | undefined,无需在每次调用时重复断言。
实例类型彼此独立
Repository<User> 与 Repository<Entity> 是不同的实例类型,各自维护独立数据和方法签名。类的类型参数主要作用于实例成员,静态成员不能直接使用该类型参数。
约束类的职责
泛型类应抽取真正稳定的行为,不要为了复用而塞入大量与实体类型无关的分支。若不同实体的保存规则差异很大,更适合通过组合策略或子类扩展。
仓库对象的实际行为
本例 save 使用 Map.set,同一个 id 再保存会覆盖旧值,不是重复追加;findById 对未知 id 返回 undefined。用这两个边界验证仓库语义,避免调用方把保存当作数据库插入并依赖自动拒重。生产持久化还需要明确事务与并发策略,内存 Map 没有这些保证。
仓库保存的是对象引用。save 后直接修改原对象的 name,仓库读取也能看到变化;如果修改 id,Map 的键却不会同步变化。要维持索引一致,可以设计实体标识只读、在保存时复制,或只通过受控方法更新字段。
类的类型参数在编译后被擦除,运行时不能用 instanceof Repository<User> 区分实体类型。实例检查最多识别 Repository 构造关系。对不同仓库的实体做类型检查时,仍须采用数据结构或业务标识校验,不能把泛型当成运行时标签。
独立验证
使用 TypeScript 5.9.3 和 Node.js 22 检查本节。仓库应输出 Ada 与 2;额外查询不存在的编号应得到 undefined。尝试保存缺少 name 的 User 应被拒绝,同一个编号重复保存则要按覆盖语义核对。把主示例保存为独立目录的 main.ts,执行 npx tsc main.ts --strict --target ES2022 --module commonjs --outDir dist,预期退出码为 0;再执行 node dist/main.js 核对上述结果。说明性片段按其上下文编译,练习目录保持 CommonJS 模块约定。