ruoyi-vue-pro 開發指南

一、簡介

ruoyi-vue-pro 是一款基於 SpringBoot2.x 全家桶實現、Vue、Element UI 的後台管理系統模板，提供模板功能和CRUD代碼生成，並且支持多租戶系統、多數據源系統,可瀏覽器緩存、工作流、十強排行榜、代碼生成等常用開發功能。

在本章節中，我們將介紹該系統的基本架構和運行環境。

二、系統架構

本系統的架構基於傳統的前後端分離架構模式，採用以下技術棧：

• 前端採用 Vue + Element + Axios + Webpack;
• 後端採用 SpringBoot2.x + MyBatis-Plus + Shiro + Swagger-UI + Log4j2。

三、運行環境

運行該項目需要滿足以下環境：

• JDK8+
• Maven 3.0+
• MySQL 5.5+
• Node.js 10+

四、項目結構

本系統的項目結構如下：

ruoyi-vue-pro/
  ├── ruoyi-admin/  後台管理模塊
  ├── ruoyi-common/ 客戶端、服務端公共模塊
  ├── ruoyi-framework/ 框架核心模塊
  ├── ruoyi-generator/ java代碼自動生成模塊
  ├── ruoyi-quartz/ 定時任務模塊
  ├── ruoyi-system/ 後台管理業務模塊
  ├── ruoyi-tools/ 系統工具模塊
  └── src/  Vue前端代碼

五、代碼示例

1. Mybatis-Plus 更改系統默認表名確定方法

在項目中使用Mybatis-Plus的時候，默認情況下表名和實體類名必須一一對應，否則-會出現”無法找到該實體”的錯誤。在系統多數據源的時候，這種情況更加明顯。

/**
* 代碼生成前綴配置，表名以sys_開頭才生成代碼
*/
strategy.setTablePrefix(new String[] { "sys_" });

/**
*根據數據庫表獲取對應實體類
*/
@Override
public String tableToJava(String tableName) {
    if (tableName.startsWith("sys_")) {
        return upperTableName2Camel(tableName.replaceFirst("sys_", ""));
    } else if (tableName.startsWith("gen_")) {
        return upperTableName2Camel(tableName.replaceFirst("gen_", "Gen"));
    } else if (tableName.startsWith("qrtz_")) {
        return upperTableName2Camel(tableName.replaceFirst("qrtz_", "Qrtz"));
    } else {
        return upperTableName2Camel(tableName);
    }
}

2. 自定義異常處理

異常處理是Web應用開發中非常重要的一環，當系統出現異常時，我們需要有一個統一的異常處理機制。在本項目中，我們通過繼承DefaultHandlerExceptionResolver，並重寫它的resolveException()方法實現異常處理。

@RestControllerAdvice
public class GlobalExceptionHandler extends DefaultHandlerExceptionResolver {

    @Autowired
    private MessageSource messageSource;

    /**
    * 處理業務異常
    */
    @ExceptionHandler(BusinessException.class)
    @ResponseStatus(HttpStatus.INTERNAL_SERVER_ERROR)
    public R businessException(BusinessException e) {
        String message = messageSource.getMessage(e.getMessage(), null, LocaleContextHolder.getLocale());
        return R.error(message);
    }

    /**
    * 處理未知異常
    */
    @Override
    protected ResponseEntity