持续创作,加速成长!这是我参与「掘金日新计划 · 10 月更文挑战」的第5天,点击查看活动详情
前言
这是一个使用typescript和express的应用框架,快速搭建服务端项目。主要模块可以拆分为入口、路由、数据、工具、服务、业务。
- 应用整体入口:对整个应用的一个初始化化
- 路由模块:路由的注册
- 数据库模块:数据库连接,Model定义
- 业务功能模块:对应业务模块的逻辑处理
- 公共服务模块:提供一些公共服务,如邮件发送、excel处理等
- 帮助模块:一些工具函数,日志处理,以及环境变量
模块
此框架用到的基础依赖如下:
- typescript
- eslint:代码格式校验
- node/ts-node: 动态编译typescript代码
- nodemon:监听文件变化重启服务
- mongoose:数据库连接
- pm2:生产环境部署,方便服务的重启,以及在线日志的查看
入口
入口文件主要是对整个应用的一个初始化化,包括以下内容:
- 初始化数据库:引入数据模块,进行数据库连接。
- 初始化应用成中间件:使用app.use()注册全局中间件
- 初始化路由:引入路由模块,以及路由404捕获。
- 全局异常捕获: 在文件的最后注册错误捕获中间件函数。
import express from 'express';
import config from './helper/config';
// 数据库初始化
import './database/mongo';
const app = express();
app.use(express.json());
//文档地址
app.use('/documents',express.static(__dirname+'/documents'))
// 404路由捕获
app.get('*', function (req, res) {
console.log('Not Found');
res.sendStatus(404);
});
// 全局错误处理
app.use((err, req, res, next) => {
if (res.headersSent) {
return next(err);
}
res.status(500);
res.render('error', { error: err });
});
****
帮助文件
- 全局的环境配置:数据库host、port,应用的host,一些其他和环境相关的配置
- 日志处理,使用nodejs的插件log4js来处理日志,将日志按日期和类型保存在不同的文件中
- 工具函数,定义一些全局的工具函数
- 中间件,定义一些应用层面的中间件
路由
路由是整个express项目的骨架,从路由的定义中应该能够看出整个项目的业务结构。
- 路由注册,根据业务需求定义路由路径
- 路由嵌套根据业务拆分不同路由模块定义在不同的文件中,路由嵌套的设计在express是我们对大型项目解耦的最优方式。
//user.ts
const express = require('express');
const router = express.Router();
const app = express();
router.get('/list',(req,res,next)=>{
});
router.post('/info',(req,res,next)=>{
});
export default router
import express from 'express';
import userRouter from './user';
const router = express.Router();
router.use('/user',userRouter);
router.get('/demo',(req,res,next)=>{
});
export default router
数据库
- 数据库连接,通过mongoose与数据库创建连接
import mongoose from "mongoose";
import config from '../helpper/config';
const env = process.env.NODE_ENV;
const url = `${config[env].mongo_host}:${config[env].mongo_port}`
mongoose.connect(url,***)
******
- 数据模型定义,业务对应的数据模型定义
业务模块
拆分不同的业务模块文件,用来处理客户端的请求
import userModel from '../database/model/user';
const createUser = (req,res,next)=>{
*******
}
export default {createUser,***}
开发及部署
本地开发
- 安装应用的npm依赖后可通过运行npm run start
pnpm install
npm run start
- 设置环境变量,使用插件nodemon和ts-node来启动服务(监听文件变化重启服务)
set NODE_ENV=dev&&nodemon --watch *.ts --exec \"ts-node\" index.ts
生产部署
- 全局安装pm2
pnpm install pm2 -g
- 编译typescript代码并设置环境变量
- 使用pm2启动服务
set NODE_ENV=pro&& pm2 start ./dist/index.js
总结
为了方便日后的开发,根据自己几年express的使用经验对整个应用框架进行的整理。按照高内聚,低耦合的标准进行功能模块和目录的拆分。有兴趣的可以一起维护下,目前准备发到npm。