使用Node编写轻量级后端快速入门
使用Node编写轻量级后端快速入门
node 要作为轻量级后端需要下载一些对应模块可以参考下面命令。你可以借助 npm
(Node Package Manager)来下载它们。
模块下载
express
:这是一个广受欢迎的 Node.js Web 应用框架,能用于构建 Web 服务器与 API。
下载命令:
npm install express
cors
:该模块用于解决跨域资源共享(CORS)问题,允许服务器接受来自不同源的请求。
下载命令:
npm install cors
mysql2/promise
:此模块为 MySQL 数据库提供了支持,并且采用了 Promise 风格的 API。
下载命令:
npm install mysql2
multer
:这是一个用于处理multipart/form-data
类型表单数据的中间件,通常用于文件上传。
下载命令:
npm install multer
fs
:它是 Node.js 的内置模块,用于文件系统操作,无需额外下载。
你可以在项目根目录下打开终端,依次执行上述 npm install
命令来下载所需模块。或者,你也可以一次性安装所有模块,使用如下命令:
npm install express cors mysql2 multer
执行完上述命令后,package.json
文件会自动更新,记录这些依赖项。
作为Web端的必须模块你必须下载
express
,cors
,multer
快速开始
const express = require('express');
const cors = require('cors');const app = express();
const hostname = '127.0.0.1';
const port = 3000;// 使用 cors 中间件
app.use(cors());// 解析 JSON 格式的请求体
app.use(express.json());// 根路径接口
app.get('/', (req, res) => {res.send('Hello World');
});// /data 接口
app.get('/data', (req, res) => {const data = { message: 'This is some data' };res.json(data);
});// 404 处理
app.use((req, res) => {res.status(404).send('Not Found');
});// 启动服务器
app.listen(port, hostname, () => {console.log(`Server running at http://${hostname}:${port}/`);
});
上述代码即node作为web端的基础
Node 后端服务各类请求的接收数据处理方式解读
在 Node.js 后端服务开发中,正确处理各类请求的接收数据至关重要。它直接关系到应用程序的功能完整性、安全性以及性能表现。本文将深入探讨 Node.js 中处理不同类型请求数据的常见方式。
一、HTTP 请求方法基础
在 Web 开发中,常见的 HTTP 请求方法有 GET、POST、PUT、DELETE 等。每种方法都有其特定的用途和数据传递方式。
- GET 请求:通常用于从服务器获取资源。其数据通过 URL 的查询参数传递,例如:http://example.com/api/users?page=1&limit=10。这种方式下,数据暴露在 URL 中,所以不太适合传递敏感信息,并且对数据长度有限制。
- POST 请求:主要用于向服务器提交数据,比如用户注册、登录信息等。数据包含在请求体中,不会显示在 URL 里,适合传输较大或敏感的数据。
- PUT 请求:一般用于更新服务器上的资源,将完整的资源数据发送到服务器指定的 URL。
- DELETE 请求:用于删除服务器上特定 URL 对应的资源。
二、Node.js 中处理请求数据的常用工具和方法
(一)使用原生 http 模块
Node.js 内置的 http 模块提供了基本的 HTTP 服务器功能。在处理请求数据时,可以通过req对象来获取相关信息。
- 处理 GET 请求数据
const http = require('http');
http.createServer((req, res) => {const url = new URL(req.url, 'http://' + req.headers.host);const params = Object.fromEntries(url.searchParams);// 这里的params就是解析后的GET请求参数对象res.writeHead(200, {'Content-Type': 'text/plain'});res.end('GET请求参数:' + JSON.stringify(params));
}).listen(3000, () => {console.log('Server running at port 3000');
});
在这段代码中,利用URL对象来解析 URL 中的查询参数,将其转换为一个对象方便后续处理。
- 处理 POST 请求数据
POST 请求的数据接收稍微复杂一些,因为数据是分块传输的,需要监听data和end事件。
const http = require('http');
http.createServer((req, res) => {let body = '';req.on('data', chunk => {body += chunk.toString();});req.on('end', () => {// 这里的body就是完整的POST请求体数据res.writeHead(200, {'Content-Type': 'text/plain'});res.end('POST请求体:' + body);});
}).listen(3000, () => {console.log('Server running at port 3000');
});
在实际应用中,还需要根据请求体的格式(如 JSON、URL 编码等)进一步解析数据。
(二)借助 Express 框架
Express 是 Node.js 中最流行的 Web 应用框架,它简化了 HTTP 服务器的开发和请求处理过程。
安装 Express 在项目目录下运行命令安装。
npm install express
- 处理 GET 请求参数
const express = require('express');
const app = express();
app.get('/users', (req, res) => {const { page, limit } = req.query;// req.query是Express提供的获取GET请求查询参数的对象res.json({ message: '获取用户列表', page, limit });
});
app.listen(3000, () => {console.log('Express server running at port 3000');
});
- 处理 POST 请求数据
要处理 POST 请求数据,首先需要使用中间件来解析请求体。对于 JSON 格式的请求体,可以使用express.json()中间件;对于 URL 编码格式的数据,可以使用express.urlencoded()中间件。
const express = require('express');
const app = express();
app.use(express.json());
app.use(express.urlencoded({ extended: true }));
app.post('/login', (req, res) => {const { username, password } = req.body;// req.body包含了解析后的POST请求体数据if (username && password) {res.json({ message: '登录成功', user: username });} else {res.status(400).json({ message: '用户名和密码不能为空' });}
});
app.listen(3000, () => {console.log('Express server running at port 3000');
});
- 处理 PUT 和 DELETE 请求
Express 处理 PUT 和 DELETE 请求的方式与 GET、POST 类似。
app.put('/users/:id', (req, res) => {const { id } = req.params;const { name, age } = req.body;// 根据id更新用户信息res.json({ message: `更新用户${id}成功`, user: { id, name, age } });
});
app.delete('/users/:id', (req, res) => {const { id } = req.params;// 根据id删除用户信息res.json({ message: `删除用户${id}成功` });
});
这里:id是路径参数,通过req.params获取。
(三)其他数据格式处理
- 处理表单数据(multipart/form - data)
当需要处理包含文件上传等复杂表单数据时,常用multer中间件。
首先安装multer:
npm install multer
const express = require('express');
const multer = require('multer');
const app = express();
const storage = multer.memoryStorage();
const upload = multer({ storage });
app.post('/upload', upload.single('file'), (req, res) => {if (req.file) {res.json({ message: '文件上传成功', file: req.file });} else {res.status(400).json({ message: '没有文件上传' });}
});
app.listen(3000, () => {console.log('Server running at port 3000');
});
在这个例子中,upload.single(‘file’)表示处理名为file的单个文件上传。
- 处理 XML 数据
如果需要处理 XML 格式的请求数据,可以使用xml2js等库将 XML 转换为 JavaScript 对象。
先安装xml2js:
npm install xml2js
const express = require('express');
const xml2js = require('xml2js');
const app = express();
const parser = new xml2js.Parser();
app.post('/xml', (req, res) => {let xmlData = '';req.on('data', chunk => {xmlData += chunk;});req.on('end', () => {parser.parseString(xmlData, (err, result) => {if (err) {res.status(400).json({ message: 'XML解析错误', error: err });} else {res.json({ message: 'XML解析成功', data: result });}});});
});
app.listen(3000, () => {console.log('Server running at port 3000');
});
Node 中如何进行参数接收
在 Node.js 开发中,参数接收是一个基础且关键的环节。无论是处理来自客户端的请求参数,还是获取命令行中传递的参数,正确且高效地接收参数对于程序的正常运行和功能实现至关重要。接下来,我们将深入探讨在 Node.js 中接收不同类型参数的方法。
一、接收命令行参数
Node.js 提供了一个全局对象process
,其中的process.argv
属性可以获取到所有命令行参数。该属性返回一个数组,数组的第一个元素总是node
命令的路径,第二个元素是正在执行的 JavaScript 文件的路径,从第三个元素开始才是实际传递的命令行参数。
假设我们有一个简单的需求:接收命令行中的一个或多个参数,并计算它们的和。可以按照以下步骤实现:
创建一个新的 JavaScript 文件,例如sum.js
。
在文件中编写如下代码:
// 定义一个变量用于保存求和结果let result = 0;// 遍历process.argv数组,从索引为2的位置开始(即实际参数的起始位置)for (let i = 2; i < process.argv.length; i++) {// 将参数转换为数值类型并累加到result中result += Number(process.argv\[i]);}// 打印求和结果console.log(result);
在命令行中运行该程序,并传递参数。例如,输入node sum.js 1 2 3
,控制台将输出6
,即传递的参数1
、2
和3
的和。
需要注意的是,process.argv
输出的参数全部是字符串类型。如果需要进行数值运算,必须先将其转换为合适的数值类型,如使用Number()
函数或+
运算符进行转换。
另外,在 ES6 中,我们可以利用解构赋值和剩余参数来更方便地处理命令行参数。示例如下:
const [, , ...args] = process.argv;// 这里的args就是所有的命令行参数数组console.log(args);
这样,args
数组将直接包含所有传递的命令行参数,而不需要手动跳过前两个元素。
二、接收 HTTP 请求参数
在 Node.js 的 Web 开发中,处理 HTTP 请求参数是非常常见的操作。HTTP 请求主要有 GET 和 POST 两种方式,它们传递参数的方式和接收参数的方法也有所不同。
(一)接收 GET 请求参数
使用原生 http 和 url 模块:Node.js 的内置http
模块用于创建 HTTP 服务器,url
模块则可以帮助我们解析 URL 中的参数。以下是一个简单的示例:
const http = require('http');const url = require('url');http.createServer((req, res) => {// 使用url.parse方法解析URL,并将第二个参数设置为true以获取查询参数对象const queryObject = url.parse(req.url, true).query;console.log(queryObject);res.writeHead(200, {'Content-Type': 'text/html'});res.end('参数已接收');}).listen(3000, () => {console.log('Server is running on port 3000');});
在这个示例中,通过url.parse(req.url, true).query
可以获取到 URL 中的查询参数,例如当请求 URL 为http://localhost:3000/?name=John&age=30
时,queryObject
将是一个包含name
和age
属性的对象,即{ name: 'John', age: '30' }
。
使用 Express 框架:Express 是 Node.js 中最流行的 Web 应用框架,它极大地简化了 HTTP 服务器的开发和请求处理。使用 Express 处理 GET 请求参数更加简洁:
const express = require('express');const app = express();app.get('/', (req, res) => {const queryParams = req.query;console.log(queryParams);res.send('参数已接收');});app.listen(3000, () => {console.log('Server is running on port 3000');});
在 Express 中,req.query
直接返回一个包含所有查询参数的对象。例如,当请求 URL 为http://localhost:3000/?product=book&price=20
时,req.query
将是{ product: 'book', price: '20' }
。
(二)接收 POST 请求参数
使用原生 http 模块:处理 POST 请求参数相对复杂一些,因为数据是包含在请求体中,且可能以流的形式分块传输。需要监听data
和end
事件来获取完整的请求体数据,然后根据数据格式进行解析。以下是一个简单的示例,假设请求体数据为 JSON 格式:
const http = require('http');http.createServer((req, res) => {let body = '';req.on('data', chunk => {body += chunk.toString();});req.on('end', () => {try {const postData = JSON.parse(body);console.log(postData);res.writeHead(200, {'Content-Type': 'text/html'});res.end('POST参数已接收');} catch (error) {res.writeHead(400, {'Content-Type': 'text/html'});res.end('请求体数据解析错误');}});}).listen(3000, () => {console.log('Server is running on port 3000');});
在这个示例中,通过监听req
的data
事件,将接收到的每一块数据累加到body
变量中。当end
事件触发时,表示请求体数据接收完毕,此时尝试将body
解析为 JSON 格式的数据。
使用 Express 框架:在 Express 中处理 POST 请求参数,通常需要借助中间件来解析请求体。对于 JSON 格式的请求体,可以使用express.json()
中间件;对于 URL 编码格式的数据,可以使用express.urlencoded()
中间件。示例如下:
const express = require('express');const app = express();// 使用express.json()中间件解析JSON格式的请求体app.use(express.json());// 使用express.urlencoded()中间件解析URL编码格式的请求体app.use(express.urlencoded({ extended: true }));app.post('/login', (req, res) => {const { username, password } = req.body;if (username && password) {res.json({ message: '登录成功', user: username });} else {res.status(400).json({ message: '用户名和密码不能为空' });}});app.listen(3000, () => {console.log('Server is running on port 3000');});
在这个示例中,express.json()
和express.urlencoded()
中间件会将请求体数据解析后挂载到req.body
上,我们可以直接从req.body
中获取相应的参数。例如,当发送一个包含username
和password
的 JSON 格式的 POST 请求时,req.body
将包含这些参数,我们可以通过req.body.username
和req.body.password
来获取它们的值。
三、其他参数接收场景
(一)处理表单数据(multipart/form - data)
当涉及文件上传等复杂表单数据时,需要使用专门的中间件来处理。multer
是一个常用的处理multipart/form - data
类型表单数据的中间件。
首先,需要安装multer
:npm install multer
。
以下是一个简单的文件上传示例:
const express = require('express');const multer = require('multer');const app = express();const storage = multer.memoryStorage();const upload = multer({ storage });app.post('/upload', upload.single('file'), (req, res) => {if (req.file) {res.json({ message: '文件上传成功', file: req.file });} else {res.status(400).json({ message: '没有文件上传' });}});app.listen(3000, () => {console.log('Server is running on port 3000');});
在这个示例中,upload.single('file')
表示处理名为file
的单个文件上传。当文件上传成功时,req.file
将包含上传文件的相关信息,如文件名、文件类型、文件内容等。
(二)处理 XML 数据
如果需要处理 XML 格式的请求数据,可以使用xml2js
等库将 XML 转换为 JavaScript 对象。
先安装xml2js
:npm install xml2js
。
示例代码如下:
const express = require('express');const xml2js = require('xml2js');const app = express();const parser = new xml2js.Parser();app.post('/xml', (req, res) => {let xmlData = '';req.on('data', chunk => {xmlData += chunk;});req.on('end', () => {parser.parseString(xmlData, (err, result) => {if (err) {res.status(400).json({ message: 'XML解析错误', error: err });} else {res.json({ message: 'XML解析成功', data: result });}});});});app.listen(3000, () => {console.log('Server is running on port 3000');});
在这个示例中,通过监听req
的data
事件获取 XML 数据,当end
事件触发时,使用xml2js
的Parser
将 XML 数据解析为 JavaScript 对象,并根据解析结果返回相应的响应。