클린 아키텍처란 무엇인가? Node로 어떻게 구현하나요?

클린건축이란? 이 글은 Clean Architecture를 안내하고 Node.js를 사용하여 Clean Architecture를 구현하는 방법에 대해 설명합니다. 도움이 되기를 바랍니다.

Clean Architecture

Clean Architecture는 Robert C. Martin이 제안한 소프트웨어 아키텍처 패턴입니다. 목적은 시스템을 계층화하고 관심사를 분리하여 시스템을 더 쉽게 이해하고 유지 관리하고 확장하는 것입니다. 이 아키텍처는 시스템을 내부에서 외부까지 엔터티 계층, 사용 사례 계층, 프레젠테이션 계층, 인프라(리포지토리, 프레임워크 등)의 네 가지 수준으로 나눕니다.

이 기사에서는 Node.js를 사용하여 Clean Architecture를 구현하는 방법을 소개하고 아키텍처의 주요 개념을 보여주는 몇 가지 샘플 코드를 제공합니다.

다음으로 TypeScript 프로젝트 예제(github.com/lulusir/cle…)를 사용하겠습니다. 이 프로젝트는 Monorepo 구조를 사용하며 Rush.js를 사용하여 관리됩니다. 서버 폴더에는 core, koa 및 Nestjs-app이라는 세 개의 하위 프로젝트가 포함되어 있습니다. Core는 핵심 비즈니스 로직이고, Koa는 기본 프레임워크 웹 프로젝트로 koa+prisma를 사용하며, Nestjs-app은 Nestjs + Typeorm의 프로젝트를 사용합니다. 기본 프레임워크. 목적은 동일한 비즈니스 논리가 어떻게 서로 다른 프레임워크를 연결할 수 있는지 보여주는 것입니다. [관련 튜토리얼 추천: nodejs 비디오 튜토리얼, 프로그래밍 교육]

이 프로젝트에서 엔터티 레이어에는 엔터티 객체와 관련 비즈니스 규칙 및 로직이 포함되어 있고, 유스 케이스 레이어에는 시스템의 유스 케이스와 비즈니스 로직이 포함되어 있습니다. 저장소 계층은 데이터를 저장하고 검색하는 역할을 담당하며 프레젠테이션 계층은 외부 http 인터페이스에 노출됩니다.

프로젝트 기능:

포스트 게시 및 열람 기능 구현

• 사용자 생성, 쿼리

• 포스트 게시, 편집, 쿼리, 삭제

프로젝트 구조

rreee

• core: core는 핵심 비즈니스 로직의 코드입니다.

  • Domain: 비즈니스 관련 모델 등 엔터티 관련 코드를 저장합니다.
  • Use Cases: 비즈니스 로직, 데이터 처리 등 비즈니스 로직 관련 코드를 저장합니다.
  • Repository: 외부 저장소 시스템을 위한 저장소 및 관련 인터페이스

• koa/nestjs-app: 코어의 실제 소비자

  • 코어의 인터페이스에 따라 특정 라우터 및 저장소를 구현

프로젝트 기능

• DDD ​​및 Clean Architecture의 아이디어를 사용하여 프레임워크 구현에서 비즈니스 로직을 분리합니다.
• 모노레포 프로젝트 구조를 사용하여 여러 관련 프로젝트를 쉽게 관리하세요.
• 쉽고 빠르게 시작할 수 있도록 다양한 샘플 애플리케이션이 제공됩니다.
• TypeScript를 기반으로 코드 가독성과 유지 관리성이 향상되었습니다.

핵심에는 핵심 비즈니스 로직 코드가 있습니다. 이 수준에는 도메인, 저장소 인터페이스 및 사용 사례가 포함됩니다. 도메인에는 특정 비즈니스 모델과 같은 엔터티와 관련된 코드가 포함되어 있습니다. 저장소에는 외부 스토리지 시스템에 대한 관련 인터페이스가 포함되어 있습니다. 사용 사례에는 비즈니스 로직 처리, 데이터 유효성 검사, 리포지토리 호출 등 비즈니스 로직과 관련된 코드가 포함되어 있습니다.

koa/nestjs-app 레벨에서는 핵심 레벨에 실제 소비자가 있습니다. 이들은 코어 레이어에서 제공하는 인터페이스를 기반으로 특정 라우터와 리포지토리를 구현합니다. Clean Architecture를 사용하는 주요 이점 중 하나는 비즈니스 로직을 기술 구현과 분리한다는 것입니다. 이는 핵심 비즈니스 로직을 변경하지 않고도 다양한 프레임워크와 라이브러리 간에 쉽게 전환할 수 있음을 의미합니다. 이 예에서는 동일한 핵심 비즈니스 로직을 유지하면서 koa와 Nestjs-app 간에 전환할 수 있습니다.

코드 구현

엔티티 레이어 정의

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

저장 인터페이스 정의

// 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>;
}

koa 프로젝트

구현됨 in koa 프로젝트 스토리지 레이어 인터페이스

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 프로젝트에서 HTTP 라우팅(프레젠테이션 레이어) 구현하기

// 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");
  }
}

nest-js 프로젝트

nestjs 프로젝트 예시는 이 경로(github.com/lulusir/cle…게시하지 않겠습니다.) 여기 코드

마지막으로

실제 프로젝트에서는 핵심 비즈니스 로직을 별도의 웨어하우스(즉, 코어)에 두지 않을 것이라는 점에 유의하세요. 이는 단지 다른 프레임워크에서 동일한 비즈니스 로직을 사용하는 것을 보여주기 위한 것입니다

비즈니스를 배치하여 로직은 프레임워크와 분리되어 있으며 핵심 비즈니스 로직을 변경하지 않고도 다양한 프레임워크와 라이브러리 간에 쉽게 전환할 수 있습니다. 확장 가능하고 유지 관리 가능한 애플리케이션을 구축하려면 Clean Architecture를 고려해 볼 가치가 있습니다.

다른 프레임워크에 연결하는 방법을 보여주고 싶다면 댓글 영역에 올려주세요

프로젝트 주소 (github.com/lulusir/cle… 괜찮다고 생각하시면 별점을 주셔도 됩니다.) , 감사합니다

더 많은 노드 관련 지식을 얻으려면 nodejs 튜토리얼을 방문하세요!

위 내용은 클린 아키텍처란 무엇인가? Node로 어떻게 구현하나요?의 상세 내용입니다. 자세한 내용은 PHP 중국어 웹사이트의 기타 관련 기사를 참조하세요!