原文:How to create a React frontend and a Node/Express backend and connect them
作者:João Henrique
译者:博轩
在本文中,我将引导你创建一个简单的 React
应用,以及一个简单的 Node/Express API
,并将两者相互连接。
我不会详细介绍本文中提到的任何技术,但是我会留下链接,以便你想了解更多信息。
您可以在我为本教程制作的代码库中找到源码。
译注:嘤嘤嘤,我也写了 Demo 的 … client-react-001,api-node-001
这里的目标是为您提供有关如何设置和连接 前端客户端 和后端 API的实用指南。
在我们开始之前,确保您的机器上已经安装了 Node.js
创建项目主目录
在终端,导航到你要保存项目的目录。现在为您的项目创建一个新目录并导航到它:
mkdir my_awesome_project
cd my_awesome_project
创建一个 React 应用
这个过程非常简单。
我们将使用 Facebook 的 create-react-app 来 … 你猜对了,简单的创建一个名为 client
的应用程序:
npx create-react-app client
cd client
npm start
让我们看看这里做了什么:
1. 使用 npm 的 npx 创建一个 React 应用,并将其命名为 client
。
2.cd(更改目录)到客户端目录中。
3. 启动了应用程序。
在浏览器中,访问:http://localhost:3000/
如果一切正常,您将看到 React 欢迎页面。恭喜!这意味着您现在在本地计算机上运行了一个基本的 React 应用程序。是不是很简单?
要停止您的 React 应用程序,只需在终端按下 Ctrl + c
即可。
创建一个 Express 应用
好的,这将与前一个示例同样简单。不要忘记回到项目的根文件夹。
我们将使用 Express Application Generator 快速生成应用的框架,并将其命名为 api
:
npx express-generator api
cd api
npm install
npm start
让我们看看这里做了什么:
1. 使用 npm 的 npx 在全局安装 express-generator
。
2. 使用 express-generator
快速创建一个 express
应用,并将其命名为:api
。
3. 进入 API
目录。
4. 安装所有依赖项。
5. 启动应用。
在浏览器中,访问:http://localhost:3000/
如果一切正常,您将看到 Express 欢迎页面。恭喜!这意味着您现在在本地计算机上运行了一个基本的 Express 应用程序。是不是很简单?
要停止您的 Express 应用程序,只需在终端按下 Ctrl + c
即可。
在 Express 中配置新的路由
好啦,接下来就是动手时间。是时候打开你最喜欢的代码编辑器(我正在使用 VS Code)并导航到你的项目文件夹。
如果您将 React 应用 命名为 client,Express 应用 命名为 api,你讲找到两个主要文件夹:client 和 api。
1. 在 api 目录中,打开 bin/www
并将第 15 行的端口号由 3000 改为 9000。我们将同时运行两个应用程序,这样做可以避免问题。修改结果如下:
// my_awesome_project/api/bin/www
var port = normalizePort(process.env.PORT || '9000');
2. 在 api/routes 上,创建一个 testAPI.js 文件并粘贴如下代码:
var express = require(“express”);
var router = express.Router();
router.get(“/”, function(req, res, next) {res.send(“API is working properly”);
});
module.exports = router;
3. 在 api/app.js 文件中,在第 24 行插入新路由:
app.use("/testAPI", testAPIRouter);
4. 并在第 9 行引入新的路由文件
var testAPIRouter = require("./routes/testAPI");
5. 恭喜您!您已经创建了新的路由。
如果您启动 api
应用程序(在终端中,导航到 api
目录,输入 npm start),并在浏览器中访问 http://localhost:9000/testAPI,您将看到以下消息:API is working properly。
译注:可以使用 npm 模块 forever 来守护你的进程,方便你之后在其他机器上部署服务。
将 React Client 连接到 Express API
1. 让我们使用代码编辑器打开 client 目录,编辑 app.js。
2. 我将会使用 Fetch API 从 api 模块获取数据。在 Class 声明之后,render 方法之前粘贴如下代码:
constructor(props) {super(props);
this.state = {apiResponse: ""};
}
callAPI() {fetch("http://localhost:9000/testAPI")
.then(res => res.text())
.then(res => this.setState({ apiResponse: res}));
}
componentWillMount() {this.callAPI();
}
3. 在 render 方法中,你会找到一个 <p>
标签。让我们用它来展示 API 的内容。
<p className="App-intro">;{this.state.apiResponse}</p>
这是,该文件展示如下:
让我们看看这里做了什么:
1. 在第 6 到 9 行,我们插入了一个初始化默认状态的构造函数。
2. 在第 11 到 16 行,我们插入了方法 callAPI()
,它将从 API 获取数据,并存储在 this.state.apiResponse
上。
3. 在第 18 行到第 20 行,我们插入了一个名为 componentDidMount()
的 react 生命周期方法,该方法将在组件安装后执行 callAPI()
方法。
4. 最后,在第 29 行,我使用 <p>
标签在我们的客户端页面上显示一个段落,其中包含我们从 API 获取的文本。
有没有搞错!!CORS?
到这里,我们差不多完成了。当我们启动应用程序(client
和 API
),访问 http://localhost:3000/,发现并没有看到预期的结果。如果你打开 chrome 开发者工具,您将在控制台找到原因:
Failed to load http://localhost:9000/testAPI: No‘Access-Control-Allow-Origin’header is present on the requested resource. Origin‘http://localhost:3000′ is therefore not allowed access. If an opaque response serves your needs, set the request’s mode to‘no-cors’to fetch the resource with CORS disabled.
这很好解决。我们只需要在我们的 API 中添加 CORS 允许跨域请求。有关 CORS,我们可以查看上面的链接了解更多信息。
1. 在终端中导航到 api
目录,并安装 CORS 依赖。
npm install --save cors
2. 打开 my_awesome_project/api/app.js
文件,添加如下代码:
var cors = require("cors");
...
app.use(cors());
API app.js
文件最终应该是这样的:
干的漂亮。我们完成了!!
现在使用 npm start 启动两个应用 client
和 API
。
访问 http://localhost:3000/ 你会看到如下内容:
当然,这个项目的代码不会很多,但却是全栈项目的开始。你可以在这个仓库中,找到项目的所有代码。
接下来,我会补充一些教程,比如将它连接到 MongoDB 数据库,甚至是在 Docker 容器中运行它。
译注:这是我部署的应用地址,下一篇我也会翻译吧。
就像我的一位好友对我说到:
Be Strong and Code On!!!
… 别忘了今天也是美好的一天????
本文已经联系原文作者,并授权翻译,转载请保留原文链接