代码文件

若依微服务源码地址：

RuoYi-Cloud: 基于Spring Boot、Spring Cloud & Alibaba的分布式微服务架构权限管理系统

本文档基于RuoYi-Cloud 2.5.0，假定RuoYi-Cloud已经能正常运行起来，需要新增模块。运行不起来，建议去官网查看文档。

模块存放于ruoyi-modules文件夹内，建议使用IntelliJ IDEA开发工具。

1. ruoyi-modules上面右键 New-Module…

1. Create from archetype 不需要勾选，直接Next

1. 创建模块信息，根据自己创建的模块修改对应的内容，点击Finish

• Parent：所属哪个模块，如果下面Name有修改，上面会变成ruoyi，此时需要重新选择一下ruoyi-modules
• Name：模块名称，这个地方显示的如下图所示，中括号的名称

• Location：模块存放位置，默认是Parent父模块文件夹下面，此处是存放物理磁盘文件夹名称
• GroupId：项目组织唯一的标识符，实际对应JAVA的包的结构
• ArtifactId：对应模块的名称

1. 查看ruoyi-mdules的pom.xml，可以看到刚才新增的spider模块已经添加进来

1. 打开spider模块的pom.xml，可以看到很简单的几行内容（图一），打开ruoyi-system模块的pom.xml，复制里面整个的dependencies、build两块内容，最终如图二所示，截图没有全

图一

图二

1. 创建包目录，新建目录默认没有包，需要根据步骤3里面包结构，创建包，此处包目录为：com.newsoft.spider

原始目录结构 包目录

1. 拷贝resources文件

拷贝ruoyi-system模块resources文件夹下的banner.txt、bootstrap.yml、logback.xml三个文件

• banner.txt：启动后控制台打印，想要个性化网上有很多样例使用
• bootstrap.yml：注册Nacos使用，只需要改server.port端口号、spring.application.name应用名称即可

目前三个地方要保持一致，应用名称、Nacoa中ruoyi-gateway-dev.yml该模块对应的uri以及该模块的配置文件

• logbakc.xml：logback日志配置文件

只需要改【日志存放路径】中的名即可

1. 复制启动类RuoYiSystemApplication，此处改名为SpiderApplication，名字随便取，便于理解即可

单击SpiderApplication中第一个注解：@EnableCustomConfig，会自动进入com.ruoyi.common.security.annotation包下面的类里面，复制此类到spider模块下面，新建包com.newsoft. annotation，复制到此包下面，并且修改【指定要扫描的Mapper类的包的路径】由com.ruoyi.**.mapper改为com.newsoft.**.mapper

最后修改SpiderApplication中@EnableCustomConfig引用路径

修改前：com.ruoyi.common.security.annotation.EnableCustomConfig;

修改后：com.newsoft.annotation.EnableCustomConfig;

1. 代码文件到此完成，下图为最终目录结构

Nacos配置文件

1. 启动并访问Nacos，账号密码默认nacos/nacos

http://localhost:8848/nacos/

1. 编辑配置文件【ruoyi-gateway-dev.yml】

复制系统模块，然后粘贴并修改

复制 粘贴修改后

id：自定义

uri：在gateway中配置uri配置有三种方式，包括

第一种：ws(websocket)方式: uri: ws://localhost:9000

第二种：http方式: uri: http://localhost:8130/

第三种：lb(注册中心中服务名字)方式: uri: lb://brilliance-consumer

此处使用第三种，则注册中心名字为spider-dev.yml

predicates：有很多配置选项，此处只配置Path选项

访问模块的前缀，转换一种思路可以理解为“项目名”。

1. 创建模块配置文件

配置管理-配置列表，找到ruoyi-system-dev.yml并选中，单击【克隆】，弹出窗口【目标空间】选择 public|public，

Data Id 比较重要，用spider/resources/bootstrap.yml中应用名、环境配置组合命名，此处为spider-dev.yml，做完这些点击【开始克隆】

1. 编辑配置文件spider-dev.yml

列表中找到spider-dev.yml，点击【编辑】，显示如下图，【配置内容】可视区域比较小，按F1或者有些笔记本需要用【Fn+F1】全屏编辑，按Esc退出全屏。

需要编辑的有两个地方，一个是数据库链接配置（此处不演示，根据自己机器配置即可），第二个是mybatis配置，由com.ruoyi.system改为com.newsoft即可

检查没问题后点击【发布】

启动服务

1. 后端启动服务，因为要做代码生成，所以启动RuoYiGenApplication

RuoYiGatewayApplication （网关模块 必须）

RuoYiAuthApplication （认证模块 必须）

RuoYiSystemApplication （系统模块 必须）

RuoYiGenApplication （代码生成 ）

1. 前端运行

进入ruoyi-ui/bin，运行run-web.bat文件

1. 登录系统，新建菜单，主要是路由地址要跟【ruoyi-gateway-dev.yml】中-Path中的名字一样

1. 代码生成，跟单应用一样，这里主要讲生成后的代码

sql文件执行即可

main复制到spider模块中

vue文件夹下面的api、views文件夹复制到ruoyi-cloud/ruoyi-ui/src即可

1. 找到SpiderApplication文件，右键 run或者debug都可以

当看到SpiderApplication输出内容则表示启动成功

1. 查看当前运行的服务，绿色三角为Run模式，红色为Debug模式。

1. 前端最终界面

文档里有些描述可能不正确，但是都是本人一步一步操作过来，可以正常运行。

如有问题请留言告知。