使用Node编写轻量级后端快速入门

EvLast

于 2025-05-01 23:47:22 发布

阅读量1.1k

点赞数 16

分类专栏：杂谈文章标签： arcgis node.js 后端 c5全栈

本文链接：https://blog.csdn.net/2303_79299383/article/details/147657023

版权

杂谈专栏收录该内容

9 篇文章

订阅专栏

使用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');

});