JEESZ 分佈式框架開發環境部署

1. 環境準備

1. 開發工具： Eclipse IDE（建議使用高一點的版本）

2. JDK 版本：JDK1.7

3. 項目管理： Maven3.1.1

2. 安裝步驟

1. 安裝 jdk1.7 並配置環境變量（相信你們都會作，這裏再也不作重複的說明）

2. 安裝 maven：maven 安裝過程就是解壓縮的過程（我已經幫你們解壓了,目錄：E:\myprj\jeesz-maven\apache-maven-3.1.1）,爲了方便你們，這邊已經提供了相關的安裝包，會在打包的目錄下共享。

3. mavan配置環境變量，右擊個人電腦à屬性à高級系統設置à環境變量à找到（系統變量 path），在最前面輸入你的 maven安裝包路徑，聲明：由於上一步解壓了指定的目錄，因此配置以下：

E:\myprj\jeesz-maven\apache-maven-3.1.1\bin;

相信你們都有配過環境變量，若是您不是很清楚，請查詢相關資料，瞭解一下 maven的相關知識。

4. 打開 cmd，在裏面敲：mvn –version，出現如下結果說明你 maven 安裝成功了

 

mvn 是 maven 的一個指令，mvn -version 是查看版本信息，個人操做系統是 64位的 WIN7，安裝的 maven 是 3.1.1，若是能打印如上信息，說明到此 Maven3 已經在你的電腦上安裝完成。

5. 建立工做空間(進入後選中 j2ee 視圖)

6. 配置 Eclipse 編碼爲 UTF-8

Eclipse 工具欄中選擇 WindowPrefrencesGeneralWorkspace

7. 配置 jre 環境(以前你們須要安裝了 jdk1.7 版本，這裏就使用安裝好的 jdk進行配置)：

 

選擇 Window-Prefrences-java-Installed JREs-Edit-選擇本身本地 jdk 安裝路徑-Finished-OK

 

8. 去除 JavaScript 的驗證等信息（由於項目中大量使用 js、css、xml 等其餘不一樣格式的文件，考慮到每次編譯的執行時間，因此這邊臨時將一些驗證信息去除）

Window-Prefrences-Validation-Suspend all validators-ok

 

9. 修 改 剛 剛 安 裝 的 maven settings.xml 配 置 文 件 ， 路 徑 如 下 ：E:\myprj\jeesz-maven\apache-maven-3.1.1\conf, 添 加 本 地 庫 地 址 ：<localRepository>E:/myprj/jeesz-maven/apache-maven-3.1.1/repository</localRepository>

修改中央庫路徑（在網絡正常的狀況下，能夠從遠程中央庫下載缺失的jar 包,我這裏使用了 Oschina 的中央庫，若是網絡有問題，你們可使用本身公司的私服進行加載相關 jar包），考慮到你們包有時候下載不下來，我這裏也給你們共享了項目所須要的 jar 包，所有放到了如下目錄：E:/myprj/jeesz-maven/apache-maven-3.1.1/repository

10. Eclipse 中配置 maven 安裝目錄和 Setting 文件加載的本地庫目錄

11. 導入 Maven 項目

File-Import-Existing Maven Projects-下一步

選擇你本地的 maven 項目（請選中 jeesz-project 根目錄），點擊肯定：

加載出來全部項目後，點擊 finish 完成

提醒：這個導入的過程要一段時間，由於我本地鏈接網絡，因此會從遠程中央庫下載項目所須要的全部的 jar 包，請你們耐心等候。若是你使用了本地庫則不須要等待很長時間，若是是使用公司私服，則等待時間也不會很長。導入後的項目信息：

本地庫的包已經下載了：

12. 下載完全部 jar 包，更新 maven 項目：

1) 選中全部項目 2) 右鍵選擇 maven-Update project…-選擇全部-勾選關聯項-點擊 ok

若是項目還出現紅 X 錯誤，則一定是缺乏相關的 jar 包，可使用：Window-showView-problem 窗口查看異常信息：

若是缺乏 jar 包，能夠將咱們提供的 jar 包直接 copy 到你指定目錄便可。

待項目裏面的全部錯誤所有清零後才能進行下一步工做（以下圖所示）選中全部項目，對項目進行清理：Project-clean

