基於jeesite的cms系統（一）：開發環境搭建

基於jeesite的cms系統系列，是對基於jeesite進行二次開發的博客模塊開發過程的總結。涉及入門安裝，二次開發，部署等

1、概況：

JeeSite 是一個 Java 企業級快速開發平臺，基於經典技術（Spring Boot、Spring MVC、Apache Shiro、MyBatis、Beetl、Bootstrap、AdminLTE）組合，方便的在線代碼生成功能，包括核心模塊如：組織機構、角色用戶、菜單及按鈕受權、數據權限、系統參數、內容管理、工做流等。採用鬆耦合設計；界面無刷新，一鍵換膚；衆多帳號安全設置，密碼策略；在線定時任務配置；支持集羣，支持SAAS；支持多數據源。

 

2、界面：

 

3、源代碼和文檔

源代碼：jeesite：https://gitee.com/thinkgem/jeesite4

　　　　jeesite+cms：https://gitee.com/Vito-Yan/yuosc-cms

文檔：https://jeesite.gitee.io/docs/

 

4、開發環境搭建：https://jeesite.gitee.io/docs/install-deploy/

環境要求

一、Java SDK 1.8 下載

二、Eclipse IDE for Java EE Mars 2 (4.5.2) 下載（依 Eclipse 舉例，IDEA 雷同。）

三、Apache Maven 3.3.0+ 下載

四、MySql 5.7.11+ 下載

導入到Eclipse

一、檢出JeeSite4源代碼：

git clone https://gitee.com/thinkgem/jeesite4.git

二、拷貝web文件夾，到你的工做目錄（不包含中文和空格的目錄）下，重命名爲你的工程名，如：jeesite-demo

三、打開pom.xml文件，修改第13行，artifactId爲你的工程名，如：<artifactId>jeesite-demo</artifactId>

四、導入到Eclipse，菜單 File -> Import，而後選擇 Maven -> Existing Maven Projects，點擊 Next> 按鈕，選擇第2步的jeesite-demo文件夾，而後點擊 Finish 按鈕，便可成功導入

五、這時，Eclipse會自動加載Maven依賴包，初次加載會比較慢（根據自身網絡狀況而定），若工程上有小叉號，請打開Problems窗口，查看具體錯誤內容，直到無錯誤爲止

六、下載過程當中你能夠準備數據庫環境了

若在部署過程當中碰見問題，請在「常見問題」中找找，看看有沒有和你相同的問題

初始化數據庫

一、以MySql爲例，配置 my.ini

1）打開 my.ini 給 [mysqld] 增長以下配置： sql_mode="ONLY_FULL_GROUP_BY,STRICT_TRANS_TABLES,ERROR_FOR_DIVISION_BY_ZERO,NO_AUTO_CREATE_USER,NO_ENGINE_SUBSTITUTION" 2）若是遇到 ERROR 1709 (HY000): Index column size too large. The maximum column size is 767 bytes. # 錯誤，請加入以下配置： innodb_large_prefix = ON innodb_file_format = Barracuda innodb_file_per_table = ON 並修改報錯的建表語句後面加上：ENGINE=InnoDB row_format=DYNAMIC; 

二、 建立用戶和受權

set global read_only=0; set global optimizer_switch='derived_merge=off'; create user 'jeesite'@'%' identified by 'jeesite'; create database jeesite DEFAULT CHARSET 'utf8mb4' COLLATE 'utf8mb4_unicode_ci'; grant all privileges on jeesite.* to 'jeesite'@'%' identified by 'jeesite'; flush privileges; 

三、 打開文件 /src/main/resources/config/application.yml（v4.0.x：/src/main/resources/config/jeesite.yml） 配置產品和項目名稱及JDBC鏈接

# 產品或項目名稱、軟件開發公司名稱 productName: JeeSite Demo companyName: ThinkGem # 產品版本、版權年份 productVersion: V4.1 copyrightYear: 2018 # 數據庫鏈接 jdbc: # Mysql 數據庫配置 type: mysql driver: com.mysql.jdbc.Driver url: jdbc:mysql://127.0.0.1:3306/jeesite?useSSL=false&useUnicode=true&characterEncoding=utf-8&zeroDateTimeBehavior=convertToNull username: jeesite password: jeesite testSql: SELECT 1 

