若依框架想必大家都了解得不少，不可否认这是一款及其简便易用的框架。
在某种情况下（比如私活）使用起来可谓是快得一匹。
在这里小兵结合自身实际使用情况，记录一下我对若依框架的使用和改造情况。
一、源码下载
前往码云进行下载。（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 的内容，有点首页的样子先。
右上角的工具栏，一般只需要保留全屏功能即可。
全局搜索“源码地址”，将无关功能注释或删掉，保留所需即可。
若依官网的菜单也通过 系统管理-菜单管理 删除。
验证码可以在application.yml中将方式修改为字符验证 captchaType: char
三、原始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();
再以上示测试表复制为 demo2 为例，对应实体如下：
package com.ruoyi.system.domain;
import java.util.Date;
import com.fasterxml.jackson.annotation.JsonFormat;
import lombok.Data;
import com.ruoyi.common.annotation.Excel;
/**
* 测试示例2对象 demo2
*
* @author ruoyi
* @date 2025-01-28
*/
@Data
public class Demo2
{
private static final long serialVersionUID = 1L;
/** id */
private Long id;
/** 用户名 */
@Excel(name = "用户名")
private String name;
/** 年龄 */
@Excel(name = "年龄")
private Long age;
/** 出生日期 */
@JsonFormat(pattern = "yyyy-MM-dd")
@Excel(name = "出生日期", width = 30, dateFormat = "yyyy-MM-dd")
private Date birthday;
/** 创建者 */
private String createBy;
/** 创建时间 */
@JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss")
private Date createTime;
/** 更新者 */
private String updateBy;
/** 更新时间 */
@JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss")
private Date updateTime;
}
对应mapper.xml 多继承 BaseMapper：
public interface Demo2Mapper extends BaseMapper<Demo2> {
...
}对应 service.java 多继承 IService：
public interface IDemo2Service extends IService<Demo2> {
...
}对应 serviceImpl.java 多继承 ServiceImpl:
public class Demo2ServiceImpl extends ServiceImpl<Demo2Mapper, Demo2> implements IDemo2Service {
....
}为了使自动生成的代码也达到使用mybatisPlus的效果，需要修改 ruoyi-generator\src\main\resources\vm 对应的生成代码模板。
