常见场景最佳实践 - Vue、React项目如何调用后端接口 - 《Rainbond v5.4 文档手册》

前言
解决跨域对于不同的场景有以下几种方法：
- 接口没有统一
- 接口统一
源码部署后端

前言

部署 Vue 、React 项目请参考 Rainbond部署Vue、React项目

以往我们在部署前端项目后，调用后端接口有以下几种场景：

后端接口没有统一，比较分散，例如：/system/user,/tool/gen 。

通常我们会在项目的全局配置文件.env.production中直接写入后端ip，例如：

   ENV = 'production'
   VUE_APP_BASE_API = '192.168.6.66:8080'

这样写虽可以正常访问，但会导致产生跨域问题。

后端接口统一，例如：/api/system/user, /api/tool/gen。

大部分小伙伴也还是同样会直接把IP + 后缀写入到项目全局配置文件，例如：

   ENV = 'production'
   VUE_APP_BASE_API = '192.168.6.66:8080/api'

这样写当然了也会有跨域的问题。

那我们该怎么解决接口不统一或接口统一的跨域问题呢。

答：使用Nginx 反向代理。

大部分小伙伴用nginx都是项目打包完的dist包丢进nginx，配置个 location proxy_pass 反向代理后端，然后在项目全局配置里填写Nginx地址。酱紫还是会跨越哦😋。那究竟该怎么处理呢，请往下看👇

解决跨域对于不同的场景有以下几种方法：

接口没有统一

接口数量较少的话，比如只有几个接口system tool moitor login getmenu等。

首先需要修改全局配置文件.env.production 的请求api 为/，酱紫写前端发起请求的时候会直接转发到nginx。

   ENV = 'production'
   VUE_APP_BASE_API = '/'

其次修改Nginx配置文件，添加多个location，在浏览器请求的时候就会匹配到nginx的location规则，例如：

浏览器请求菜单：http://192.168.6.66/getmenu，会匹配 location /getmenu规则反向代理到后端。

   server {
         listen       5000;
             #静态页面
         location / {
             root   /app/www;
             try_files $uri $uri/ /index.html;
             index  index.html index.htm;
         }
         location /getmenu{
             proxy_pass http://127.0.0.1:8080/;
         }
     }

这种方式固然可以，但对于接口几十个上百个一一配置很麻烦。

接口数量很多。

同样首先也需要修改全局配置文件.env.production，修改请求接口为 api，这个接口自定义的。有的小伙伴就疑问了，我没有这个接口呀，请接着往下看。

   ENV = 'production'
   VUE_APP_BASE_API = '/api'

紧接着修改Nginx配置文件，在nginx配置文件中添加了location /api，并且添加了 rewrite、proxy_pass，这个 rewrite是URL重写。

例如：请求 http://192.168.6.66/api/system/menu，酱紫请求正常情况发送到后端，后端会报错是没有这个接口的。

我们通过rewrite 重写URL，此时URL就会变成http://192.168.6.66/system/menu并且通过proxy_pass反向代理到后端，此时发送接口请求/system/menu，后端正常返回。

   server {
       listen       5000;
       location / {
           root   /app/www;
           try_files $uri $uri/ /index.html;
           index  index.html index.htm;
       }
       location  /api {
           rewrite ^/api/(.*)$ /$1 break;
           proxy_pass http://192.168.2.182:8080;
       }
   }

rewrite ^/api/(.*)$ /$1 break具体可参考Nginx官方文档rewrite_module模块，在这里简单介绍下：

rewrite ^/api/(.*)$ /$1 break

关键字正则替代内容 flag标记

接口统一

对于这种就比较好处理了。

同样首先也是修改项目的全局配置文件.env.production，修改请求接口为 /prod-api。这个统一接口是后端提供的哈。

ENV = 'production'
VUE_APP_BASE_API = '/prod-api'

修改Nginx配置文件，增加一条location，反向代理到后端地址。

此时在浏览器请求的URL则为：http://192.168.6.66/prod-api/system/menu。

server {
    listen       5000;
    location / {
        root   /app/www;
        try_files $uri $uri/ /index.html;
        index  index.html index.htm;
    }
    location  /prod-api {
        proxy_pass http://192.168.2.182:8080;
    }
}

跨域问题解决了，那我们开始实践一次😁。

本次前端的配置就是上面说的接口统一的方式

接下来部署一个SpringBoot后端项目来配合前端一起使用。

源码部署后端

本项目源码地址https://gitee.com/zhangbigqi/RuoYi-Vue.git Fork开源项目若依
后端是SpringBoot + Mysql + Redis 架构。

Dockerfile源码构建部署Mysql

参考博客文章Rainbond 中用 Dockerfile 便捷构建运行应用

通过Dockerfile源码构建部署Mysql。参考文档Dockerfile源码构建

Dockerfile源码构建需要在项目所需Sql目录放置Dockerfile文件自动初始化数据库。

Dockerfile文件可参考https://gitee.com/zhangbigqi/RuoYi-Vue.git 此项目下的 sql 目录

填写源码仓库地址，填写Mysql子目录 sql，构建Mysql。
确认创建组件，平台会自动识别语言为 dockerfile。
创建，等待构建组件完成即可。
构建完成后，在组件 > 端口中打开对内服务并且修改 别名，点击即可修改，改为MYSQL_HOST,以供后端连接时使用。

Docker镜像部署Redis

通过 docker镜像部署redis，具体参考官方文档docker镜像构建
使用 redis 官方镜像，redis:latest
确认创建，平台会检测出来一些镜像信息，直接创建即可。
构建完成后，在组件 > 端口中打开对内服务。以供后端连接使用

Java源码构建部署 SpringBoot

这里提前修改了后端项目里的配置文件 ruoyi-admin/src/main/resources/application-druid.yml连接数据库的配置，改为了环境变量连接，这里就用到了上面修改的端口别名。以及修改了ruoyi-admin/src/main/resources/application.yml文件中的连接Redis配置

   # 主库数据源
     master:
         url: jdbc:mysql://${MYSQL_HOST}:${MYSQL_PORT}/ry-vue?
     redis:
         # 地址
         host: 127.0.0.1
         # 端口，默认为6379
         port: 6379

通过Java源码构建项目，具体参考官方文档JAVA源码构建
填写源码仓库地址，构建SpringBoot项目。
平台会根据项目根目录的 pom.xml 文件检测是什么项目，这里检测的是多模块项目。
进入多模块构建，勾选ruoyi-admin模块，此模块是可运行的，其他模块都是依赖。具体模块功能参考若依官方文档
可修改Maven构建参数，无特殊要求无需修改。
确认创建，等待构建完成。

这里需要注意，平台默认使用openjdk ，此项目需要使用oraclejdk来生成前端验证码。

需要在组件 > 构建源中修改 JDK类型为自定义JDK，填写自定义JDK下载路径。

自定义JDK下载地址：https://buildpack.oss-cn-shanghai.aliyuncs.com/jdk/jdk1.8.0.tgz

需要打开 禁用缓存按钮，防止包不一样出现奇奇怪怪的问题。构建成功后再把禁用缓存关闭，下次构建就缓存正确的包了。
修改后 保存修改。构建组件，等待构建完成，修改端口为 8080 。
进入拓扑图界面，切换为编辑模式，建立组件依赖关系。
- **ruoyi-ui **连接 ruoyi-admin。
- **ruoyi-admin **连接 Mysql、Redis。
更新组件ruoyi-ui ruoyi-admin，至此完成。
最终效果，拓扑图：

页面效果：