13. 嘗試對項目進行編譯、打包看是否有問題：

注意：通常咱們打包編譯是針對於根項目，由於裏面配置了全部的依賴關係。右鍵 jeesz-project-Run As-Maven build

在彈出的對話框中錄入 clean install –X 命令，勾選 Skip tests，Run…提醒：若是對 maven 命令不是很熟的，能夠去查下相關的資料這邊簡單作下解釋：clean install –X 表示清理全部項目並將 jar 包裝載到本地庫，其中-X 表示輸出的信息（通常在出現 maven 問題的時候可使用-X 來定位問題。）

此時控制檯開始編譯裝載全部的包，這個過程有點漫長，請你們耐心等候。

出現如下結果說明項目是正常的。

打好的包（包含 war、jar），都在 target 文件夾下，這邊只以 jeesz-web-admin爲實例截圖以下

14. 使用 Tomcat 發佈 jeesz 項目（發佈過程不作詳細介紹，你們都會作）：

下面對各個不一樣的項目進行介紹：

Jeesz-web-admin: 能夠獨立部署（後臺管理平臺）
Jeesz-web-service:能夠獨立部署（REST 服務平臺，客戶能夠根據本身的業務去拓展 Rest 服務，裏面已經寫好了相關的實例）

Jeesz-service-bookmark、jeesz-service-task 爲 dubbo 服務提供者（這邊只經過收藏和待辦項目來對 dubbo 服務項目開發作相關介紹，客戶能夠根據本身的業務去拓展 dubbo 服務，能夠同時部署，也能夠拆分部署）

Jeesz-web-bookmark、jeesz-web-task 爲 dubbo 消費者平臺，其中 dubbo 服務對外暴漏的服務接口爲：Jeesz-facade-bookmark、jeesz-façade-task（這邊只經過收藏和待辦項目來描述 dubbo 客戶端怎樣調用 dubbo 服務提供者的過程，客戶能夠將 dubbo 消費端植入到不一樣的項目中，只須要作一些簡單配置就能夠了）

部署條件：

1) 執行 mysql 數據庫腳本: jeesz.sql

數據庫 jdbc 的配置項能夠參考

2) Jeesz-web-admin 能夠直接經過 tomcat 部署

登錄用戶名密碼：jeesz/admin

3) Jeesz-web-service:能夠經過 tomcat 獨立部署

登錄用戶名密碼：jeesz/admin

4) 部署 dubbo 相關的項目須要具有如下條件：
➢ 安裝 dubbo 管控平臺，將 war 包解壓到 tomcat，並將目錄替換爲

根目錄，直接啓動 tomcat 便可（開發環境提供 window）

➢ Zookeeper 註冊中心安裝，我這邊提供了 zookeeper-3.4.5 版本（開發環境提供 window），進入安裝目錄啓動便可

提醒： 我這邊已經給提供了相關的程序，其中 dubbo 管控平臺要獨立部署在 Tomcat 服務器上，這個不須要進行高可用配置，直接啓動tomcat 就能夠啓動。Zookeeper 註冊中心有相關的命令能夠直接運行啓動。若是想部署在 linux 系統上，能夠看咱們提供的相關文檔便可。

5) 待 dubbo 管控臺和註冊中心啓動 ok，則將 Jeesz-service-bookmark、jeesz-service-task 項目同時（能夠獨立部署）部署到 tomat 中，爲 dubbo服務提供者

6) 登錄 dubbo 管控臺查看相關的服務信息，能夠看到你發佈的服務已經由管控臺進行管控了：http://localhost:80 直接經過地址能夠訪問是由於將包名改成了 Root   用戶名密碼：root/root 

7) 分部部署 Jeesz-web-bookmark、jeesz-web-task dubbo 消費者項目，目的是讓開發人員瞭解服務是怎樣調用的。

到此整個項目的安裝過程先到這裏，請各位開發人員安裝完項目後投入開發，全部的業務直接服務化，由於項目是基於驅動開發的，故將大家的表設計好，經過 jeesz-web-admin 項目的 gen 代碼生成模塊自動生成全部的 controller、service、dao、xml、jsp 界面等，直接進行業務編寫處理。近期會不斷的完善文檔，請時刻關注。