业务函数别接 request:用工厂函数拆开路由与存储

举报
Wetter 发表于 2026/11/19 10:00:00 2026/11/19
【摘要】 路由负责 HTTP,service 表达业务规则,repository 提供存储能力。本文通过参数注入仓库与 ID 生成器,让任务创建逻辑可以独立测试,并为替换 PostgreSQL 留出明确边界。

一个任务创建函数接收 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 课。下一篇处理应用入口、插件范围与关闭资源。

【版权声明】本文为华为云社区用户原创内容,未经允许不得转载,如需转载请自行联系原作者进行授权。如果您发现本社区中有涉嫌抄袭的内容,欢迎发送邮件进行举报,并提供相关证据,一经查实,本社区将立刻删除涉嫌侵权内容,举报邮箱: cloudbbs@huaweicloud.com
  • 点赞
  • 收藏
  • 关注作者

评论(0)

0/1000
抱歉,系统识别当前为高风险访问,暂不支持该操作

全部回复

上滑加载中

设置昵称

在此一键设置昵称,即可参与社区互动!

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。