若依框架【微服务】学习心得

最新推荐文章于 2025-10-05 03:58:18 发布
原创 最新推荐文章于 2025-10-05 03:58:18 发布 · 1.7k 阅读 · 32 ·
CC 4.0 BY-SA版权
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
文章标签：

#微服务 #ruoyi

1、项目结构

1.1 后端结构说明

在这里插入图片描述

ruoyi-cloud     
├── ruoyi-api
│       └── ruoyi-api-system              // 提取出来的openfeign的接口
├── ruoyi-auth                            // 认证授权
├── ruoyi-common                          // 通用工具模块
│       └── core                          // 核心控制
│       └── datascope                     // 
│       └── datasource                    // 数据权限
│       └── log                           // 全局日志
│       └── redis                         // redis配置
│       └── seata                         // 
│       └── security                      // 权限控制
│       └── sensitive                     // 
│       └── swagger                       // 接口文档
├── ruoyi-gateway         				  // 网关模块
├── ruoyi-modules         				  // 系统模块
│       └── file                          // 文件相关
│       └── gen                           // 代码生成
│       └── job                           // 定时任务
│       └── system                        // 系统代码
├── ruoyi-visual         				  
│       └── ruoyi-monitor                 // 监控模块

1.2 前端结构说明

在这里插入图片描述

├── build                      // 构建相关  
├── bin                        // 执行脚本
├── public                     // 公共文件
│   ├── favicon.ico            // favicon图标
│   └── index.html             // html模板
│   └── robots.txt             // 反爬虫
├── src                        // 源代码
│   ├── api                    // 所有请求
│   ├── assets                 // 主题 字体等静态资源
│   ├── components             // 全局公用组件
│   ├── directive              // 全局指令
│   ├── layout                 // 布局
│   ├── router                 // 路由
│   ├── store                  // 全局 store管理
│   ├── utils                  // 全局公用方法
│   ├── views                  // view
│   ├── App.vue                // 入口页面
│   ├── main.js                // 入口 加载组件 初始化等
│   ├── permission.js          // 权限管理
│   └── settings.js            // 系统配置
├── .editorconfig              // 编码格式
├── .env.development           // 开发环境配置
├── .env.production            // 生产环境配置
├── .env.staging               // 测试环境配置
├── .eslintignore              // 忽略语法检查
├── .eslintrc.js               // eslint 配置项
├── .gitignore                 // git 忽略项
├── babel.config.js            // babel.config.js
├── package.json               // package.json
└── vue.config.js              // vue.config.js

2、项目运行

项目下载地址

2.1 初始化数据库（建库建表）

在这里插入图片描述

在拉取的代码中，有SQL，即可找到数据库表。
1、创建数据库ry-cloud并导入数据脚本ry_2021xxxx.sql（必须），quartz.sql（可选）
2、创建数据库ry-config并导入数据脚本ry_config_2021xxxx.sql（必须）
3、创建数据库ry_seata并导入数据脚本ry_seata_2021xxxx.sql（可选）

2.2 完成注册中心（nacos）的配置和启动

2.2.1 下载nacos、解压、改配置

解压下载好的nacos压缩包，打开nacos文件夹找到conf文件夹下的application.properties并修改以下配置

在这里插入图片描述

2.2.2 启动

修改好配置以后返回上一级目录找到bin目录并进入找到 startup.cmd 文件、在此目录下进入cmd执行：startup.cmd -m standalone 启动nacos，启动成功后浏览器打开 http://localhost:8848/nacos 登录的用户名和密码都为nacos

在这里插入图片描述

此时项目中的所有的配置文件都会显示，然后从上往下挨个编辑，把涉及到连接Mysql和Redis的所有地方，改为自己对应的用户名和密码。

2.3 reids安装启动

略

2.4 后端项目启动

在这里插入图片描述

2.5 启动前端项目

在这里插入图片描述

3、模块梳理

3.1 ruoyi-gateway

在这里插入图片描述

3.1.1 config

