express教程 express路由 express中间件 express静态资源 express mongodb

express路由

栏目： express 发布时间：2024-12-13

在Express框架中，路由是应用的核心部分，它定义了应用的端点和如何处理这些端点上的请求。通过路由，你可以将客户端的请求映射到服务器端的处理函数上，从而实现不同的功能。以下是一篇详细的Express路由教程。

一、路由的基本概念

路由是什么：路由是指客户端（如浏览器）请求的URL与服务器处理函数之间的映射关系。
路由的组成部分：
- 路径（Path）：URL的路径部分，如/users。
- 方法（Method）：HTTP请求方法，如GET、POST、PUT、DELETE等。
- 处理函数（Handler）：用于处理请求的回调函数。

二、定义基本路由

引入Express：创建一个新的JavaScript文件（如app.js），并在其中引入Express模块。
```
const express = require('express');
const app = express();
```
定义GET路由：使用app.get()方法定义一个GET请求的路由处理函数。
```
app.get('/', (req, res) => {
    res.send('Welcome to the homepage!');
});
```

定义POST路由：使用app.post()方法定义一个POST请求的路由处理函数。

app.post('/submit', (req, res) => {
    // 处理POST请求的数据
    const data = req.body; // 注意：需要配置body-parser中间件来解析请求体
    res.send('Data received: ' + JSON.stringify(data));
});

启动服务器：使用app.listen()方法启动服务器。

const port = 3000;
app.listen(port, () => {
    console.log(`Server is running on port ${port}`);
});

三、路由参数

动态路由参数：使用:定义动态路由参数，这些参数可以在处理函数中通过req.params对象访问。
```
app.get('/user/:id', (req, res) => {
    const userId = req.params.id;
    res.send(`User ID: ${userId}`);
});
```
查询参数：查询参数可以通过URL中的?后面的键值对形式传递，并在处理函数中通过req.query对象访问。
```
app.get('/search', (req, res) => {
    const query = req.query.q;
    res.send(`Search query: ${query}`);
});
```

四、路由中间件

什么是中间件：中间件是请求处理管道中的函数，可以访问请求对象（req）、响应对象（res）和管道中的下一个中间件函数（next）。

使用中间件：中间件可以使用app.use()或路由对象的use()方法定义。

app.use((req, res, next) => {
    console.log('Request received');
    next();
});

const userRouter = express.Router();
userRouter.use((req, res, next) => {
    console.log('User router middleware');
    next();
});
userRouter.get('/profile', (req, res) => {
    res.send('User profile');
});
app.use('/user', userRouter);

五、路由模块化

为什么需要模块化：随着应用的增长，路由数量会越来越多，为了保持代码的清晰和可维护性，可以将路由模块化。

创建路由模块：创建一个新的JavaScript文件（如userRoutes.js），并在其中定义与用户相关的路由。

const express = require('express');
const router = express.Router();

router.get('/profile', (req, res) => {
    res.send('User profile');
});

router.get('/settings', (req, res) => {
    res.send('User settings');
});

module.exports = router;

在主应用中引入路由模块：在主应用文件（如app.js）中引入并使用路由模块。

const express = require('express');
const app = express();
const userRoutes = require('./userRoutes');

app.use('/user', userRoutes);

const port = 3000;
app.listen(port, () => {
    console.log(`Server is running on port ${port}`);
});

六、路由的匹配顺序

顺序的重要性： Express会按照路由定义的顺序进行匹配，因此路由的定义顺序会影响请求的处理结果。
最佳实践：
- 将更具体的路由放在前面。
- 将通用路由（如404错误处理）放在最后。

七、处理路由错误

错误处理中间件：使用四个参数的中间件函数来处理路由中的错误。

app.use((err, req, res, next) => {
    console.error(err.stack);
    res.status(500).send('Something broke!');
});

在路由处理函数中触发错误：使用next(error)将错误传递给错误处理中间件。

app.get('/error', (req, res, next) => {
    const error = new Error('Something went wrong!');
    next(error);
});

通过以上步骤，你应该已经对Express路由有了深入的了解，并能够使用它创建功能丰富的Web应用。

本文地址：https://www.tides.cn/p_express-router