NodeTskeleton 项目教程
1. 项目的目录结构及介绍
NodeTskeleton 是一个基于 Clean Architecture 的 Node.js 项目模板,使用 TypeScript 编写。以下是项目的目录结构及其介绍:
NodeTskeleton/
├── src/
│ ├── adapters/
│ │ ├── controllers/
│ │ └── repositories/
│ ├── application/
│ │ ├── services/
│ │ └── use-cases/
│ ├── domain/
│ │ ├── entities/
│ │ └── interfaces/
│ ├── infrastructure/
│ │ ├── config/
│ │ ├── database/
│ │ └── services/
│ └── index.ts
├── package.json
├── tsconfig.json
└── README.md
src/
:项目的源代码目录。adapters/
:包含适配器层,如控制器和存储库。controllers/
:处理 HTTP 请求的控制器。repositories/
:数据访问层,处理数据库操作。
application/
:包含应用层,如服务和用例。services/
:业务逻辑服务。use-cases/
:用例,处理具体的业务逻辑。
domain/
:包含领域层,如实体和接口。entities/
:领域实体。interfaces/
:领域接口。
infrastructure/
:包含基础设施层,如配置和数据库服务。config/
:配置文件。database/
:数据库连接和操作。services/
:外部服务,如第三方 API。
index.ts
:项目的入口文件。
package.json
:项目的依赖和脚本配置。tsconfig.json
:TypeScript 编译配置。README.md
:项目说明文档。
2. 项目的启动文件介绍
项目的启动文件是 src/index.ts
,它负责初始化应用并启动服务器。以下是 index.ts
的主要内容:
import express from 'express';
import { setupControllers } from './adapters/controllers';
const app = express();
const port = process.env.PORT || 3000;
setupControllers(app);
app.listen(port, () => {
console.log(`Server running on http://localhost:${port}`);
});
express
:导入 Express 框架。setupControllers
:初始化并设置控制器。app.listen
:启动服务器并监听指定端口。
3. 项目的配置文件介绍
项目的配置文件主要位于 src/infrastructure/config/
目录下。以下是一个示例配置文件 config.ts
:
import dotenv from 'dotenv';
dotenv.config();
export const config = {
port: process.env.PORT || 3000,
database: {
host: process.env.DB_HOST || 'localhost',
port: process.env.DB_PORT || 5432,
name: process.env.DB_NAME || 'mydb',
},
};
dotenv
:加载环境变量。config
:导出配置对象,包含端口和数据库配置。
以上是 NodeTskeleton 项目的基本教程,涵盖了项目的目录结构、启动文件和配置文件的介绍。希望这些内容能帮助你更好地理解和使用该项目。