如果您想创建一个模拟 RESTful API 来测试您的前端代码,而无需设置完整的后端环境,那么 JSON 服务器将对您大有帮助。在本教程中,我们将学习命令,不仅可以在 Ubuntu 24.04 Linux 上安装 JSON 服务器,还可以通过示例学习如何使用它。
什么是 JSON 服务器?
JSON Server 是一个开源工具,旨在提供一个伪 REST API 后端,使用 JSON 文件进行原型设计和模拟,而无需执行任何编码。它允许前端开发人员快速测试他们的代码,而不是在实际进行项目的最终部署之前设置完整的后端环境。JSON Server 提供所有典型的 RESTful 路由,允许 CRUD(创建、读取、更新、删除)操作。最好的部分是它可以使用 Nodejs NPM 安装,并且可以在几乎所有操作系统上使用。
我们需要做什么才能完成本教程?
- Ubuntu 24.04 LTS Linux 系统或其任何其他版本,例如 Ubuntu 20.04、22.04 或 23.04。
- 访问 root 用户或任何具有 sudo 权限的其他用户。
- 有可用的互联网连接
如果没有Ubuntu服务器,可以考虑雨云,1元即可试用,需要绑定微信,支持多种Linux发行版。
步骤 1:访问 Ubuntu 24.04 终端
在 Ubuntu 系统上打开命令终端并运行系统更新命令以及 cURL 的安装。
sudo apt update && sudo apt upgrade && sudo apt install curl
第 2 步:安装 Node.js 和 npm
首先,我们需要在 Ubuntu 24.04 服务器或桌面上安装 Nodejs,因为 JSON Server 是基于 Node.js 构建的。好吧,要获取 Node 的最新 LTS 版本,我们需要手动添加其官方存储库,下面是执行此操作的命令。
通过 Ubuntu 24.04 系统存储库提供的 Nodejs 默认版本是 18.x,如果要使用该版本,只需输入:
"sudo apt install nodejs
而 那些想要获得最新的 Nodejs LTS 版本的人则需要手动添加其存储库。例如,在撰写本文时,最新的 LTS 版本是 20.x,因此,要获取它,请使用给定的命令:
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
安装 Nodejs 和 NPM:
添加此存储库后运行安装命令,它将与 npm(Node 包管理器)一起配置 Node.js。
sudo apt install nodejs
验证安装:
node -v
npm -v
步骤 3:在 Ubuntu 24.04 上安装 JSON 服务器
现在我们在 Ubuntu 24.04 上有了 Node.js 及其包管理器 NPM,可以使用 NPM 轻松安装 JSON Server,命令如下:
sudo npm install -g json-server
要验证 JSON 服务器的安装,请运行:
json-server --version
示例:如何使用 JSON 服务器
JSON 服务器使用一个简单的 JSON 文件作为数据库。db.json
在您想要的目录中创建一个示例 JSON 文件。在本教程中,我们将为用户和帖子创建一个简单的数据库。
创建 JSON 文件
为您的项目创建一个目录:
mkdir ~/json-server
cd ~/json-server
创建 db.json 文件:
nano db.json
添加以下示例数据:
{
"users": [
{ "id": 1, "name": "John Doe" },
{ "id": 2, "name": "Jane Doe" }
],
"posts": [
{ "id": 1, "title": "Hello World", "author": "John Doe" },
{ "id": 2, "title": "JSON Server Rocks", "author": "Jane Doe" }
]
}
保存文件并退出文本编辑器(对于 nano,按 CTRL + X,然后按 Y,再按 Enter)。
步骤 5:启动 JSON 服务器
要启动 JSON 服务器,请导航到包含 db.json 文件的目录并运行:
json-server --watch db.json
此命令启动一个 JSON 服务器,用于监视db.json 文件中的更改。默认情况下,服务器在端口3000上运行。您应该看到屏幕截图中给出的输出:
访问 API
打开 Web 浏览器或使用Curl或 Postman等工具访问 API 端点。你可以使用终端输出中提供的 URL。
例如,要获取用户列表,请导航至:
要获取帖子列表,请导航至:
结论
只需极少的设置,JSON Server 就是一款非常有用的工具,可以快速轻松地模拟 REST API。前端开发人员可以专注于他们的项目和测试,而无需等待后端服务准备就绪。