若依基本使用及改造记录

若依框架想必大家都了解得不少，不可否认这是一款及其简便易用的框架。

在某种情况下（比如私活）使用起来可谓是快得一匹。

在这里小兵结合自身实际使用情况，记录一下我对若依框架的使用和改造情况。

一、源码下载

前往码云进行下载。（vue前后端分离版）

RuoYi-Vue: 🎉 基于SpringBoot，Spring Security，JWT，Vue & Element 的前后端分离权限管理系统，同时提供了 Vue3 的版本

下载后是下面图片的样子，除了 ruoyi-ui 是前端项目外，其它都是后端代码。

可以自行创建两个 git 项目如 ry-admin 、 ry-web，将后端源代码、前端源代码分别上传到自己的git 项目中方便后面管理。

二、源码启动

2.1 修改数据库连接

查看： ruoyi-admin\src\main\resources\application-druid.yml 中的配置，可看到其默认配置如下。

master:
    url: jdbc:mysql://localhost:3306/ry-vue?useUnicode=true&characterEncoding=utf8&zeroDateTimeBehavior=convertToNull&useSSL=true&serverTimezone=GMT%2B8
    username: root
    password: password

把 库名 ry-vue 和 密码 password 换成自己的库名和密码. 

然后执行项目初始化sql: sql/ry_20240629.sql

2.2 启动后端服务

修改完数据库连接/redis连接并初始化sql后，找到 com/ruoyi/RuoYiApplication.java 右键启动

启动成功后，可以访问 8080 端口进行验证。

2.3 启动前端服务

先安装依赖 npm i 

 安装完成后启动  npm run dev

访问 localhost 使用 admin/admin123 可以看到初版页面。

默认的首页是若依框架的介绍页面，一般不会使用。可以先用若依提供的 views/index_v1.vue 中的内容替换 views/index.vue 的内容，有点首页的样子先。

右上角的工具栏，一般只需要保留全屏功能即可。

全局搜索“源码地址”，将无关功能注释或删掉，保留所需即可。

若依官网的菜单也通过 系统管理-菜单管理 删除。 

三、原始CURD使用

若依提供了基本的代码生成功能。

以如下测试表 demo1 为例

CREATE TABLE `demo1` (
  `id` int(11) unsigned NOT NULL AUTO_INCREMENT COMMENT 'id',
  `name` varchar(255) DEFAULT NULL COMMENT '用户名',
  `age` int(11) DEFAULT NULL COMMENT '年龄',
  `birthday` date DEFAULT NULL COMMENT '出生日期',
  `create_time` datetime DEFAULT NULL,
  `create_by` varchar(255) DEFAULT NULL,
  `update_time` datetime DEFAULT NULL,
  `update_by` varchar(255) DEFAULT NULL,
  PRIMARY KEY (`id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='测试示例表1';

执行以上sql后，在前端页面  系统工具-代码生成 中生成对应代码，并使用。

将生成的 controller/service/mapper/domain/js/vue 代码复制到相应位置，并执行对应sql后，重启项目，可以使用对该表在页面中进行增删改查功能的使用。

四、使用mybatisPlus与lombok

 一般项目中可以使用 mybatisPlus 和 lombok 来加速开发，代码更为简便和优雅。若依中未进行使用。可以对其进行改造。

在 ruoyi-common/pom.xml 中导入相关依赖：

        <lombok.version>1.18.20</lombok.version>
        <mybatis-plus.version>3.5.1</mybatis-plus.version>

        <dependency>
            <groupId>org.projectlombok</groupId>
            <artifactId>lombok</artifactId>
            <version>${lombok.version}</version>
        </dependency>

        <dependency>
            <groupId>com.baomidou</groupId>
            <artifactId>mybatis-plus-boot-starter</artifactId>
            <version>${mybatis-plus.version}</version>
        </dependency>

将mybatis改为mybatisPlus:

修改com/ruoyi/framework/config/MyBatisConfig.java 中的 SqlSessionFactoryBean 为 MybatisSqlSessionFactoryBean

final MybatisSqlSessionFactoryBean sessionFactory = new MybatisSqlSessionFactoryBean();