使用Node.js实现Clean Architecture方法示例详解

更新时间：2023年02月22日 08:52:21 作者：鱼露

这篇文章主要为大家介绍了使用Node.js实现Clean Architecture方法示例详解，有需要的朋友可以借鉴参考下，希望能够有所帮助，祝大家多多进步，早日升职加薪

Clean Architecture

Clean Architecture 是 Robert C. Martin 提出的一种软件架构模式，目的是为了将系统分层，实现关注点分离，使系统更易于理解、维护和扩展。该体系结构将系统分为四个层级，从内到外分别是：实体层、用例层、表现层、基础设施（存储库，框架等）。

在本文中，我们将介绍如何使用 Node.js 实现 Clean Architecture，并提供一些示例代码来演示该架构的关键概念。

接下来我们将使用 TypeScript 项目示例（github.com/lulusir/cle… ）。该项目采用了 Monorepo 结构，使用 Rush.js 进行管理。在 server 文件夹中包含了三个子项目，分别为 core、koa 和 nestjs-app，其中 core 为核心业务逻辑，koa是使用koa+prisma的为底层框架web项目，nestjs-app是使用nestjs + typeorm为底层框架的项目。目的是演示相同的业务逻辑如何桥接不同的框架。

在这个项目中，实体层包含实体对象和相关的业务规则和逻辑，用例层包含系统的用例和业务逻辑，存储库层负责保存和检索数据，表示层则是暴露给外部的http接口。

项目功能：

实现一个帖子发布，浏览功能

用户创建，查询
帖子的发布，编辑，查询，删除

项目结构

├── server
│   ├── core // 核心业务逻辑
│   │   └── src
│   │       ├── domain
│   │       ├── repository
│   │       └── useCase
│   ├── koa
│   │   └── src
│   │       ├── post
│   │       └── user
│   └── nestjs-app
│       ├── src
│           ├── post
│           │   ├── dto
│           │   └── entities
│           └── user
│               └── entities
└── web

core：core为核心业务逻辑的代码

Domain: 存放实体相关的代码，如业务具体的 model 等
Use Cases: 存放业务逻辑相关的代码，如处理业务逻辑、数据验证、调用 Repository 等
Repository: 存放和外部存储系统的相关接口

koa/nestjs-app: core的实际消费者

根据core的接口实现具体的Router，Repository

项目特点

使用 DDD 和 Clean Architecture 的思想，将业务逻辑与框架实现分离。
使用 monorepo 项目结构，方便管理多个相关的项目。
提供了多个示例应用程序，方便快速上手。
基于 TypeScript，提高代码可读性和可维护性。

在core中，我们有核心的业务逻辑代码。此级别包含域、存储库接口和用例。域包含与实体相关的代码，例如特定的业务模型。存储库包含与外部存储系统的相关接口。用例包含与业务逻辑相关的代码，例如处理业务逻辑、数据验证和调用存储库。

在koa/nestjs-app层面，我们有核心层面的实际消费者。它们根据核心层提供的接口实现特定的路由器和存储库。使用 Clean Architecture 的主要优点之一是它将业务逻辑与技术实现分开。这意味着您可以轻松地在不同的框架和库之间切换，而无需更改核心业务逻辑。在我们的示例中，我们可以在 koa 和 nestjs-app 之间切换，同时保持相同的核心业务逻辑。

代码实现

定义实体层

// server/core/src/domain/post.ts
import { User } from "./user";
export class Post {
  author: User | null = null;
  content: string = "";
  updateAt: Date = new Date(); // timestamp;
  createdAt: Date = new Date(); // timestamp;
  title: string = "";
  id: number = -1;
}
// server/core/src/domain/user.ts
export class User {
  name: string = ''
  email: string = ''
  id: number = -1
}

定义存储接口

import { Post } from "../domain/post";
export interface IPostRepository {
  create(post: Post): Promise<boolean>;
  find(id: number): Promise<Post>;
  update(post: Post): Promise<boolean>;
  delete(post: Post): Promise<boolean>;
  findMany(options: { authorId: number }): Promise<Post[]>;
}
...
import { User } from "../domain/user";
export interface IUserRepository {
  create(user: User): Promise<boolean>;
  find(id: number): Promise<User>;
}

定义用例层

import { User } from "../domain/user";
import { IUserRepository } from "../repository/user";
export class UCUser {
  constructor(public userRepo: IUserRepository) {}
  find(id: number) {
    return this.userRepo.find(id);
  }
  create(name: string, email: string) {
    if (email.includes("@test.com")) {
      const user = new User();
      user.email = email;
      user.name = name;
      return this.userRepo.create(user);
    }
    throw Error("Please use legal email");
  }
}

koa项目

在koa项目中实现存储层接口