四、若剛纔導入到的Eclipse的項目已經完成加載jar並沒有錯誤，你就能夠執行/bin/init-data.bat腳本初始化數據庫了，第一次執行若是碰見table xxx doesn't exist的錯誤信息，忽略便可。

五、若是init-data.bat沒法運行，你也能夠直接在Eclipse裏找到com.jeesite.test.InitCoreData.java文件並打開，而後在空白處右鍵，點擊 Run As -> JUnit Test 運行單元測試，進行初始化數據庫腳本。爲了防止誤操做，你還須要：打開 Run Configurations 找到 Arguments 選項卡，在 VM arguments 裏增長 「-Djeesite.initdata=true」 參數，點擊Run運行，執行完成後建議將該單元測試 Run Configuration 刪除掉，防止誤操做，不當心再把你的有用數據清理掉。

啓動Tomcat服務

一、當前是 Spring Boot 工程，內部已經集成 Web 容器，你無需另外再下載 Tomcat 進行部署，只需按照如下方式進行便可。

二、打開/src/main/resources/config/application.yml文件，配置你的服務端口port、部署路徑context-path，例如:

server: port: 8980 servlet: context-path: /jeesite-demo tomcat: uri-encoding: UTF-8 

v4.0.x：

server: port: 8980 context-path: /jeesite-demo tomcat: uri-encoding: UTF-8 

三、在Eclipse裏找到com.jeesite.modules.Application.java（v4.0.x：com.jeesite.modules.config.Application.java）文件並打開，而後在空白處右鍵，點擊 Debug As -> Java Application 便可啓動服務。

四、注意使用 Debug 運行，有助於你調試程序和提高開發效率，如：修改方法內的代碼，修改視圖代碼，修改mapper代碼，是不須要重啓Web服務的。若是改變java類的結構，若是增刪屬性、方法、參數等，新增文件，這是就須要重啓服務。

瀏覽器訪問

一、地址：http://127.0.0.1:8980/jeesite-demo

二、默認最高管理員帳號：system 密碼：admin

三、這時已經配置完成，開啓你的開發之旅吧

清理Demo數據

爲了演示方法，初始化數據庫後會載入一些演示數據，執行如下腳本便可清理

DELETE FROM js_sys_post; DELETE FROM js_sys_office; DELETE FROM js_sys_company; DELETE FROM js_sys_employee; DELETE FROM js_sys_employee_post; DELETE FROM js_sys_role WHERE role_code NOT IN ('corpAdmin','default'); DELETE FROM js_sys_role_data_scope; DELETE FROM js_sys_user WHERE user_code NOT IN ('system','admin'); DELETE FROM js_sys_user_data_scope; DELETE FROM js_sys_user_role; DELETE FROM js_sys_log; 

使用本身的package包路徑

一、Application.java 的 @SpringBootApplication(scanBasePackages="包路徑") 增長你的包路徑

二、application.yml 中找到 mybatis: scanBasePackage: 增長你的包路徑，用逗號隔開

三、默認代碼生成包路徑修改：菜單系統設置->參數設置的gen.defaultPackageName爲你的包名

四、打開 logback-spring.xml，配置日誌級別 <logger name="包路徑" level="DEBUG" />

五、完成

部署到正式服務器

一、確保正式服務器jdk1.8及數據庫環境已經具有

二、配置系統環境變量JAVA_HOME指定jdk1.8路徑，注意不要包含空格

三、執行bin/package.bat(.sh)進行打成war包文件，並將此war拷貝到服務器上

四、進行解壓war包，配置yml相關參數，運行/WEB-INF/startup.bat(.sh)腳本

五、若需修改jvm參數，編輯startup.bat(.sh)修改JAVA_OPTS參數優化jvm環境

六、支持啓動參數增長-Dspring.config.location=x:/app.yml加載指定配置文件

七、若須要配置環境，則指定-Dspring.profiles.active=dev，則加載application-dev.yml屬性文件

 

5、二次開發注意事項 

一、只須要拷貝源代碼中的web文件夾，這裏面是test Demo，項目核心jar包已經pom集成了。

二、可能會遇到數據庫問題，按照第四步驟解決。