基於bboss開發平臺eclipse開發工程生成工具介紹

基於bboss開發平臺eclipse開發工程生成工具介紹 

1、工具簡介  
bboss開發平臺發佈出兩個資源包： 
war部署包 
數據庫初始化工具包 

本文介紹採用bboss開發平臺eclipse開發工程生成工具基於上述兩個資源包來生成一個全新的基於bboss開發平臺的eclipse工程，工具包含如下四個部分功能： 
1.生成eclipse開發工程 
2.初始化化平臺數據庫 
3.生成工程ant構建、版本發佈部署腳本 
4.生成tomcat的部署文件 

2、工具下載  
首先咱們要下載生成工具： 
1.下載源碼構建生成工具  
github下載地址： 下載  

svn下載地址： 
https://github.com/bbossgroups/genproject 

源碼下載完畢後，執行ant構建生成工具(先要 下載ant ，而後將ant bin添加到環境變量path中，例如：F:\environment\apache-ant-1.8.4\bin)，執行指令：genproject/build.bat 

構建執行完畢後，工具將會被髮布到如下目錄中： 
genproject/distrib/run 

2.直接從官網下載發佈包：下載  

三.工具配置  
接下來就能夠修改工具配置文件,咱們根據配置文件中的配置來生成一個暫新的eclipse開發工程。 

若是是源碼構建，則修改genproject/distrib/run目錄下的配置文件：config.properties 

若是是下載了發佈包，則只須要解壓genproject.zip包，修改根目錄下的config.properties文件便可。 

config.properties內容以下： 

Java代碼  

1. #工具主程序  
2. mainclass= org.frameworkset.platform.genproject.GenProject  
3.   
4. #指定數據庫壓縮包的存放目錄地址  
5. #db_init_tool=D:/d/workspace/bboss-cms/distrib/dbinit-system.zip  
6. #指定平臺war包的存放目錄地址  
7. #war=D:/d/workspace/bboss-cms/distrib/WebRoot.war  
8.   
9. #get lastest version of public development platform from hudson server.  
10. #db_init_tool=http://10.0.15.39:8888/hudson/job/v1.2.1.20150518/lastSuccessfulBuild/artifact/distrib/dbinit-system.zip  
11. #war=http://10.0.15.39:8888/hudson/job/v1.2.1.20150518/lastSuccessfulBuild/artifact/distrib/bboss.war  
12.   
13. #get lastest version of public development platform from bboss website.  
14. db_init_tool=http://www.bbossgroups.com/tool/download.htm?fileName=dbinit-system.zip  
15. war=http://www.bbossgroups.com/tool/download.htm?fileName=bboss.war  
16.   
17. #if db_init_tool and war not setted,this tool will use dbinit-system.zip and bboss.war which be putted in directory arches.  
18.   
19. #生成的eclipse工程存放目錄,能夠根據實際狀況修改  
20. eclipseworkspace=D:/eclipseworkspace  
21. #eclipse工程名稱,能夠根據實際狀況修改  
22. projectname=bboss-test  
23. #生成工程時先清除以前的文件,能夠根據實際狀況修改  
24. clearproject=true  
25.   
26.   
27. #標識是否須要執行數據庫初始化操做,能夠根據實際狀況修改  
28. initdb=true  
29.   
30. #數據庫鏈接池配置信息,能夠根據實際狀況修改,也能夠使用mysql  
31. #oracle  
32. driverClassName=oracle.jdbc.driver.OracleDriver  
33. url=jdbc:oracle:thin:@//localhost:1521/orcl  
34. username=BBOSSTEST   
35. password=BBOSSTEST  
36. validationQuery=select 1 from dual  
37.   
38. #mysql  
39. #driverClassName=com.mysql.jdbc.Driver  
40. #url=jdbc:mysql://10.0.15.134:3306/bbosstest  
41. #username=root  
42. #password=123456  
43. #validationQuery=select 1  

配置文件中只須要修改數據庫鏈接池配置信息配置信息、生成的eclipse工程存放目錄、eclipse工程名稱、指定平臺war包的存放目錄地址、指定數據庫壓縮包的存放目錄地址4個部分的內容便可。 

oracle配置： 
#oracle 
driverClassName=oracle.jdbc.driver.OracleDriver 
url=jdbc:oracle:thin:@//localhost:1521/orcl 
username=BBOSSTEST 
password=BBOSSTEST 
validationQuery=select 1 from dual 

mysql配置 
#mysql 
driverClassName=com.mysql.jdbc.Driver 
url=jdbc:mysql://10.0.15.134:3306/bbosstest 
username=root 
password=123456 
validationQuery=select 1 

根據須要註釋或者放開對應的數據庫配置。 

4、運行工具生成開發工程  

修改完畢後保存，接下來執行genproject/distrib/run/setup.bat指令或者genproject/setup.bat便可,將會： 
1.生成eclipse開發工程，導入eclipse或者myeclipse便可開始基於bboss業務系統的開發之旅 
2.初始化化平臺數據庫鏈接池配置 
3.初始化平臺數據庫（initdb設置爲true時） 
4.生成工程ant構建、版本發佈部署腳本，執行構建指令將會發布出新項目的jar包和war包 
5.生成tomcat的部署文件，能夠將其拷貝到tomcat/conf/Catalina/localhost目錄下，直接部署剛生成的web應用，訪問地址爲： 
http://localhost:8080/projectname 

其中projectname對應爲config.properties文件中的projectname屬性，打開的登錄頁面輸入帳號admin，口令123456便可訪問新建的項目了。  
最終生成的eclipse工程目錄結構圖（假設工程名稱爲:bboss-test）:  

 
咱們直接將生成的工程導入eclipse，編譯經過後，將tomcat部署文件bboss-test.xml拷貝到tomcat/conf/Catalina/localhost目錄下，而後啓動tomcat，在瀏覽器中輸入： 
http://localhost:8080/bboss-test 

使用帳戶admin，口令123456便可訪問bboss-test這個項目了。 

若是須要發佈版本只須要配好ant構建環境，而後執行build.bat便可。 

5、注意事項  

工具在執行過程當中會可能會下載平臺war包和數據庫初始化zip包： 
若是config.properties中沒有指定db_init_tool和war這兩個屬性，則直接從genproject/arches目錄下查找平臺的兩個資源包（咱們能夠手動到bboss官網下載這兩個資源包並放入genproject/arches目錄： dbinit-system.zip ， bboss.war ，這樣就能夠把配置文件中的db_init_tool和war這兩個屬性註釋掉） 
若是db_init_tool和war兩個屬性指定爲本地目錄的其餘地址，（咱們能夠手動到bboss官網下載這兩個資源包並放入特定的目錄下： dbinit-system.zip ， bboss.war ，這樣就能夠把配置文件中的db_init_tool和war這兩個屬性配置對應的目錄便可 

若是db_init_tool和war兩個屬性配置爲官網地址或者hudson持續集成服務器地址，則在執行過程當中自動下載這兩個資源包，而後繼續生成eclipse工程。 

6、工程環境設置  
1.eclipse工程編碼必須設置爲utf-8  

 

2.eclipse工程builder設置  

 

3.eclipse工程jdk版本設置  

 

4.eclipse tomcat插件設置  

 

 
tomcat jdk版本設置必須和工程jdk版本一致： 

 

5.禁用eclipse validation機制  
禁用eclipse validation機制，提高eclipse開發效率，避免沒必要要的校驗操做