1）properties包（配置类信息）：CaptchaProperties（读取nacos配置中心的验证码配置信息）、IgnoreWhiteProperties（读取nacos配置中心的放行白名单配置信息）、XssProperties（读取nacos配置中心的XSS跨站脚本配置信息）
2）CaptchaConfig：验证码的配置
3）GatewayConfig：网关限流配置
4）KaptchaTextCreator：验证码文本生成器
5）RouterFunctionConfiguration：路由配置（当接收到 /get的请求以及 ediaType.TEXT_PLAIN的时候调用获取验证码的handler方法）

@SuppressWarnings("rawtypes")
@Bean
 public RouterFunction routerFunction()
 {
     return RouterFunctions.route(
             RequestPredicates.GET("/code").and(RequestPredicates.accept(MediaType.TEXT_PLAIN)),
             validateCodeHandler);
 }

@Override
public Mono<ServerResponse> handle(ServerRequest serverRequest)
{
    AjaxResult ajax;
    try
    {
        ajax = validateCodeService.createCaptcha();
    }
    catch (CaptchaException | IOException e)
    {
        return Mono.error(e);
    }
    return ServerResponse.status(HttpStatus.OK).body(BodyInserters.fromValue(ajax));
}

6）SpringDocConfig：文档的配置类

3.1.2 filter

1） AuthFilter：网关鉴权（可通过nacos配置白名单、基本的鉴权验证、判断令牌的状态）
2）BlackListUrlFilter：黑名单过滤器（通过获取请求中的url判断是否是nacos上设置的黑名单）
3）CacheRequestFilter：获取body的请求数据（解决流不能重复读取问题）
4）ValidateCodeFilter：验证码过滤器
5）XssFilter：跨站脚本过滤器

3.1.3 handler

1）GatewayExceptionHandler：网关统一异常处理
2）SentinelFallbackHandler：自定义限流异常处理
3）ValidateCodeHandler：验证码获取
4）ValidateCodeServiceImpl：验证码实现处理

3.2 ruoyi-auth

在这里插入图片描述

主要用于做认证授权（登录、注册、登出、密码、登录日志、令牌刷新）

3.3 ruoyi-system

在这里插入图片描述

主要业务模块，和平时的boot差不多，实现三层架构

4、新建模块

4.1 创建新模块ruoyi-test：

这里在ruoyi-modules目录下新建test模块并新增界面，可参考ruoyi-system模块的目录结构及命名

在这里插入图片描述

4.2 进行新模块代码的基础配置调整：

修改ruoyi-test下的pom文件，参考ruoyi-system模块，可复制ruoyi-system的pom文件内容，修改system相关字段即可；

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xmlns="http://maven.apache.org/POM/4.0.0"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <parent>
        <groupId>com.ruoyi</groupId>
        <artifactId>ruoyi-modules</artifactId>
        <version>3.6.5</version>
    </parent>
    <modelVersion>4.0.0</modelVersion>

    <artifactId>ruoyi-modules-test</artifactId>

    <description>
        ruoyi-modules-test测试模块
    </description>

    <dependencies>

        <!-- SpringCloud Alibaba Nacos -->
        <dependency>
            <groupId>com.alibaba.cloud</groupId>
            <artifactId>spring-cloud-starter-alibaba-nacos-discovery</artifactId>
        </dependency>

        <!-- SpringCloud Alibaba Nacos Config -->
        <dependency>
            <groupId>com.alibaba.cloud</groupId>
            <artifactId>spring-cloud-starter-alibaba-nacos-config</artifactId>
        </dependency>

        <!-- SpringCloud Alibaba Sentinel -->
        <dependency>
            <groupId>com.alibaba.cloud</groupId>
            <artifactId>spring-cloud-starter-alibaba-sentinel</artifactId>
        </dependency>

        <!-- SpringBoot Actuator -->
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-actuator</artifactId>
        </dependency>

        <!-- Mysql Connector -->
        <dependency>
            <groupId>com.mysql</groupId>
            <artifactId>mysql-connector-j</artifactId>
        </dependency>

        <!-- RuoYi Common DataSource -->
        <dependency>
            <groupId>com.ruoyi</groupId>
            <artifactId>ruoyi-common-datasource</artifactId>
        </dependency>

        <!-- RuoYi Common DataScope -->
        <dependency>
            <groupId>com.ruoyi</groupId>
            <artifactId>ruoyi-common-datascope</artifactId>
        </dependency>

        <!-- RuoYi Common Log -->
        <dependency>
            <groupId>com.ruoyi</groupId>
            <artifactId>ruoyi-common-log</artifactId>
        </dependency>

        <!-- RuoYi Common Swagger -->
        <dependency>
            <groupId>com.ruoyi</groupId>
            <artifactId>ruoyi-common-swagger</artifactId>
        </dependency>

    </dependencies>

    <build>
        <finalName>${project.artifactId}</finalName>
        <plugins>
            <plugin>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-maven-plugin</artifactId>
                <executions>
                    <execution>
                        <goals>
                            <goal>repackage</goal>
                        </goals>
                    </execution>
                </executions>
            </plugin>
        </plugins>
    </build>

