业务函数别接 request:用工厂函数拆开路由与存储
一个任务创建函数接收 FastifyRequest,读取 body,写入数据库,再调用 reply.send。短期很方便,稍后后台 Worker 也想创建任务时,却不得不模拟一份 HTTP 请求。
先把业务输入还原成普通数据,HTTP 的状态码、header 和请求对象留在路由里。
先声明需要的能力
import assert from 'node:assert/strict';
type Task = { id: string; title: string; status: 'pending' };
interface Repository {
save(task: Task): Promise<void>;
find(id: string): Promise<Task | undefined>;
}
function makeService(repo: Repository, newId: () => string) {
return {
async create(input: { title: string }): Promise<Task> {
const title = input.title.trim();
if (title === '') throw new Error('EMPTY_TITLE');
const task: Task = { id: newId(), title, status: 'pending' };
await repo.save(task);
return task;
},
find(id: string) { return repo.find(id); },
};
}
const records = new Map<string, Task>();
const repo: Repository = {
async save(task) { records.set(task.id, { ...task }); },
async find(id) {
const task = records.get(id);
return task === undefined ? undefined : { ...task };
},
};
const service = makeService(repo, () => 't-fixed');
assert.deepEqual(await service.create({ title: ' 摘要 ' }), {
id: 't-fixed', title: '摘要', status: 'pending',
});
await assert.rejects(service.create({ title: ' ' }), { message: 'EMPTY_TITLE' });
assert.equal((await service.find('t-fixed'))?.title, '摘要');
console.log('service: passed');
仓库接口列出业务真正需要的操作。函数通过参数拿到依赖,不要求引入装饰器或 DI 容器。熟悉 Spring 的开发者,可以把它看成显式的构造注入;只是这里用函数组织对象。
flowchart TD
A[Fastify 路由] --> B[普通输入数据]
B --> C[Task Service]
C --> D[Repository 接口]
D --> E[内存实现]
D --> F[PostgreSQL 实现]
G[ID 生成函数] --> C
返回业务结果,再由路由翻译
service.create 返回任务,路由决定 HTTP 201、Location 和响应 DTO。service 抛出业务错误时,由接口适配层映射为固定错误契约;第 6 课会把 EMPTY_TITLE 这种临时写法换成明确的错误类型。
数据库异常也不应在业务层随手包装成“任务不存在”。找不到是一种正常查询结果,连接失败则是系统错误,两者需要不同的日志和响应策略。
不要为分层机械增加目录
项目很小时,repository 接口和业务函数可以放在相邻文件。先确保依赖方向:业务不导入 Fastify,存储实现不反向调用路由。目录结构只是帮助读者找到这些关系。
接口也不要大到暴露整个数据库驱动。把 Pool 传给所有业务函数,相当于让每个调用方都可以自由拼 SQL,存储边界就很难维护。
这个练习的 ID 生成器固定返回 t-fixed,目的是让断言稳定;实际应用入口传入 randomUUID。把时间、随机数和外部调用都收进明确依赖以后,业务测试往往会更直接。
最后尝试把 repo.save 改成抛错,确认 service.create 的 Promise 也失败,没有先报告成功。创建成功应以需要的持久化动作完成为条件。
分层方向来自学习计划第 5 课。下一篇处理应用入口、插件范围与关闭资源。
- 点赞
- 收藏
- 关注作者
评论(0)