S2JH新增WIKI頁面：開發基礎環境配置說明，基於SSH的企業Web應用開發框架

概要說明

如下以我本人實際開發環境爲例，簡要說明開發環境配置過程，供初學者參考。固然你也徹底能夠根據熟悉的開發工具和環境可自行參考調整配置。本說明僅對配置過程予以說明，其中涉及到諸如Maven，Git等工具的使用相關請自行經過其餘渠道瞭解。

提示說明： 如下說明和截圖以本身平時使用的Ubuntu 14  X64位操做系統環境，Windows和32位系統環境請注意對應調整安裝軟件版本和相關路徑參數等。

JDK：JDK6

理論上JDK5+應該均可以，我目前本地是Oracle JDK6，這個安裝我想就不必很少說了。建議安裝Oracle  JDK，網上說OpenJDK存在一些問題，不過具體沒有實際驗證過。

IDE： Spring Tool Suite 3.5 based on Eclipse 4.3.X

（Spring Tool Suite）STS3.5參考下載地址： http://spring.io/tools/sts/all  ，理論上Eclipse系列IDE應該都能正常導入使用。

STS3.5中基本上預裝集成了大部分經常使用插件，如Spring系列，GIT等，同時還包含一個vfabric-tc-server，直接做爲WEB應用開發部署Server，不用再單獨下載配置Tomcat了。

初始化一個Workspace，能夠根據一些常見優化建議，設置Workspace UTF-8編碼，關閉沒必要要的的Startup，Validation選項等，優化STS啓動和工程編譯構建時間。

Apache Maven 3.0.X

Apache Maven目前官方同步發佈3.2, 3.1, 3.0系列，估計是互補兼容的要不也不會幾個版本同時維護更新。 目前本身本地爲maven 3.0.4版本，其餘版本未測試過，所以建議安裝3.0.X系列Maven。

參考下載地址：http://maven.apache.org/download.cgi  注意滾動到Maven 3.0.5區域。

Maven下載到本地解壓後，可根據本身習慣設定本地資源庫地址/私服地址等配置。 而後一個步驟是須要在STS中設定指向本地Maven環境，參考以下圖：

從Git資源庫Checkout工程代碼

根據本身的習慣經過STS的GIT插件或其餘如TortoiseGit等工具，從git資源庫checkout整個工程代碼。OsChina和 GitHub兩個資源庫同步更新，可自行根據訪問狀況選擇，建議優先選擇OsChina Git通常會訪問更快。固然你若是熟悉SVN，能夠選擇GitHub支持SVN Checkout方式。各站點的Checkout方式請自行根據站點對應說明文檔操做。

工程代碼checkout後目錄結構參考如圖：

將工程代碼import到STS的workspace

啓動按照前面已指向設定好Maven的STS Workspace，因爲整個工程結構按照Maven的parent/module模式的父子目錄結構，所以須要以Maven項目方式import導入全部項目，不然若是按照常規的項目導入只會導入parent主目錄工程。

菜單或右鍵選擇import..., 而後按照以下圖示選擇：

而後點擊瀏覽git checkout的s2jh工程主目錄，會自動解析出一系列依賴項目列表：

以後點擊Finish開始導入項目。期間會進行整個項目的初始化編譯構建/Maven資源庫的下載初始化等操做，可能耗時較長，請耐心等待。

以後展開s2jh-parent項目，在pom.xml右鍵選擇「Run As.」 - > "Maven install", STS將自動編譯構建/單元測試/初始化本地資源庫，整個依賴項目列表。最終執行成功以下圖：

Server配置

STS自帶一個基於Tomcat的vfabric-tc-server，能夠直接用於開發調試。以下圖，工做空間默認就已初始化一個Server配 置，以下圖雙擊左側xml配置文件，最基本的須要添加一個 URIEndoing=「UTF-8」的編碼參數，不然get請求會出現中文亂碼問題。其他的諸如端口號/JNDI數據源等可根據實際須要修改便可。框架 默認配置以H2嵌入數據庫運行模式，暫時能夠不用配置數據庫連接參數等。

而後在server上面右鍵選擇 Add/Remove..., 把prototype WEB項目加入的server部署：

初始化Server運行

框架默認配置以H2嵌入數據庫運行模式，首次運行須要初始化數據庫。以下圖，修改對應文件和參數爲true：

以後啓動Server ,查看Console會看到一系列數據庫DDL和DML語句，最終啓動運行完成大體以下圖：

提示：H2數據庫以文件方式運行（具體H2數據文件路徑可經過在啓動日誌中搜索「Using H2 EmbeddedFileDatabase:」對應行內容) ，只需初始化一次便可，所以初始化啓動以後下次啓動Server以前最好改回關閉初數據庫始化參數jdbc.initialize.database.enable=false。

如H2文件路徑信息：Using H2 EmbeddedFileDatabase: /home/java/h2/prototype, 此/home/java/h2/prototype是文件前綴信息不是目錄，其總/home/java/h2纔是一個具體文件目錄，若是在試用樣列應用過 程隨意亂修改數據把應用搞亂了而但願從新初始化數據庫，只需把/home/java/h2目錄下全部prototype爲前綴的文件刪除，並從新設置 jdbc.initialize.database.enable=true運行Server便可。

瀏覽器訪問Web應用

啓動最新版本的FireFox或Chrome或IE8+瀏覽器，訪問：http://localhost:8080/prototype/  ， 出現以下圖所示，無需輸入登陸信息直接點擊下方的測試入口admin入口連接便可進入系統主界面：

開發指南

以後便可參考開發指南部分進行Demo樣列功能開發了！