</project>

修改ruoyi-modules下的pom文件，增加 ruoyi-test 代码，参考ruoyi-system部分；

<module>ruoyi-test</module>

参考ruoyi-system模块修改TestApplication启动类代码，新增相关注解即可，如下：

@EnableCustomConfig
@EnableRyFeignClients

对于resources可复制ruoyi-system模块文件进行调整

在这里插入图片描述

4.3 在nacos进行新模块的配置管理

登录nacos：http://localhost:8848/nacos/
账号密码：nacos
克隆 ruoyi-system-dev.yml
命名为 ruoyi-test-dev.yml

在这里插入图片描述

点击编辑，修改下方的mybatis.typeAliasesPackage，改为 test，发布。如下：

mybatis:
    # 搜索指定包别名
    typeAliasesPackage: com.ruoyi.test
    # 配置mapper的扫描，找到所有的mapper.xml映射文件
    mapperLocations: classpath:mapper/**/*.xml

修改 ruoyi-gateway-dev.yml，添加新增的模块，发布。

 # 测试服务
 - id: ruoyi-test
   uri: lb://ruoyi-test
   predicates:
     - Path=/test/**
   filters:
     - StripPrefix=1

4.4 新增测试表，生成代码，并进行前后端代码的修改和使用

4.4.1 创建测试表student，设置字段注释；

在这里插入图片描述

4.4.2 在系统界面生成代码，生成的后端代码参考其他们模块的目录结构进行复制粘贴，修改mapper等各层级的代码，消除bug，保证后端各方法到持久层的正常跳转；如下：

在这里插入图片描述

前端代码包括.vue文件和.js文件,可参考system模块在ruoyi-ui的views和api文件下创建新增自己的模块代码，这里js文件包含各接口路径，需要保证是自己模块路径。
在这里插入图片描述

4.5 进行界面菜单配置，启动新建的模块，重启前端vue界面，登录查看新模块基础界面及功能。

菜单配置可参考system模块样式进行路径及权限标识，按钮等的配置即可；

在这里插入图片描述

启动新建的模块，重启前端vue界面，可查看测试模块的基础功能。如下：

在这里插入图片描述

Lu-zhiyan
关注
基于若依框架搭建商业项目
乘风偷月的博客
07-04 1万+
RuoYi 若依官方网站 |后台管理系统|权限管理系统|快速开发框架|企业管理系统|开源框架|微服务框架|前后端分离框架|开源后台系统|RuoYi|RuoYi-Vue|RuoYi-Cloud|RuoYi框架|RuoYi开源|RuoYi视频|若依视频|RuoYi开发文档|若依开发文档|Java开源框架|Java|SpringBoot|SrpingBoot2.0|SrpingCloud|Alibaba|MyBatis|Shiro|OAuth2.0|Thymeleaf|BootStrap|Vue|Element-
微服务架构使用和docker部署方法（若依）
weixin_40444253的博客
04-14 3566
微服务架构使用和docker部署方法（若依）
若依微服务版框架学习
qq_54071060的博客
02-21 638
我自己重写了一个bat命令，因为nacos默认好像是集群启动，启动了黑框框一下子就消失了，我这里默认单机启动，创建一个startNacos.bat文件， 使用startup.cmd -m standalone。这里根据自己的redis和mysql有无设置密码进行更改，在数据库不好改，我是复制到idea，创建一个application.yml，更改完以后再剪切回数据库的，再把创建的yml删除掉。可以看到按照若依文档执行两个sql命令后，若依是将这些配置都用数据库持久化了的，8.启动认证服务和系统服务。
RuoYi-Vue后端接口文档：Swagger3.0配置教程
最新发布
gitblog_00483的博客
10-05 830
你是否还在为后端接口调试繁琐而烦恼？是否希望拥有一份自动生成且美观易用的API文档？本文将详细介绍如何在RuoYi-Vue项目中配置Swagger3.0（OpenAPI 3.0），帮助你快速搭建专业的接口文档系统。读完本文后，你将能够：配置Swagger3.0环境、自定义API文档信息、设置接口安全认证、访问和使用接口文档。 ## Swagger3.0简介 Swagger（OpenAPI）是一...
解读若依微服务架构图：架构总览、核心模块解析、消息与任务处理、数据存储与缓存、监控与日志
初始阶段。长文本博客做模型上下文。新书《千界明彻录》（故事形式构建元思维）——胡说小说。更多思辨内容在公众号。
01-13 6327
若依微服务架构以模块化设计为核心，结合 Spring Cloud 生态优势，构建了高效、灵活的分布式系统。从服务注册与网关管理，到任务调度与数据处理，每个模块都在架构中扮演了重要角色。开发者应理解架构设计思想，并在实践中不断优化和迭代。希望本文能帮助您深入理解若依架构，并在实际项目中灵活应用。
若依框架学习
qq_60555957的博客
06-21 2316
开源项目，学习开源项目的目的：1.用别人的，减少自己的工作量2.学习他的底层编程思想，设计思路，提高自己的编程能力基础：springboot+Vue环境要求：1.jdk1.8+2.mysql3.Redis4.Maven5.vue。
从0开始搭建若依微服务项目 RuoYi-Cloud（保姆式教程 一）
全栈技术分享，项目分享，资料分享
01-28 1万+
一直想做一款后台管理系统，看了很多优秀的开源项目但是发现没有合适的。于是利用空闲休息时间开 始自己写了一套后台系统。如此有了若依。她可以用于所有的Web应用程序，如网站管理后台，网站会 员中心，CMS，CRM，OA。所有前端后台代码封装过后十分精简易上手，出错概率低。同时支持移动 客户端访问。系统会陆续更新一些实用功能。性别男，若依是给女儿取的名字（寓意：你若不离不弃，我必生死相依） 若依是一套全部开源的快速开发平台，毫无保留给个人及企业免费使用。
微服务框架中Nacos的个人学习心得
qq_54429126的博客
06-27 1246
微服务中的Nacos的使用，配置以及与Eureka的区别
精选资源
实施微服务，我们需要哪些基础框架？
02-26
笔者之前在两家大型互联网公司参与和主导过大型服务化体系和框架建设，同时在这块也投入了很多时间去学习和研究，有一些经验和学习心得，可以和大家一起分享。和单块(Monolithic)架构不同，微服务架构是由一系列职责...
【若依框架】学习
m0_57855994的博客
08-06 4224
RuoYi是一个后台管理系统，一款基于SpringBoot+Bootstrap的极速后台开发框架。
基于若依开发的 Java EE 分布式微服务架构平台
ViewDesign 的博客
01-04 3252
Admin Cloud是一套企业级的多租户权限管理开发平台，基于Admin Plus、iCRUD和若依。提供单体版和微服务版双版本。单体版（基于Spring Boot） 和微服务版（基于Spring Cloud & Alibaba）。​​​​​​​
若依后台框架，入手学习笔记记录
10-10
若依后台 com.ruoyi ├── common // 工具类 │ └── annotation // 自定义注解 │ └── config // 全局配置 │ └── constant // 通用常量 │ └── core // 核心控制 │ └── enums // 通用枚举
若依—微服务架构
dgsfdsdf的博客
04-29 481
若依微服务架构。
Java技术栈 —— 微服务框架Spring Cloud —— Ruoyi-Cloud 学习（一）
键盘国治理专家的博客
12-06 4460
的战略布局，开发自己的一套技术架构并加入Spring生态，从而得到更大面积的推广，让更多的受众群体离不开Spring Cloud Alibaba，成为阿里系产品的使用者，并发展成潜在的用户，这一招战略十分精妙，华为的战略与之类似，华为也在推广它自己的技术体系到主流生态中，PyTorch就有华为的贡献。”，具体说明可见官方文档，注意是中文文档，有个规律，外国人开发的项目优先看英文文档，中国人开发的项目优先看中文文档，因为更新更及时，如果中国人开发的项目更新中文文档都不及时，反倒更优先更新“
【若依微服务框架】如何使用若依框架搭建微服务项目
iwgts的专栏
06-13 1417
本文介绍了基于若依框架(RuoYi)搭建微服务项目的完整流程。主要内容包括：1)环境准备（JDK、Maven、MySQL等基础组件）；2)项目下载与导入；3)数据库配置与初始化；4)Nacos注册中心的配置与启动；5)各微服务模块的配置调整；6)服务启动顺序与验证；7)前端项目配置；8)扩展开发与代码生成；9)常见问题解决方案。文章详细说明了从环境搭建到项目部署的全过程，特别强调了Nacos在微服务架构中的核心作用，为开发者提供了完整的若依微服务项目搭建指南。
【若依框架】若依框架使用心得
zxc88546的博客
10-24 1602
后端主要使用SpringBoot作为项目的基本框架，SpringSecurity作为项目安全控制框架，控制用户的登录和权限认证。整体来说项目精简上手比较快，且SpringBoot内嵌tomcat，可以直接打成jar包通过java -jar的方式运行项目，但相对shiro来说，该安全框架可能较为复杂，但内容更为丰富完善。
基于若依框架的二次开发_浅谈若依框架
热门推荐
weixin_39900023的博客
12-06 1万+
何为框架？若依框架又是什么？具备什么功能？框架的英文为Framework，带有骨骼，支架的含义。在软件工程中，框架往往被定义为整个或部分系统的可重用设计，是一个可重复使用的设计构件。类似于一个数学公式或某种流程。而若依框架又是什么？其实就是一套后台管理系统，它采用了Spring Boot和Shiro安全控制框架，以及Thymeleaf模板。Spring Boot是一个基于Spring开发...
一套完整的微服务框架，实战若依 ruoyi cloud
MAStudio移动信息化专栏
07-11 5887
基于若依微服务版 ruoyi cloud 的完整框架调试、修正、注解说明和扩展，包含nacos、sentinel、seata等服务器环境，提供易于上手的完整微服务运行环境。
若依框架自用心得体会
weixin_60948956的博客
11-08 2221
图片或文件的信息存到了数据表中，但是我们的业务表中存的时候oss表中的id，我们想要时候的时候，通过这个id查询oss表中的信息，得到URL地址后访问。这里的图片上传使用的是minio，oss，在使用文件上传之前我们还需要配置一下oss，安装在本地或者服务器上，创建一个桶。大多数接口访问需要token，我们在系统模块中找到登录方法，访问成功之后，添加后置操作，提取变量token。在字典管理有自定义一个你的字典。在生成代码的时候，有些业务需要上传文件或者图片，这是需要你在生成的时候对应字段选择即可。
评论
成就一亿技术人!
拼手气红包6.0元
还能输入1000个字符
 
红包 添加红包
表情包 插入表情
表情包 代码片
 条评论被折叠 查看
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值