react+koa2+mysql零门槛的全栈体验,附上完整项目分享

2,081

写在前面

本文适用于对后端开发领域较为陌生的初级前端开发小伙伴,如果你想一个人搞定一整个项目(服务端接口定义开发+前端页面渲染+数据库搭建+服务器搭建+部署上线),希望这篇文章能给你带来一点点参考价值。

项目简介

实现简单的登录、表单的增删改查、文件上传等功能。以下是项目地址:
前端源码
服务端源码(ps:数据库rnpxDemo.sql在主目录下)

技术栈

前端

主要基于React全家桶,UI框架选用ant-design-pro。 前端部分不做过多赘述,有兴趣的可以直接查看源码。

服务端

服务端采用Nodejs,框架采用的是Koa2.0

目录结构说明

├── bin
│   ├── index.js # 项目入口文件
│   ├── www # 配置引入
├── config
│   ├── config.js # 配置项目
│   ├── db.js # 数据库配置
│   ├── redis # redis配置
│   ├── render.js # 数据接口渲染
├── app
│   ├── controllers # 操作层 执行服务端模板渲染,json接口返回数据,页面跳转
│   │   ├── admin.js
│   │   ├── index.js
│   │   ├── user.js
│   │   └── work.js
│   ├── middleware # 中间件集合
│   │   └── index.js
│   ├── models # 数据模型层 执行数据操作
│   │   └── user.js
│   ├── routers # 路由层 控制路由
│   │   ├── user.js # /user/* 子路由
│   │   ├── home.js # 主页子路由
│   │   ├── index.js # 子路由汇总文件
├── static  #静态资源

数据库

数据库采用Mysql,框架采用的是Sequelize,是一个基于promise的关系型数据库Node.js ORM框架,用起来还蛮方便,推荐使用。
安装mySql数据库 可以参考官方文档
这里顺便推荐一款比较实用的数据库管理工具:Navicat Premium

集群管理

集群管理采用PM2,是一个带有负载均衡功能的 Node 应用的进程管理器。pm2的安装和使用非常容易,具体可参考pm2的安装和使用

API文档工具

这里再分享一个能自动生成API文档的库koa2-swagger-ui,可以把 json 文件的 api 数据渲染成 swagger ui,具体使用方法可以参考项目代码。

npm i koa2-swagger-ui -D

服务端配置说明

www入口文件配置

const koa = require("koa");
const koaSwagger = require('koa2-swagger-ui');
const router = require('../app/routers/index');
const path = require('path');
const koaBody = require('koa-body');
const { cross, onerror, onheader } = require("../app/middleware");
const pkg = require("../package.json");
const app = new koa();
app.use(onerror()); // 系统错误,统一错误捕获
/*更多的配置可以拉取仓库代码进行查看*/

数据库配置

配置文件路径:/config/db.js 针对不同环境,配置不同的数据库地址:

const Sequelize = require('sequelize');
const { env } = require("./config");
let config = {};
switch (env) {
    case "dev":
        config = {
            database: 'testDB', // 使用哪个数据库
            username: 'root', // 用户名
            password: 'dev@123', // 口令
            host: '127.0.01', // 主机名
            port: 3306 // 端口号,MySQL默认3306
        };
        break;
    case "test":
        config = {
            database: 'testDB', // 使用哪个数据库
            username: 'root', // 用户名
            password: 'test@123', // 口令
            host: 'test.mysql.rds.aliyuncs.com', // 主机名
            port: 3306 // 端口号,MySQL默认3306
        };
        break;
    case "prd":
        config = {
            database: 'testDB', // 使用哪个数据库
            username: 'root', // 用户名
            password: 'prd@123', // 口令
            host: 'prd.mysql.rds.aliyuncs.com', // 主机名
            port: 3306 // 端口号,MySQL默认3306
        };
        break;
}

export const sequelize = new Sequelize(config.database, config.username, config.password, {
    host: config.host,
    dialect: 'mysql',
    pool: {
        max: 5,
        min: 0,
        idle: 30000
    }
});

路由配置

配置文件路径:/app/routers/index.js

