springboot-plus

一個基于SpringBoot 2 的管理后臺系統,包含了用戶管理，組織機構管理，角色管理，功能點管理，菜單管理，權限分配，數據權限分配，代碼生成等功能
相比其他開源的后臺系統，SpringBoot-Plus 具有一定的復雜度

系統基于Spring Boot2.1技術，前端采用了Layui2.4。數據庫以MySQL/Oracle/Postgres/SQLServer為實例，理論上是跨數據庫平臺.

1 使用說明

1.1 安裝說明

建議在徹底熟悉plus系統之前，先暫時不要修改其他配置選項，免得系統無法訪問

本系統基于Spring Boot 2 ，因此請務必使用JDK8，且打開編譯選項parameters(點擊了解parameters), 并重新編譯工程，如果你沒有使用Java8的 parameters 特性，系統不能正常使用

從Git上獲取代碼后，通過IDE導入此Maven工程，包含倆個子工程

• admin-core ，核心包，包含了緩存，數據權限，公用的JS和HTML頁面。
• admin-console, 系統管理功能，包含了用戶，組織機構，角色，權限，數據權限，代碼生成等管理功能

com.ibeetl.admin.CosonleApplication 是系統啟動類，在admin-console包下,在運行這個之前，還需要初始化數據庫，位于doc/starter-mysql.sql,目前只提供mysql, oracle, postgresql腳本。理論上支持所有數據庫

還需要修改SpringBoot配置文件application.properties,修改你的數據庫地址和訪問用戶

spring.datasource.url=jdbc:mysql://127.0.0.1:3306/starter?useUnicode=true&characterEncoding=UTF-8&serverTimezone=GMT%2B8&useSSL=false
spring.datasource.username=root
spring.datasource.password=123456

運行CosonleApplication，然后訪問http://127.0.0.1:8080/ 輸入admin/123456 則可以直接登錄進入管理系統

如果成功啟動后運行報錯：變量userId未定義，位于第6行，那是因為你沒有啟用parameters，啟用后，需要clean&build整個工程

1.2 創建子系統

SpringBoot-plus 是一個適合大系統拆分成小系統的架構，或者是一個微服務系統，因此，如果你需要創建自己的業務系統，比如，一個CMS子系統，建議你不要在SpringBoot-Plus 添加代碼，應該是新建立一個maven工程，依賴admin-core，或者依賴admin-console（如果你有后臺管理需求，通常都有，但不是必須的）

創建子系統，可以進入代碼生成>子系統生成， 輸入maven項目路徑，還有包名，就可以直接生成一個可運行的基于SpringBoot-Plus 的子系統,所有代碼可以在個項目里些完成，直接運行MainApplication，

@SpringBootApplication
@EnableCaching
@ComponentScan(basePackages= {"com.corp.xxx","com.ibeetl.admin"})
public class MainApplication  extends SpringBootServletInitializer implements WebApplicationInitializer {public static void main(String[] args) {SpringApplication.run(MainApplication.class, args);}}	

子系統包含了admin-core和admin-console, 因此你可以直接在子系統里使用core和console提供的所有功能，通過子系統的console功能的代碼生成來完成進一步開發

子系統可以單獨運行和維護，也可以集成到nginx后構成一個龐大的企業應用系統

1.2.1 配置子系統

子系統不需要做任何配置即可在IDE里直接運行，如果你想打包城jar方式運行，則需要添加

<build><plugins><plugin><groupId>org.springframework.boot</groupId><artifactId>spring-boot-maven-plugin</artifactId></plugin></plugins>
</build>

如果你想打包成war放到tomcat下運行，需要修改maven打包為war

<packaging>war</packaging>

1.2.2 菜單系統

系統默認提供三種類型菜單

• 系統級菜單，出現在頁面頂部，表示一個子系統
• 導航菜單，出現在頁面左邊，點擊導航將打開其下所有菜單
• 菜單，點開菜單將定位到頁面，菜單必須關聯到一個功能點。

建議新建立一個子系統來放置新功能

SpringPlus-Boot 并非以菜單或者按鈕來組織整個系統，而是以功能點來組織整個系統提供的功能。如果要使得菜單生效，你必須要先常見一個功能點并且功能點有一個訪問地址，然后將此菜單關聯到這個功能點

SpringBoot-Plus 先建立功能點是個好習慣，功能點被組織成一顆樹，代表了系統應該提供功能的功能，我們看代碼就會看到，功能點跟菜單，跟權限，和數據權限都有密切關系

1.2.2 添加代碼

可以參考1.3業務代碼生成生成初始化的代碼，業務代碼生成了14個文件，包含前后端所有代碼，可以通過生成來了解代碼習作規范

1.3 業務代碼生成

在介紹如何利用Plus開發系統之前，先介紹代碼生成功能，此功能可以生成前后端代碼總計14個文件，你可以通過預覽功能了解如何開發這個系統

代碼生成針對表進行代碼生成，包括JS，JAVA，SQL和HTML，可以通過預覽功能直接預覽。在生成代碼到本地前，有些參數需要修改，否則，代碼生成后顯示的都是英文

• 顯示字段 ： 當此實體顯示在任何地方的時候，能代表此實體的名稱，比如用戶名，組織機構名
• 變量名：可以自己設定一個較短的名字，此變量名會用于前后端的變量
• urlBase：你規劃的子系統，最后訪問路徑是urlBase+變量名字
• system: 存放sql目錄的的名稱

其他修改的地方有

是否包含導入導出，如果選擇，則會生成導入導出的代碼，導入導出模板則需要參考已有功能(比如數據字典)來完成

是否包含附件管理，如果選擇，則業務對象可以關聯一組附件，比如客戶關聯一組附件，或者申請信息關聯一組附件。

字段信息的顯示名字，這個用于前端列表，表單的顯示，應當輸入中文名字

作為搜索，可以勾選幾個搜索條件，系統自動生成一個搜索配置類

如果字段關聯數據字典，那么設置一個數據字典，這樣，生成的界面將會變成一個下拉列表

1.3.1 前端代碼

前端代碼采用了layui的JS框架，使用了按需加載的方式，文檔參考 http://www.layui.com/doc/base/infrastructure.html.

• index.js: 系統入口JS，包含了查詢和表格
• add.js : 新增操作的所有JS
• edit.js: 編輯操作的所有JS
• del.js: 刪除操作的所有JS

基礎JS

• Common.js: 封裝了通常JS功能，如jquery的post方法，layui的窗口方法
• Lib.js 封裝了業務相關方法，如submitForm，loadOrgPanel等方法

1.3.2 HTML代碼

頁面采用layui，文檔參考 http://www.layui.com/demo/

模板語言了使用Beetl，文檔參考ibeetl.com

• index.html: 功能首頁
• add.html: 新增首頁
• edit.html: 編輯操作首頁

采用layui的好處是自帶了頁面和組件還有JS的管理，能完成大多數業務需求

基礎UI組件：

• orgInput.tag.html 組織機構輸入框
• simpleDictSelect.tag.html 字典下拉列表
• simpleDataSelect.tag 包含key-value的下拉列表
• searchForm.tag.html 通用搜索表單
• submitButtons.tag.html 提交按鈕
• accessButton.tag.html 普通按鈕（含權限）
• attachment.tag.html 附件管理組件
• …

完整代碼下載地址：基于SpringBoot 2+Layui實現的管理后臺系統