如何使用脚手架工具开始，快速搭建一个 Express 项目的基础架构

前言

将从如何使用脚手架工具开始，快速搭建一个 Express 项目的基础架构。接着，文章将详细讲解 Express 中间件的概念、分类以及如何有效地使用中间件来增强应用的功能和性能。最后，我们将讨论如何制定合理的接口规范，以确保 API 的一致性和可维护性。

一、下载express模版

1. 根据创建的自定义bincli命令下载express模版代码

bincli create express-project

2. 切换express-project项目，打开终端命令

cd express-project
npm install

3. 查看package.json是否安装了nodemon,没有的话重安一下

npm i nodemon

4. 运行项目

npm run dev

报错原因:运行Express 应用时遇到了一个 ReferenceError，具体来说是因为在 app.js 文件中使用了一个未定义的变量 router。

二、Express中间件与接口规范

1、启动项目

• 修改app.js

const express = require("express");
const app = express();const PORT = process.env.PORT || 3000;function logs(req) {console.log(`${req.method},${req.url},${Date.now()}`);
}app.get("/", (req, res) => {logs(req);res.send("/home");
});
app.get("/register", (req, res) => {logs(req);res.send("register");
});
app.get("/login", (req, res) => {logs(req);res.send("/login");
});
app.listen(PORT, () => {console.log(`Server is running at http://localhost:${PORT}`);
});

• 运行项目

npm run dev

• 打开postman客服端,send发送请求查看

2、注册中间件函数。

app.use()是 Express 应用的一个方法,这里注册的中间件将应用于所有路由。其中(req, res, next) => { ... } 是一个箭头函数，它接受三个参数。

• req：请求对象，包含了请求的所有信息，如请求方法、URL、请求头和请求体等。
• res：响应对象，用于发送响应给客户端。
• next：一个函数，调用它将请求传递给下一个中间件函数。如果不调用 next()，请求将停止处理。

修改app.js

const express = require("express");
const app = express();const PORT = process.env.PORT || 3000;
app.use((req, res, next) => {console.log(`${req.method},${req.url},${Date.now()}`);next();
});app.get("/", (req, res) => {res.send("/home");
});
app.get("/register", (req, res) => {res.send("register");
});
app.get("/login", (req, res) => {res.send("/login");
});
app.listen(PORT, () => {console.log(`Server is running at http://localhost:${PORT}`);
});

注意：在 Express 应用中，中间件的执行顺序非常重要，因为它决定了请求处理的流程。app.use() 方法用于注册中间件函数，这些函数会按照它们被注册的顺序依次执行。如果中间件没有正确放置，可能会导致请求不经过预期的中间件处理，从而影响应用的行为。

三、Express中间件分类

1、应用程序级别中间件

应用程序级别中间件是绑定到 Express 应用实例的中间件。它对所有路由和请求都有效。
使用场景:适用于全局的请求处理，如日志记录、身份验证等。

app.use(function (req, res, next) {// 执行中间件逻辑next();
});

2、路由级别中间件

路由级别中间件是绑定到特定路由的中间件。它只对特定路由的请求有效。
使用场景:适用于特定路由的请求处理，如特定路径的权限检查、数据预处理等

• 修改app.js

app.get('/', function (req, res, next) {console.log(req.method);next();
}, function (req, res, next) {console.log('route')next();
});

• 启动项目

npm run dev

• 打开postman客户端，发送请求

3、错误处理中间件

错误处理中间件用于捕获和处理在中间件链中发生的错误。
使用场景:通常放在所有其他中间件之后，以便捕获所有未处理的错误。

app.use(function (err, req, res, next) {// 处理错误console.error(err.stack);res.status(500).send('服务器内部错误');
});

4、内置中间件

Express API 参考手册

Express 内置了一些中间件函数，用于处理常见的任务。

express.static：用于提供静态文件服务。
express.json()：用于解析 JSON 格式的请求体。
express.urlencoded()：用于解析 URL 编码格式的请求体。

1. express.Router() 用于创建模块化的路由处理器

• 修改 router/index.js

const express = require('express')
const router = express.Router()
router.get('/', (req, res, next) => {console.log(req.method);res.send('/home')
})router.get('/user', (req, res, next) => {console.log(req.method);res.send('/users')
})
module.exports = router

• 修改app.js

const express = require("express");
const router = require('./router/index.js');
const app = express();
app.use(router);const PORT = process.env.PORT || 3000;
app.listen(PORT, () => {console.log(`Server is running at http://localhost:${PORT}`);
});

• 运行项目

npm run dev

• 打开客户端postman

2. 添加路由的路径前缀。

• app.js

const express = require("express");
const router = require('./router/index.js');
const app = express();
// 任何以 'node' 开头的请求路径都会被这个路由处理器处理。
app.use('node', router);const PORT = process.env.PORT || 3000;
app.listen(PORT, () => {console.log(`Server is running at http://localhost:${PORT}`);
});

• 运行项目

npm run dev

• 打开客户端postman

未添加node前缀显示请求错误

添加node前缀后

3. 404 错误处理中间件，当请求的路径没有匹配到任何定义的路由时，这个中间件会被调用，通常放在所有路由定义之后，确保它是最后一个中间件。

app.use((req, res, next) => {res.status(404).send('404 Not Found')
});

4. 500 错误处理中间件,用于捕获和处理在应用中发生的错误，在所有其他中间件之后。

app.use((err, req, res, next) => {console.log(err);res.status(500).send('Service Error')
});

5、第三方中间件

第三方中间件是由社区开发的中间件，提供了各种功能扩展。

const cors = require('cors');
const morgan = require('morgan');
app.use(cors());
app.use(morgan('combined'));