const router = new require('koa-router')()
const home = require('./home')
const user = require("./backend/user")
const swaggerJSDoc = require('swagger-jsdoc')
const pkg = require("../../package.json")
const swaggerDefinition = {
    info: {
        title: 'API',
        version: '1.0.0',
        description: 'API',
    },
    host: `localhost:${pkg.port}`,
    basePath: '/' // Base path (optional)
};
const options = {
    swaggerDefinition,
    apis: ['./app/routers/backend/*.js', './app/routers/front/*.js'], // 写有注解的router的存放地址
};
const swaggerSpec = swaggerJSDoc(options)
// 通过路由获取生成的注解文件
router.get('/swagger.json', async function (ctx) {
    ctx.set('Content-Type', 'application/json');
    ctx.body = swaggerSpec;
})

router.use('', home.routes())
router.use('/backend/user', user.routes())
module.exports = router

中间件集合

通俗的讲:中间件就是匹配路由之前或者匹配路由完成做的一系列的操作。

const { renderData } = require("../../config/render")
const { log } = require("../../util/utils")
const koajwt = require('koa-jwt')
/**
 * 跨域处理
 * @example app.use(cross())
 */
export function cross() {
    return async function (ctx, next) {
        ctx.set('Access-Control-Allow-Origin', ctx.get("Origin") == null ? "*" : ctx.get("Origin"));
        ctx.set('Access-Control-Allow-Methods', ctx.get("Access-Control-Request-Method") || "PUT, GET, POST, DELETE, OPTIONS");
        ctx.set('Access-Control-Allow-Headers', ctx.get("Access-Control-Request-Headers") || "Content-Type");
        ctx.set('Access-Control-Allow-Credentials', "true");
        if (ctx.method == "OPTIONS") {
            ctx.status = 204
        }
        await next();
    }
}
/**
 * 兼容路由后缀,如 xxx/xxx.json == xxx/xxx 地址
 * @param suffixes string[] 后缀列表
 * @example app.use(adaptRouteSuffix([".json"]))
 */
export function adaptRouteSuffix(suffixes = []) {
    return async function (ctx, next) {
        suffixes.forEach(e => {
            var re = new RegExp(e);
            ctx.path = ctx.path.replace(re, "")
        })
        await next();
    }
}
/**
 * 错误日志捕获
 * @example app.use(onerror())
 */
export function onerror() {
    return async function (ctx, next) {
        return next().catch((err) => {
            if (err.status === 401) {
                ctx.status = 200;
                renderData(ctx, null, 401, "用户没有权限(令牌、用户名、密码错误)", err.message)
            } else if (ctx.status === 404) {
                var err = new Error('Not Found');
                err.status = 404;
                renderData(ctx, null, 404, "系统繁忙,请联系管理员", err.message);
            } else {
                renderData(ctx, null, -1, "服务端错误", err.message);
                log(err.message);
            }
        })
    }
}

/** 
 * 延迟
 * @example await delay(5000) // 延迟5s
 */
export function delay(time) {
    return new Promise(function (resolve) {
        setTimeout(function () {
            resolve();
        }, time);
    });
};
/**
 * 请求头拦截
 */
export function onheader() {
    return koajwt({
        secret: 'polo_token'
    }).unless({
        path: [/\/user\/login|swagger|front/]
    })
}

基本功能展示

登录

登录模块,这里就介绍下服务端的实现,主要依赖两个插件,jsonwebtoken(jwt)和koa-jwt,前者主要负责加密,生成token返回给前端,后者实现对token的校验,在中间件中实现请求头拦截,验证失败返回401。具体可以参考代码./app/controllers/user.js。

/**
 * 用户登录
 * @return 用户登录成功对象
 */
export async function login(ctx) {
    const data = ctx.request.body;
    if (!data.name || !data.password) {
        renderData(ctx, null, 102, '参数不合法');
    }
    const result = await GetUser({
        name: data.userName,
        password: data.password
    })
    if (result !== null) {
        const token = jwt.sign({
            name: result.name,
            password: result.password
        }, 'polo_token', { expiresIn: '2h' });
        const userData = {
            userName: result.name,
            token: 'Bearer ' + token
        }
        renderData(ctx, userData, 0, '登录成功');
    } else {
        renderData(ctx, null, 101, '用户名或密码错误');
    }
}
/**
 * 请求头拦截
 */
export function onheader() {
    return koajwt({
        secret: 'polo_token'
    }).unless({
        path: [/\/user\/login|swagger|front/]
    })
}

后台部分内容展示

写在最后

以上文章是我前段时间全栈开发已上线项目的简略版分享,文章开头已附上了该项目的前后端源码,顺便提供了测试数据(rnpxDemo.sql),只需把代码克隆下来并保证电脑已安装所需软件,另有不足之处也请多多指正,非常感谢。