【潜意识Java】使用 Ruoyi 框架开发企业级应用，从零开始的实践指南和分析问题-阿里云开发者社区

模块化设计：Ruoyi框架采用了模块化设计，可以根据项目需求灵活选用不同模块。

权限控制：内置了完善的权限管理系统，支持菜单、按钮权限和角色管理。

代码生成器：内置代码生成工具，极大地提高了开发效率。

多数据源支持：支持多种数据库的集成，方便进行分布式数据管理。

2. 环境搭建与初始化项目

首先，我们需要搭建Ruoyi开发环境。Ruoyi框架基于Spring Boot和MyBatis，因此，我们需要配置合适的JDK版本（建议JDK 8及以上）以及数据库（例如MySQL）。

2.1 下载与配置Ruoyi框架

可以从Ruoyi的官方GitHub仓库（https://github.com/yangzongzhuan/RuoYi）下载项目源码，或者直接通过Maven进行初始化。

假设你已经通过Git克隆了项目，并且进入了ruoyi项目目录，接下来按照以下步骤配置项目。

2.2 配置数据库

在application.yml文件中，我们配置数据库连接信息：

spring:
  datasource:
    url: jdbc:mysql://localhost:3306/ruoyi?useUnicode=true&characterEncoding=utf-8&serverTimezone=UTC
    username: root
    password: password
    driver-class-name: com.mysql.cj.jdbc.Driver
  jpa:
    hibernate:
      ddl-auto: update
    properties:
      hibernate:
        dialect: org.hibernate.dialect.MySQL5InnoDBDialect

确保你在本地已经安装并启动了MySQL，并且创建了ruoyi数据库。

2.3 启动项目

执行以下命令启动Spring Boot应用：

mvn spring-boot:run

在浏览器中访问http://localhost:8080，你应该能看到Ruoyi的默认欢迎界面。

3. 创建模块：用户管理系统

接下来，我们将在Ruoyi框架下创建一个用户管理模块，包含基本的CRUD操作。

3.1 创建实体类

首先，在system模块下创建一个User实体类，表示系统用户。

package com.ruoyi.system.domain;
import com.ruoyi.common.core.domain.BaseEntity;
public class User extends BaseEntity {
    private Long userId;
    private String username;
    private String password;
    private String email;
    private Integer status;
    // Getter和Setter方法
    public Long getUserId() {
        return userId;
    }
    public void setUserId(Long userId) {
        this.userId = userId;
    }
    public String getUsername() {
        return username;
    }
    public void setUsername(String username) {
        this.username = username;
    }
    public String getPassword() {
        return password;
    }
    public void setPassword(String password) {
        this.password = password;
    }
    public String getEmail() {
        return email;
    }
    public void setEmail(String email) {
        this.email = email;
    }
    public Integer getStatus() {
        return status;
    }
    public void setStatus(Integer status) {
        this.status = status;
    }
}

3.2 创建Mapper接口

接下来，我们定义一个UserMapper接口，继承自MyBatis的BaseMapper接口，用于执行数据库操作。

package com.ruoyi.system.mapper;
import com.ruoyi.system.domain.User;
import org.apache.ibatis.annotations.Mapper;
import java.util.List;
@Mapper
public interface UserMapper {
    // 获取所有用户
    List<User> selectUserList(User user);
    // 插入新用户
    int insertUser(User user);
    // 更新用户信息
    int updateUser(User user);
    // 删除用户
    int deleteUserByIds(Long[] userIds);
}

3.3 创建Service层

在system模块下创建一个UserService类，封装业务逻辑，提供用户管理的具体操作。

package com.ruoyi.system.service;
import com.ruoyi.system.domain.User;
import java.util.List;
public interface IUserService {
    List<User> selectUserList(User user);
    int insertUser(User user);
    int updateUser(User user);
    int deleteUserByIds(Long[] userIds);
}

并提供实现类UserServiceImpl：

package com.ruoyi.system.service.impl;
import com.ruoyi.system.domain.User;
import com.ruoyi.system.mapper.UserMapper;
import com.ruoyi.system.service.IUserService;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Service;
import java.util.List;
@Service
public class UserServiceImpl implements IUserService {
    @Autowired
    private UserMapper userMapper;
    @Override
    public List<User> selectUserList(User user) {
        return userMapper.selectUserList(user);
    }
    @Override
    public int insertUser(User user) {
        return userMapper.insertUser(user);
    }
    @Override
    public int updateUser(User user) {
        return userMapper.updateUser(user);
    }
    @Override
    public int deleteUserByIds(Long[] userIds) {
        return userMapper.deleteUserByIds(userIds);
    }
}

3.4 创建Controller层

最后，我们创建一个RESTful API控制器来处理HTTP请求：

package com.ruoyi.system.controller;
import com.ruoyi.system.domain.User;
import com.ruoyi.system.service.IUserService;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.*;
import java.util.List;
@RestController
@RequestMapping("/user")
public class UserController {
    @Autowired
    private IUserService userService;
    // 获取所有用户
    @GetMapping("/list")
    public List<User> getUserList(User user) {
        return userService.selectUserList(user);
    }
    // 创建新用户
    @PostMapping("/add")
    public int addUser(@RequestBody User user) {
        return userService.insertUser(user);
    }
    // 更新用户信息
    @PutMapping("/update")
    public int updateUser(@RequestBody User user) {
        return userService.updateUser(user);
    }
    // 删除用户
    @DeleteMapping("/delete/{userIds}")
    public int deleteUser(@PathVariable Long[] userIds) {
        return userService.deleteUserByIds(userIds);
    }
}

3.5 测试接口

通过Postman或者其他API工具测试上述接口：

添加用户：发送POST请求到/user/add，请求体包含用户信息。

查询用户：发送GET请求到/user/list，返回用户列表。

更新用户：发送PUT请求到/user/update，请求体包含更新后的用户信息。

删除用户：发送DELETE请求到/user/delete/{userIds}，其中userIds为要删除的用户ID数组。

4. 总结

通过以上步骤，我们实现了一个简单的用户管理系统，包括增删改查（CRUD）操作，且所有操作都封装在Ruoyi框架中。Ruoyi框架提供了丰富的功能，能够极大地提高开发效率，同时具有灵活的扩展性和高可维护性。

随着项目的发展，你可以根据实际需要对模块进行扩展或调整。Ruoyi框架在权限管理、日志记录、定时任务等方面的功能也非常强大，值得进一步探索。

希望本文能够帮助你快速上手Ruoyi框架，开始你的企业级应用开发之旅！

【潜意识Java】使用 Ruoyi 框架开发企业级应用，从零开始的实践指南和分析问题

1. Ruoyi框架概述

Ruoyi的主要特点：

2. 环境搭建与初始化项目

2.1 下载与配置Ruoyi框架

2.2 配置数据库

2.3 启动项目

3. 创建模块：用户管理系统

3.1 创建实体类

3.2 创建Mapper接口

3.3 创建Service层

3.4 创建Controller层

3.5 测试接口

4. 总结

通义灵码

热门文章

最新文章

相关课程

相关电子书