基于RuoYi框架快速搭建自己的后台管理系统

RuoYi的介绍

        RuoYi是一个后台管理系统，基于经典技术组合（Spring Boot、Apache Shiro、MyBatis、Thymeleaf）主要目的让开发者注重专注业务，降低技术难度，从而节省人力成本，缩短项目周期，提高软件安全质量。

Ruo的生态系统

• RuoYi-fast：单应用的后台管理系统
• RuoYi：多模块的后台管理系统，从RuoYi3.0开始，进行模块拆分，本文基于此来搭建自己的后台管理系统
• RuoYi-Vue：Vue分离版本
• RuoYi-Cloud：Cloud微服务版本
• RuoYi的项目扩展

在线体验   

• 若依官网：http://ruoyi.vip/
• 演示地址：
  • 后台管理系统：登录若依系统若依后台管理框架http://demo.ruoyi.vip/
  • 前后端分离的后台管理系统：若依管理系统http://vue.ruoyi.vip/
  • 微服务的权限管理系统：RuoYi-Cloud提示http://cloud.ruoyi.vip/
• 代码下载：
  • 后台管理系统：RuoYi: 基于SpringBoot的权限管理系统 易读易懂、界面简洁美观。 核心技术采用Spring、MyBatis、Shiro没有任何其它重度依赖。直接运行即可用https://gitee.com/y_project/RuoYi
  • 前后端分离的后台管理系统：RuoYi-Vue: 基于SpringBoot，Spring Security，JWT，Vue & Element 的前后端分离权限管理系统https://gitee.com/y_project/RuoYi-Vue
  • 微服务的权限管理系统：RuoYi-Cloud: 基于Spring Boot、Spring Cloud & Alibaba的分布式微服务架构权限管理系统https://gitee.com/y_project/RuoYi-Cloud

系统需求

• JDK >= 1.8
• MySQL >= 5.7
• Maven >= 3.0

启动流程

        1.拉取项目到本地并在IDE工具中打开

                这里我选择的工具是IDEA，RuoYi后台管理系统版本是v4.7.1，RuoYi提供的使用手册使用的工具是eclipse，工具打开项目类似，你们可基于自己的情况选择。

        IDEA打开项目：在File中选择Open，然后找到项目打开

        2.更换项目名及目录名称

├── xxxxx
│       └── xxxxx-admin
│       └── xxxxx-common
│       └── xxxxx-framework
│       └── xxxxx-generator
│       └── xxxxx-quartz
│       └── xxxxx-system
│       └── pom.xml

        3.更换顶级目录中的pom.xml

	xxxxx-admin
	xxxxx-framework
	xxxxx-system
	xxxxx-quartz
	xxxxx-generator
	xxxxx-common

  4.更换项目所有包名称com.ruoyi.xxx换成com.xxxxx.xxx

  5.更换各目录中的pom.xml
     顶级目录pom.xml:

    com.xxxxx
    xxx
    x.x.x

    xxx
    xxx
    xxx
    
    
    
        x.x.x
    

        
    
        

          ......

            
            
                com.xxxxx
                xxx-quartz
                ${xxx.version}
            

            
            
                com.xxxxx
                xxx-generator
                ${xxx.version}
            

            
            
                com.xxxxx
                xxx-framework
                ${xxx.version}
            

            
            
                com.xxxxx
                xxx-system
                ${xxx.version}
            

            
            
                com.xxxxx
                xxx-common
                ${xxx.version}
            


        
    
    

        xxx-admin目录的pom.xml:

    
        com.xxxxx
        xxx
        x.x.x
    

    4.0.0
    jar
    xxx-admin
    
     

       ......

        
        
            com.xxxxx
            xxx-framework
        

        
        
            com.xxxxx
            xxx-quartz
        

        
        
            com.xxxxx
            xxx-generator
        

    

         xxx-common目录的pom.xml:

    
        com.xxxxx
        xxx
        x.x.x
    
    4.0.0

    xxx-common

        xxx-framework目录的pom.xml：

    
        com.xxxxx
        xxx
        x.x.x
    
    4.0.0

    xxx-framework

     

        
        
            com.xxxxx
            xxx-system
        

    

   xxx-generator的pom.xml：

    
        com.xxxxx
        xxx
        x.x.x
    
    4.0.0

    xxx-generator

     

       ......

        
        
            com.xxxxx
            xxx-common
        

      

    

   xxx-quartz的pom.xml：

    
        com.xxxxx
        xxx
        x.x.x
    
    4.0.0

    xxx-quartz

    

        
        
            com.xxxxx
            xxx-common
        

    

   xxx-system目录的pom.xml：

    
        com.xxxxx
        xxx
        x.x.x
    
    4.0.0

    xxx-system

    

        
        
            com.xxxxx
            xxx-common
        

    

        6.、更换application.yml指定要扫描的Mapper类的包的路径typeAliasesPackage包路径名称替换com.xxxxx

# MyBatis
mybatis:
    # 搜索指定包别名
    typeAliasesPackage: com.你的包名.**.domain

7.更换mapper文件的namespace包路径

