271 lines
8.1 KiB
Markdown
271 lines
8.1 KiB
Markdown
# *coder station* 前台系统笔记
|
||
|
||
|
||
|
||
## 准备工作
|
||
|
||
|
||
|
||
1. **启动服务器**
|
||
|
||
首先从课件资料拿到服务器的项目目录coderstation-server(express+mongo)，进入项目根目录，安装依赖：
|
||
|
||
```js
|
||
npm i
|
||
```
|
||
|
||
启动服务器：
|
||
|
||
```js
|
||
npm start
|
||
```
|
||
|
||
如果看到控制台如下的输出：
|
||
|
||
```js
|
||
服务器端已启动，监听 7001 端口...
|
||
coderstation 数据库已经连接...
|
||
```
|
||
|
||
说明服务器已经启动成功。
|
||
|
||
|
||
|
||
2. **数据恢复**
|
||
|
||
在课件资料中，你还能看到提前准备好了一些数据，coderstationData，接下来可以将数据进行一个恢复。
|
||
|
||
首先需要你安装 *Mongodb*：*https://www.mongodb.com/*
|
||
|
||
|
||
|
||
接下来下载 mongodb
|
||
|
||
<img src="https://xiejie-typora.oss-cn-chengdu.aliyuncs.com/2022-11-09-062943.png" alt="image-20221109142943156" style="zoom:50%;" />
|
||
|
||
*Mac* 系统建议放置到 /usr/local/mongodb
|
||
|
||
<img src="https://xiejie-typora.oss-cn-chengdu.aliyuncs.com/2022-11-09-063106.png" alt="image-20221109143105682" style="zoom:50%;" />
|
||
|
||
要启动 mongodb，需要 bin 目录下面的 mongod
|
||
|
||
后期可能会用到很多其他的可执行文件
|
||
|
||
<img src="https://xiejie-typora.oss-cn-chengdu.aliyuncs.com/2022-11-09-063207.png" alt="image-20221109143207171" style="zoom:50%;" />
|
||
|
||
新版本的 mongodb，有一个特点就是 bin 目录下面的可执行文件大大减少，如果想要补全，需要自己去官网下载，下载下来是一个压缩包，解压就会得到一堆可执行文件，放入到 *Mongodb* 安装目录的 *bin* 目录下面
|
||
|
||
|
||
|
||
启动 *Mongodb*，使用 *Mongod* 可执行文件
|
||
|
||
```js
|
||
./mongod -f 配置文件地址
|
||
例如：
|
||
./mongod -f /usr/local/mongodb/mongodb.conf
|
||
```
|
||
|
||
<img src="https://xiejie-typora.oss-cn-chengdu.aliyuncs.com/2022-11-09-063605.png" alt="image-20221109143605101" style="zoom:50%;" />
|
||
|
||
配置文件的内容如下：
|
||
|
||
```js
|
||
systemLog:
|
||
destination: file # 日志输出方式。file/syslog,如果是file，需指定path，默认是输出到标准输出流中
|
||
path: /usr/local/mongodb/mongod.log # 日志路径
|
||
logAppend: true # 启动时，日志追加在已有日志文件内还是备份旧日志后，创建新文件记录日志, 默认false
|
||
|
||
net:
|
||
port: 27017 # 监听端口，默认27017
|
||
bindIp: 127.0.0.1 # 绑定监听的ip，设置为127.0.0.1时，只会监听本机
|
||
maxIncomingConnections: 65536 # 最大连接数，可接受的连接数还受限于操作系统配置的最大连接数
|
||
wireObjectCheck: true # 校验客户端的请求，防止错误的或无效BSON插入,多层文档嵌套的对象会有轻微性能影响,默认true
|
||
|
||
processManagement:
|
||
fork: true # 后台运行
|
||
|
||
security:
|
||
authorization: disabled # enabled/disabled # 开启客户端认证
|
||
|
||
storage:
|
||
dbPath: /usr/local/mongodb/data # 数据库地址
|
||
```
|
||
|
||
> 注意：*Windows* 下面自带配置文件，后缀为 cfg，然后还有就是 *windows* 下面的配置文件的格式会有一些区别
|
||
|
||
|
||
|
||
建议安装一个数据库可视化工具，这个自由选择：
|
||
|
||
- *robo3t*
|
||
- *stduio3t*：基础功能是免费的，*https://studio3t.com/*
|
||
- *compass*：mongo 官方推出的可视化工具
|
||
- *navicat*
|
||
|
||
|
||
|
||
关于数据的恢复，这边需要使用到一个可执行命令，*mongorestore*，还需要保证 *mongodb* 的数据库服务器是启动起来的
|
||
|
||
<img src="https://xiejie-typora.oss-cn-chengdu.aliyuncs.com/2022-11-09-064349.png" alt="image-20221109144349195" style="zoom:50%;" />
|
||
|
||
```js
|
||
mongorestore -h dbhost -d dbname --dir dbdirectory
|
||
例如：
|
||
./mongorestore -h localhost:27017 -d coderstation2 --dir /Users/jie/Desktop/coderstationData
|
||
```
|
||
|
||
如果你在恢复数据的时候，名字取了其他名字，服务器那边也需要修改成对应的名字：
|
||
|
||
<img src="https://xiejie-typora.oss-cn-chengdu.aliyuncs.com/2022-11-09-064932.png" alt="image-20221109144932400" style="zoom:50%;" />
|
||
|
||
|
||
|
||
3. **数据接口**：*https://yapi.duyiedu.com/project/387/interface/api*
|
||
|
||
|
||
|
||
4. **本次项目讲解约定**
|
||
- 这一次项目不会像个人博客，把所有的功能就讲解，只会讲解核心的功能，重复的代码模块大家自己完成
|
||
- 上课的时候不会带着写 *CSS*，涉及到 *CSS* 的时候会直接使用成品里面的 *CSS*
|
||
- 关于 *JSX* 部分，只会挑一些重要的来讲的，有一些 *JSX* 会直接从成品里面拿过来
|
||
|
||
|
||
|
||
## 项目笔记
|
||
|
||
1. 有关 *CSS*
|
||
|
||
当我们书写 *CSS* 的时候，如果 *CSS* 文件名包含 *module*，格式为 *xxx.module.css*，那么说明该 *CSS* 是一个局部的 *CSS* 样式文件，类似于 *vue* 组件里面的 *scoped*
|
||
|
||
|
||
|
||
2. *Icon*
|
||
|
||
如果要使用 *Icon*，*Antd* 为我们提供了很多实用的 *Icon*，对应的地址为：*https://ant.design/components/icon/*
|
||
|
||
每一个 *Icon*，使用之前需要引入，例如：
|
||
|
||
```js
|
||
import { UserOutlined } from "@ant-design/icons";
|
||
```
|
||
|
||
|
||
|
||
3. 请求转发
|
||
|
||
在 *src* 目录下面新建一个 *setupProxy* 的文件，在该文件中进行请求转发的配置
|
||
|
||
在使用的时候，还需要安装一个插件 *http-proxy-middleware*，配置示例如下：
|
||
|
||
```js
|
||
const { createProxyMiddleware } = require("http-proxy-middleware");
|
||
|
||
module.exports = function(app){
|
||
app.use(createProxyMiddleware("/res", {
|
||
target: "http://127.0.0.1:7001",
|
||
changeOrigin : true
|
||
}),createProxyMiddleware("/api", {
|
||
target: "http://127.0.0.1:7001",
|
||
changeOrigin : true
|
||
}),createProxyMiddleware("/static", {
|
||
target: "http://127.0.0.1:7001",
|
||
changeOrigin : true
|
||
}))
|
||
}
|
||
```
|
||
|
||
|
||
|
||
4. 如何渲染出 *svg* 图片
|
||
|
||
之前在使用 *vue* 做个人博客的时候，如果想要渲染一段 *html* 或者 *svg*，需要使用 *v-html*
|
||
|
||
在 *react* 中，可以通过如下的方式：
|
||
|
||
```react
|
||
<div dangerouslySetInnerHTML={{ __html: captcha }}></div>
|
||
```
|
||
|
||
|
||
|
||
5. 如何修改打包后的目录
|
||
|
||
由于我们的静态资源以 *static*，所以我们配置了请求转发，但是 *create-react-app*（基于 *webpack*）默认在打包应用的时候，也会将打包好的资源放置到 *static* 目录下，导致在加载打包好后的资源时，也会进行请求转发，从而报错。
|
||
|
||
我们需要做的是修改打包好后的目录。首先运行下面的命令：
|
||
|
||
```js
|
||
npm run eject
|
||
```
|
||
|
||
> 注意：弹射的时候要求 *git* 仓库不能有未提交的文件
|
||
|
||
弹射出来后，会多出来很多隐藏文件，我们就可以修改对应的配置，但是会有一个关于 *Babel* 的错误，最快的解决方案就是在 *package.json* 中删除如下的配置：
|
||
|
||
```js
|
||
"eslintConfig": {
|
||
"extends": [
|
||
"react-app",
|
||
"react-app/jest"
|
||
]
|
||
},
|
||
```
|
||
|
||
接下来，在弹射出来的配置文件中，我们就可以修改 *webpack* 的打包配置：
|
||
|
||
*config/webpack.config.js* 的 *output* 对应的配置
|
||
|
||
```js
|
||
filename: isEnvProduction
|
||
? 'assets/js/[name].[contenthash:8].js'
|
||
: isEnvDevelopment && 'assets/js/bundle.js',
|
||
// There are also additional JS chunk files if you use code splitting.
|
||
chunkFilename: isEnvProduction
|
||
? 'assets/js/[name].[contenthash:8].chunk.js'
|
||
: isEnvDevelopment && 'assets/js/[name].chunk.js',
|
||
assetModuleFilename: 'assets/media/[name].[hash][ext]',
|
||
```
|
||
|
||
|
||
|
||
6. 关于 *redux* 中将异步获取到的数据填充到状态仓库
|
||
|
||
之前我们介绍了一种方式，是通过 *action* 来派发一个 *reducer* 从而实现状态填充。例如之前所写学生管理系统：
|
||
|
||
```js
|
||
export const getStuListAsync = createAsyncThunk(
|
||
"stu/getStuListAsync",
|
||
async (_, thunkApi) => {
|
||
// 发送 ajax 请求
|
||
const response = await getStuListApi();
|
||
// 派发 action
|
||
thunkApi.dispatch(initStuList(response.data));
|
||
}
|
||
);
|
||
```
|
||
|
||
也可以使用 *redux-toolkit* 官网所示例的方式：
|
||
|
||
```js
|
||
export const getTypeList = createAsyncThunk(
|
||
"type/getTypeList",
|
||
async ()=>{
|
||
const response = await getType();
|
||
// 填充返回的数据到状态仓库
|
||
return response.data;
|
||
}
|
||
);
|
||
|
||
// ....
|
||
|
||
// 专门处理异步的 reducer
|
||
extraReducers : {
|
||
// 这里就会有三种状态
|
||
[getTypeList.fulfilled] : (state, { payload }) => {
|
||
state.typeList = payload;
|
||
}
|
||
}
|
||
```
|
||
|
||
|