基于bboss开发平台eclipse开发工程生成工具介绍

一、工具简介  
bboss开发平台发布出两个资源包： 
war部署包 
数据库初始化工具包

本文介绍采用bboss开发平台eclipse开发工程生成工具基于上述两个资源包来生成一个全新的基于bboss开发平台的eclipse工程，工具包含以下四个部分功能： 
1.生成eclipse开发工程 
2.初始化化平台数据库 
3.生成工程ant构建、版本发布部署脚本 
4.生成tomcat的部署文件

二、工具下载  
首先我们要下载生成工具： 
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. #db_init_tool=D:/d/workspace/bboss-cms/distrib/dbinit-system.zip
5. #指定平台war包的存放目录地址
6. #war=D:/d/workspace/bboss-cms/distrib/WebRoot.war
7. #get lastest version of public development platform from hudson server.
8. #db_init_tool=http://10.0.15.39:8888/hudson/job/v1.2.1.20150518/lastSuccessfulBuild/artifact/distrib/dbinit-system.zip
9. #war=http://10.0.15.39:8888/hudson/job/v1.2.1.20150518/lastSuccessfulBuild/artifact/distrib/bboss.war
10. #get lastest version of public development platform from bboss website.
11. db_init_tool=http://www.bbossgroups.com/tool/download.htm?fileName=dbinit-system.zip
12. war=http://www.bbossgroups.com/tool/download.htm?fileName=bboss.war
13. #if db_init_tool and war not setted,this tool will use dbinit-system.zip and bboss.war which be putted in directory arches.
14. #生成的eclipse工程存放目录,可以根据实际情况修改
15. eclipseworkspace=D:/eclipseworkspace
16. #eclipse工程名称,可以根据实际情况修改
17. projectname=bboss-test
18. #生成工程时先清除之前的文件,可以根据实际情况修改
19. clearproject=true
20. #标识是否需要执行数据库初始化操作,可以根据实际情况修改
21. initdb=true
22. #数据库连接池配置信息,可以根据实际情况修改,也可以使用mysql
23. #oracle
24. driverClassName=oracle.jdbc.driver.OracleDriver
25. url=jdbc:oracle:thin:@//localhost:1521/orcl
26. username=BBOSSTEST
27. password=BBOSSTEST
28. validationQuery=select 1 from dual
29. #mysql
30. #driverClassName=com.mysql.jdbc.Driver
31. #url=jdbc:mysql://10.0.15.134:3306/bbosstest
32. #username=root
33. #password=123456
34. #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

根据需要注释或者放开对应的数据库配置。

四、运行工具生成开发工程

修改完毕后保存，接下来执行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即可。

五、注意事项

工具在执行过程中会可能会下载平台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工程。

六、工程环境设置  
1.eclipse工程编码必须设置为utf-8

2.eclipse工程builder设置

3.eclipse工程jdk版本设置

4.eclipse tomcat插件设置

 
tomcat jdk版本设置必须和工程jdk版本一致：

5.禁用eclipse validation机制  
禁用eclipse validation机制，提升eclipse开发效率，避免不必要的校验操作