当前位置：首页 > article >正文

若依框架入门指南：快速上手SpringBoot+前后端分离版

article 2025/3/28 9:52:23

若依（RuoYi）是一款基于SpringBoot的快速开发平台，集成了权限管理、代码生成、监控管理等功能。本文将以SpringBoot + Vue前后端分离版本为例，带你快速上手若依框架。

一、环境准备

基础环境：
- JDK 1.8+
- MySQL 5.7+
- Redis 5.0+
- Maven 3.6+
- Node.js 14+（前端）

下载项目：

# 后端项目
git clone https://gitee.com/y_project/RuoYi-Vue.git

# 前端项目
git clone https://gitee.com/y_project/RuoYi-Vue-Web.git

二、项目配置

1. 数据库配置

修改ruoyi-admin/src/main/resources/application-druid.yml：

# 数据源配置
spring:
  datasource:
    druid:
      master:
        url: jdbc:mysql://localhost:3306/ry-vue?useSSL=false&serverTimezone=UTC
        username: root
        password: 123456

执行/sql目录下的SQL脚本初始化数据库。

2. Redis配置

修改ruoyi-admin/src/main/resources/application.yml：

# Redis配置
redis:
  host: localhost
  port: 6379
  password: 
  database: 0

三、启动项目

后端启动

运行RuoYiApplication.java中的main方法，控制台输出RuoYi启动成功即启动成功。

前端启动

cd RuoYi-Vue-Web
npm install  # 安装依赖
npm run dev  # 启动开发服务器

访问：http://localhost:80，使用默认账号admin/admin123登录。

四、基础功能使用

1. 代码结构说明

// 控制器示例
@RestController
@RequestMapping("/system/user")
public class SysUserController {
    @Autowired
    private ISysUserService userService;

    @GetMapping("/list")
    public TableDataInfo list(SysUser user) {
        startPage();  // 分页处理
        List<SysUser> list = userService.selectUserList(user);
        return getDataTable(list);  // 返回分页数据
    }
}

2. 代码生成器（重点功能）

创建数据表：在MySQL中创建业务表
导入代码生成：系统工具 → 代码生成 → 导入表
修改配置：设置包路径、模块名等
生成代码：生成ZIP包并解压到对应目录
重启项目：新功能自动注册到菜单

五、权限管理实现

基于RBAC（角色-权限）模型，通过注解控制权限：

// 权限控制示例
@RequiresPermissions("system:user:list") // 需要用户列表权限
@GetMapping("/list")
public TableDataInfo list(SysUser user) {
    // ...
}

// 角色控制示例
@RequiresRoles("admin") // 需要admin角色
@GetMapping("/adminOnly")
public String adminMethod() {
    return "管理员专属内容";
}

六、常见功能扩展

1. 添加新API接口

在controller包新建控制器
在service包创建服务接口及实现
在mapper包编写MyBatis Mapper

2. 自定义页面

在前端views目录创建Vue组件
在router/index.js配置路由
通过API与后端交互

七、项目结构示意图

ruoyi-admin
├── src/main/java
│   ├── com.ruoyi      # 核心包
│   │   ├── common     # 通用组件
│   │   ├── framework  # 框架核心
│   │   └── system     # 系统模块
│   └── resources 
│       ├── mapper     # MyBatis映射文件
│       └── static     # 静态资源