【Node.js】Express---监听 GET 和 POST 请求及处理参数详解

文章目录

Express 是基于 Node.js 的轻量级 Web 应用框架，以其简洁的 API 和强大的扩展性在后端开发中广受欢迎。本文将详细介绍 Express 中如何监听 GET 和 POST 请求，并解析处理传递的参数。无论是初学者还是有经验的开发者，都可以通过本文深入理解 Express 中请求的工作原理及其最佳实践。

一、Express 概述

1. Express 框架介绍

Express 是 Node.js 生态中最常用的 Web 框架之一，具有简洁、灵活的特点。它允许开发者快速构建 Web 应用程序和 API，支持中间件机制，使得开发者可以方便地进行请求和响应的处理。

2. GET 和 POST 请求的区别

HTTP 请求中，GET 和 POST 是最常见的两种请求方法：

• GET 请求：用于请求数据，通常不携带消息体，数据通过 URL 参数传递。GET 请求的安全性较低，因为参数暴露在 URL 中。
• POST 请求：用于发送数据，消息体中包含了用户提交的数据。相比 GET 请求，POST 适合传输敏感数据或较大的数据量。

二、GET 请求的监听与参数处理

1. 监听 GET 请求

在 Express 中，可以通过

app.get()

方法来监听客户端发出的 GET 请求。

app.get()

接受两个参数：第一个参数是请求的路径，第二个参数是处理该请求的回调函数。下面是一个简单的示例：

const express =require('express');const app =express();

app.get('/hello',(req, res)=>{
  res.send('Hello, GET request!');});

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

在这个示例中，Express 监听

/hello

路径上的 GET 请求，当客户端访问

http://localhost:3000/hello

时，服务器将返回字符串 “Hello, GET request!”。

2. 处理 URL 参数

GET 请求中通常会通过 URL 附带查询参数，这些参数可以通过

req.query

获取。假设我们希望在请求 URL 中传递用户名，可以修改上述代码如下：

app.get('/user',(req, res)=>{const name = req.query.name;
  res.send(`Hello, ${name}`);});

当客户端访问

http://localhost:3000/user?name=John

时，服务器将返回 “Hello, John”。

3. 处理路径参数

除了查询参数，GET 请求还可以通过路径参数传递数据。路径参数是 URL 的一部分，可以通过

req.params

获取。例如，我们可以通过修改路径来获取用户名：

app.get('/user/:name',(req, res)=>{const name = req.params.name;
  res.send(`Hello, ${name}`);});

此时，访问

http://localhost:3000/user/John

将返回 “Hello, John”。这种方式比查询参数更简洁，也更适合表达资源的层次结构。

三、POST 请求的监听与参数处理

1. 监听 POST 请求

POST 请求通常用于将数据提交给服务器。我们可以通过

app.post()

方法监听 POST 请求。以下是一个简单的示例，处理用户的注册信息：

app.post('/register',(req, res)=>{
  res.send('User registered');});

在这个例子中，服务器监听

/register

路径上的 POST 请求，并在用户提交数据时返回 “User registered”。

2. 处理 POST 请求体中的数据

POST 请求的数据通常存放在请求体中，而不是通过 URL 传递。为了解析 POST 请求体中的数据，Express 需要借助

express.json()

和

express.urlencoded()

中间件。以下是处理 JSON 数据的示例：

app.use(express.json());

app.post('/register',(req, res)=>{const{ username, password }= req.body;
  res.send(`User ${username} registered with password ${password}`);});

在此示例中，服务器首先通过

express.json()

中间件解析 JSON 格式的请求体，然后在路由处理函数中通过

req.body

获取提交的数据。客户端可以通过 POST 请求将用户信息发送至

/register

，如：

POST /register HTTP/1.1
Content-Type: application/json

{"username":"JohnDoe",
  "password":"123456"}

服务器将返回 “User JohnDoe registered with password 123456”。

3. 处理 URL 编码的数据

如果客户端提交的数据是表单格式的（即

application/x-www-form-urlencoded

），我们可以使用

express.urlencoded()

中间件来解析请求体。示例如下：

app.use(express.urlencoded({extended:true}));

app.post('/register',(req, res)=>{const{ username, password }= req.body;
  res.send(`User ${username} registered with password ${password}`);});

在此示例中，

extended: true

允许解析复杂对象。客户端可以通过表单提交数据，如：

POST /register HTTP/1.1
Content-Type: application/x-www-form-urlencoded

username=JohnDoe&password=123456

服务器将处理并返回相应的响应。

四、中间件的作用与使用

1. 中间件概述

Express 中的中间件是请求处理流水线的一部分，它们在请求到达路由之前，或者在响应发送给客户端之前执行。中间件可以对请求进行处理、修改，或者终止请求。常见的中间件用途包括：

• 解析请求体
• 设置 CORS 头
• 处理身份验证和授权

2. 应用中间件

中间件可以全局应用于所有请求，或者仅针对特定路由应用。例如，

express.json()

是一个用于解析 JSON 请求体的全局中间件：

app.use(express.json());

但我们也可以将中间件限定在特定路由中使用：

app.post('/register', express.json(),(req, res)=>{const{ username, password }= req.body;
  res.send(`User ${username} registered with password ${password}`);});

在此示例中，

express.json()

仅用于

/register

路由的 POST 请求。

五、GET 和 POST 请求的应用场景

1. GET 请求的常见应用场景

GET 请求适用于获取资源数据或展示页面。由于 GET 请求的参数会暴露在 URL 中，因此不适合传递敏感信息。常见的应用场景包括：

• 获取用户列表：/users
• 查看文章详情：/article/:id
• 搜索功能：/search?query=keyword

2. POST 请求的常见应用场景

POST 请求适合提交数据到服务器，特别是涉及到敏感信息或需要修改服务器资源的场景。常见的应用场景包括：

• 用户注册或登录：/register，/login
• 提交表单数据：/submit-form
• 上传文件：/upload

六、最佳实践与注意事项

1. 安全性

在使用 GET 请求时，避免在 URL 中传递敏感数据，如用户密码或 API 密钥。应优先使用 POST 请求或通过 HTTPS 加密传输。

2. 数据校验

无论是 GET 还是 POST 请求，都应对传入的数据进行校验，避免注入攻击或无效数据的传递。可以使用 Express 的中间件或其他库（如

express-validator

）进行数据验证。

3. 错误处理

应在处理请求时添加适当的错误处理机制，确保在出现错误时能够返回明确的响应。Express 中的错误处理中间件可以帮助捕获和处理异常。

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

七、总结

Express 提供了便捷的方法来监听和处理 GET 与 POST 请求。通过合理使用路由和中间件，开发者可以轻松处理各种类型的请求，并确保请求数据的安全性与完整性。在实际开发中，理解 GET 与 POST 请求的区别，并根据场景选择合适的请求类型，能够帮助你更好地设计和构建 Web 应用程序。希望本文能帮助你更好地理解 Express 中请求处理的细节，为你的开发之旅提供帮助。

推荐：

• JavaScript
• react
• vue