// server/koa/src/user/user.repo.ts
import { PrismaClient } from "@prisma/client";
import { IUserRepository, User } from "core";
export class UserRepository implements IUserRepository {
  prisma = new PrismaClient();
  async create(user: User): Promise<boolean> {
    const d = await this.prisma.user_orm_entity.create({
      data: {
        email: user.email,
        name: user.name,
      },
    });
    return !!d;
  }
  async find(id: number): Promise<User> {
    const d = await this.prisma.user_orm_entity.findFirst({
      where: {
        id: id,
      },
    });
    if (d) {
      const u = new User();
      u.email = d?.email;
      u.id = d?.id;
      u.name = d?.name;
      return u;
    }
    throw Error("user id " + id + "not found");
  }
}

在koa项目中实现HTTP路由（表现层）

// server/koa/src/user/user.controller.ts
import Router from "@koa/router";
import { UCUser } from "core";
import { UserRepository } from "./user.repo";
export const userRouter = new Router({
  prefix: "/user",
});
userRouter.get("/:id", async (ctx, next) => {
  try {
    const service = new UCUser(new UserRepository());
    if (ctx.params.id) {
      const u = await service.find(+ctx.params.id);
      ctx.response.body = JSON.stringify(u);
    }
  } catch (e) {
    ctx.throw(400, "some error on get user", e.message);
  }
  await next();
});

nest-js项目

nestjs 项目的示例可以在此路径中找到（github.com/lulusir/cle… 就不在这里贴代码了

最后

请注意，在实际项目中，我们不会将核心业务逻辑放在单独的仓库中（即core），这只是为了演示在不同框架下使用相同的业务逻辑

通过将业务逻辑与框架分离，您可以轻松地在不同的框架和库之间切换，而无需更改核心业务逻辑。如果您希望构建可扩展且可维护的应用程序，那么Clean Architecture 绝对值得考虑。

如果想要演示如何接入其他框架，可以在评论区提出

项目地址（github.com/lulusir/cle… 觉得不错的小伙伴，可以给个star，谢谢

以上就是使用Node.js实现Clean Architecture方法示例详解的详细内容，更多关于Node.js Clean Architecture的资料请关注脚本之家其它相关文章！

您可能感兴趣的文章:

使用nodejs搭建一个简易HTTP服务的实现示例
本文主要介绍了使用nodejs搭建一个简易HTTP服务的实现示例，文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值，需要的朋友们下面随着小编来一起学习学习吧
2022-05-05
利用Node.js批量抓取高清妹子图片实例教程
这篇文章主要给大家介绍了关于利用Node.js批量抓取高清妹子图片的相关资料，文中通过示例代码介绍的非常详细，需要的朋友们可以直接将代码复制进行使用，下面随着小编来一起学习学习吧
2018-08-08
利用Node.js制作爬取大众点评的爬虫
相信每位用过大众点评的人都知道，大众点评上有很多美食餐馆的信息，所以这篇文章给大家分享利用Node.js实现爬取大众点评的爬虫，正好可以拿来练练手Node.js。感兴趣的可以参考借鉴。
2016-09-09
node.js中的fs.fchmod方法使用说明
这篇文章主要介绍了node.js中的fs.fchmod方法使用说明,本文介绍了fs.fchmod的方法说明、语法、接收参数、使用实例和实现源码,需要的朋友可以参考下
2014-12-12
node.js连接mongoDB数据库快速搭建自己的web服务
这篇文章主要为大家详细介绍了node.js连接mongoDB数据库，如何快速搭建自己的web服务，感兴趣的小伙伴们可以参考一下
2016-04-04
Nodejs从有门道无门菜鸟起飞必看教程
下面小编就为大家带来一篇Nodejs从有门道无门菜鸟起飞必看教程。小编觉得挺不错的，现在就分享给大家，也给大家做个参考。一起跟随小编过来看看吧
2016-07-07
在Node.js中处理Promise中错误的示例代码
在现代JavaScript开发中,尤其在Node.js环境中,Promise已成为处理异步操作的重要方式,然而,Promise的错误处理却常常让开发者感到困惑,在这篇文章中,我们将深入探讨如何在Node.js中处理Promise中的错误,提供多个示例代码,以便于理解和实践,需要的朋友可以参考下
2024-09-09
node.js路径处理方法以及绝对路径详解
这篇文章介绍的是nodejs路径处理及绝对路径以及一个Node.js获取项目根目录的小技巧，这个内容非常实用。有需要的朋友们可以参考借鉴，下面来一起看看吧。
2016-09-09
Node.js 搭建后端服务器内置模块( http+url+querystring 的使用)
这篇文章主要介绍了Node.js搭建后端服务器内置模块(http+url+querystring的使用)，文章围绕主题展开详细的内容戒杀，具有一定的参考价值，需要的朋友可以参考一下
2022-09-09
nodejs实现解析xml字符串为对象的方法示例
这篇文章主要介绍了nodejs实现解析xml字符串为对象的方法,涉及nodejs针对xml格式字符串的解析与转换相关操作技巧,需要的朋友可以参考下
2018-03-03