ruoyi-system/resources/mapper/system/* 
ruoyi-quartz/resources/mapper/quartz/* 
ruoyi-generator/resources/mapper/generator/*

xml包路径名称替换com.xxxxx

8、更换日志路径

• 更换application.yml文件logging属性为com.xxxxx: debug
• 更换logback.xml文件为com.xxxxx

9.在mysql8建数据库然后运行sql文件

        如果不是mysql8，得改application-druid.yml中datasource的type

10、启动项目验证

        访问地址：

                http://localhost/端口号

修改ruoyi系统总结

        1.改ruoyi的界面

                界面在xxx-admin资源文件的templates模板下

      注意：

                核心菜单是在数据库里改的，如系统管理、系统监控、系统工具、若依官网，在sys_menu表中

        2.加自己模块

                先在库里建该模块的表，然后在本地启动项目，在系统工具模块下代码生成部分中，点导入然后选择自己的表，即可生成对应的界面及后端代码，mybatis配置文件也已生成好

     注意：

            生成代码前可先修改对应的记录，修改基本信息、字段信息及生成信息，其中基本信息可修改作者、实体类名称、表描述等，字段信息这个很重要，里面可对性别和证件类型加字典类型，然后显示类型中选择对应的控件，对应的字典类型在系统管理模块的字典管理部分下。

            用户得先在sys_menu中加入自己的模块，具体可参考其他模块，也可以运行生成的代码包中的sql文件，根据我的实践经验运行文件后会生成在系统管理模块下而不是单独一个模块，用户如果想单独一个模块可以自己改。

           加入模块后，把生成的代码加入到对应的目录下

        3.添加基本数据

                用户如果有基本数据的需求，可在系统管理的字典管理部分下，新增即可，在列表中加入数据其中字典标签和字典键值最重要，他们是一一对应的。

                前端使用字典数据：

        1.下拉框显示字典数据

        其中getType下是你选择的对应字典数据的字典类型，这样界面对应字段的下拉框就会显示你添加的字典数据

    状态：                     
    
        所有
        
    

当表格显示字典数据字段时你会发现显示的是键值而不是标签，这时或许得进行转换

当你的字典数据特别多时，你会发现一个一个添加很不方便而且很容易出错，但可惜的是ruoyi字典管理并没有导入，如果你有这方面需求你可以尝试着改字典管理部分加个导入，这部分我并没尝试，因为基本数据最多也才40个。

如果想实现在表格展示中对字段加一些样式，可参考如下，选择想要的即可：

 

        后端使用基本数据：

@Autowired
private ISysDictDataService iSysDictDataService;

    
//核心代码
SysDictData sysDictData = new SysDictData();
//用户可根据自己的需求，查询对应的数据
//DictType如“sys_user_sex”,DictLabel如"0"
sysDictData.setDictType(dictType);
sysDictData.setDictValue(dictLabel);
List DictDatas = iSysDictDataService.selectDictDataByLabelType(sysDictData);

其中特别注意，当导出时，你会发现导出的是键值而不是标签，比如你导出的性别是0而不是男

，这时你可以这样做：

在实体类中对应字段上@Excel注解里加 readConverterExp，把对应的键值对都写出来，要是该字段数据特别多用这种方法简直是恶梦，目前我还只试过该方法转换，但我想应该可以在导出对应的一系列方法中改代码改成能够动态的转化

    @Excel(name = "性别", readConverterExp = "0=男,1=女,2=未知")
    private String sex;

4.生成的界面的新增、修改、删除导出等逻辑

        对应的方法ruoyi已经给你封装好呢，你直接调用即可，在ry-ui.js中可找到对应的方法，如以下代码：

     添加

其中onclick对应的方法在ry-ui.js中可找到：

至于该方法中调用的其他方法同样可在js文件中找到

  // 添加信息
  add: function(id) {
      table.set();
      $.modal.open("添加" + table.options.modalName, $.operate.addUrl(id));
  },

至于其他生成的功能的实现也同样如此

如果你想加入自己的方法，你可以按照他的流程在对应的文件中加即可，写好前端后再写一系列层层调用的后端类

5.权限控制

        前端的界面权限控制可通过shiro:hasPermission实现，有该字段内容的才显示，

shiro:hasPermission="admin"  表示只有管理员可显示

     添加

后端权限控制可参考如下代码：

@Autowired
private ISysRoleService iSysRoleService;
       
Long userId = ShiroUtils.getUserId();
SysRole sysRole = iSysRoleService.selectRoleById(userId);
if(sysRole!=null){
  if("admin".equals(sysRole.getRoleKey())){
                
  }else{

}

6.如何更好的使用ruoyi

        1.当遇到不会的难题时可查阅ruoyi官方文档

        2.可参考实例演示下的各种功能，当有你需要的时

                对应的代码可在xxx-admin下的system下找到，当你鼠标停在对应的图标时会显示对应的接口，你可按着去找对应的

        3.可去ruoyi社区中看别人有没有对应的问题

        

总结：

       写这篇文章时我对ruoyi的使用还不是很多然后我也只想到这些，等以后用到ruoyi更有趣的地方时再来分享， ruoyi的所有实现都可在项目中找到代码，只不过在一些框架上又做了封装然后你可直接用，当你的需求ruoyi现有的没法实现时你可先看ruoyi代码逻辑，然后在该基础上加自己的代码实现自己需求，也可直接修改ruoyi的代码，你感觉你实现的需求还不错时可以考虑贡献你的代码然后丰富ruoyi,也可贡献你的系统，前提是你自己写的或已经得到授权，这样别人也可基于你的系统快速完成他的需求，赠人玫瑰，手有余香！