基于bboss开发平台eclipse开发工程生成工具介绍
卫宁
基于bboss开发平台eclipse开发工程生成工具介绍
[size=xx-large][b]一、工具简介[/b][/size]
bboss开发平台发布出两个资源包：
war部署包： [url=http://www.bbossgroups.com/tool/download.htm?fileName=bboss.war]bboss.war[/url]
数据库初始化工具包： [url=http://www.bbossgroups.com/tool/download.htm?fileName=dbinit-system.zip]dbinit-system.zip[/url]
本文介绍采用bboss开发平台eclipse开发工程生成工具基于上述两个资源包来生成一个全新的基于bboss开发平台的eclipse工程，工具包含以下四个部分功能：
1.生成eclipse开发工程
2.初始化化平台数据库
3.生成工程ant构建、版本发布部署脚本
4.生成tomcat的部署文件
[b][size=xx-large]二、工具下载[/size][/b]
首先我们要下载生成工具：
[size=x-large][b]1.下载源码构建生成工具[/b][/size]
github下载地址：[url=https://codeload.github.com/bbossgroups/genproject/zip/master]下载[/url]
svn下载地址：
https://github.com/bbossgroups/genproject
源码下载完毕后，执行ant构建生成工具，参考文档[url=http://yin-bp.iteye.com/blog/1462842]bboss 版本ant构建方法及版本升级指南[/url]中的:
【3.在执行后续所有步骤之前，必须先下载buildtool项目：buildtool-master.zip 】小节
和【4.2.8 bboss genproject（bboss平台开发环境搭建工具）构建 】小节进行构建。
构建执行完毕后，工具将会被发布到以下目录中：
genproject/distrib/run
[size=x-large][b]2.直接从官网下载发布包：[url=http://www.bbossgroups.com/tool/download.htm?fileName=genproject.zip]下载[/url][/b][/size]
[size=xx-large][b]三.工具配置[/b][/size]
接下来就可以修改工具配置文件,我们根据配置文件中的配置来生成一个暂新的eclipse开发工程。
如果是源码构建，则修改genproject/distrib/run目录下的配置文件：config.properties
如果是下载了发布包，则只需要解压genproject.zip包，修改根目录下的config.properties文件即可。
config.properties内容如下：
配置文件中只需要修改数据库连接池配置信息配置信息、生成的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数据库引擎必须采用Innodb引擎，数据库字符编码必须采用UTF-8
#mysql
driverClassName=com.mysql.jdbc.Driver
url=jdbc:mysql://10.0.15.134:3306/bbosstest
username=root
password=123456
validationQuery=select 1
根据需要注释或者放开对应的数据库配置。
[color=indigo][size=large][b]如果出现mysql客户端中文乱码问题，可以在url中指定utf-8字符编码，例如：
jdbc:mysql://localhost:3306/itwork?useUnicode=true&characterEncoding=utf-8[/b][/size][/color]
在数据源的配置文件中，需要对&进行特殊处理用cdata转义即可：
<property name="url"><![CDATA[jdbc:mysql://localhost:3306/spiderweb?useUnicode=true&characterEncoding=utf-8]]></property>
[size=xx-large][b]四、运行工具生成开发工程[/b][/size]
修改完毕后保存，接下来执行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
[size=large][color=darkblue][b]其中projectname对应为config.properties文件中的projectname属性，打开的登陆页面输入账号admin，口令123456即可访问新建的项目了。[/b][/color][/size]
[size=large][b]最终生成的eclipse工程目录结构图（假设工程名称为:bboss-test）:[/b][/size]
[img]http://dl2.iteye.com/upload/attachment/0111/3881/a063f563-6488-34f7-9950-bc48eed4d86c.png[/img]
我们直接将生成的工程导入eclipse，编译通过后，将tomcat部署文件bboss-test.xml拷贝到tomcat/conf/Catalina/localhost目录下，然后启动tomcat，在浏览器中输入：
http://localhost:8080/bboss-test
使用账户admin，口令123456即可访问bboss-test这个项目了。
如果需要发布版本只需要配好ant构建环境，然后执行build.bat即可。
如果在tomcat启动过程中出现以下异常：
那么可以修改tomcat配置文件apache-tomcat-xxxx\conf\catalina.properties,在配置项
tomcat.util.scan.StandardJarScanFilter.jarsToSkip
（某些版本可能是tomcat.util.scan.DefaultJarScanner.jarsToSkip）
的后面加一个*即可，如下所示：
[img]http://dl2.iteye.com/upload/attachment/0118/0897/6bdbd78c-f0f6-3438-9c60-b0c78746b914.png[/img]
[size=xx-large][b]五、注意事项[/b][/size]
工具在执行过程中会可能会下载平台war包和数据库初始化zip包：
如果config.properties中没有指定db_init_tool和war这两个属性，则直接从genproject/arches目录下查找平台的两个资源包（我们可以手动到bboss官网下载这两个资源包并放入genproject/arches目录：[url=http://www.bbossgroups.com/tool/download.htm?fileName=dbinit-system.zip]dbinit-system.zip[/url]，[url=http://www.bbossgroups.com/tool/download.htm?fileName=bboss.war]bboss.war[/url]，这样就可以把配置文件中的db_init_tool和war这两个属性注释掉）
如果db_init_tool和war两个属性指定为本地目录的其他地址，（我们可以手动到bboss官网下载这两个资源包并放入特定的目录下：[url=http://www.bbossgroups.com/tool/download.htm?fileName=dbinit-system.zip]dbinit-system.zip[/url]，[url=http://www.bbossgroups.com/tool/download.htm?fileName=bboss.war]bboss.war[/url]，这样就可以把配置文件中的db_init_tool和war这两个属性配置对应的目录即可
如果db_init_tool和war两个属性配置为官网地址或者hudson持续集成服务器地址，则在执行过程中自动下载这两个资源包，然后继续生成eclipse工程。
[size=xx-large][b]六、工程环境设置[/b][/size]
[size=large][b]1.eclipse工程编码必须设置为utf-8[/b][/size]
[img]http://dl2.iteye.com/upload/attachment/0114/1725/92fd8d90-8b31-32d1-910b-adcee80c489d.gif[/img]
[size=large][b]2.eclipse工程builder设置[/b][/size]
[img]http://dl2.iteye.com/upload/attachment/0114/1727/18e062bd-1d10-3255-ba9f-0f4da694c613.gif[/img]
[size=large][b]3.eclipse工程jdk版本设置[/b][/size]
[img]http://dl2.iteye.com/upload/attachment/0114/1729/85a18e6c-c724-3e51-8d38-0e2eb55cc3e3.gif[/img]
[size=large][b]4.eclipse tomcat插件设置[/b][/size]
eclipse tomcat plugin下载地址：[url=http://www.eclipsetotale.com/tomcatPlugin.html]下载[/url] 下载完毕解压到eclipse\dropins目录下即可
[img]http://dl2.iteye.com/upload/attachment/0114/1731/ef1eb5d0-6aef-3f5e-ad1d-3b32fdc17a16.gif[/img]
[img]http://dl2.iteye.com/upload/attachment/0114/1735/1d38d660-e9e6-3f37-9841-44d6c81474d5.gif[/img]
tomcat jdk版本设置必须和工程jdk版本一致：
[img]http://dl2.iteye.com/upload/attachment/0114/1733/6182b2d4-0adf-3192-96ec-90b392d77679.gif[/img]
[size=large][b]5.禁用eclipse validation机制[/b][/size]
禁用eclipse validation机制，提升eclipse开发效率，避免不必要的校验操作
[img]http://dl2.iteye.com/upload/attachment/0114/1737/0693d491-3ae1-3e55-8b8f-879b37dabeba.gif[/img]
[size=xx-large][b]一、工具简介[/b][/size]
bboss开发平台发布出两个资源包：
war部署包： [url=http://www.bbossgroups.com/tool/download.htm?fileName=bboss.war]bboss.war[/url]
数据库初始化工具包： [url=http://www.bbossgroups.com/tool/download.htm?fileName=dbinit-system.zip]dbinit-system.zip[/url]
本文介绍采用bboss开发平台eclipse开发工程生成工具基于上述两个资源包来生成一个全新的基于bboss开发平台的eclipse工程，工具包含以下四个部分功能：
1.生成eclipse开发工程
2.初始化化平台数据库
3.生成工程ant构建、版本发布部署脚本
4.生成tomcat的部署文件
[b][size=xx-large]二、工具下载[/size][/b]
首先我们要下载生成工具：
[size=x-large][b]1.下载源码构建生成工具[/b][/size]
github下载地址：[url=https://codeload.github.com/bbossgroups/genproject/zip/master]下载[/url]
svn下载地址：
https://github.com/bbossgroups/genproject
源码下载完毕后，执行ant构建生成工具，参考文档[url=http://yin-bp.iteye.com/blog/1462842]bboss 版本ant构建方法及版本升级指南[/url]中的:
【3.在执行后续所有步骤之前，必须先下载buildtool项目：buildtool-master.zip 】小节
和【4.2.8 bboss genproject（bboss平台开发环境搭建工具）构建 】小节进行构建。
构建执行完毕后，工具将会被发布到以下目录中：
genproject/distrib/run
[size=x-large][b]2.直接从官网下载发布包：[url=http://www.bbossgroups.com/tool/download.htm?fileName=genproject.zip]下载[/url][/b][/size]
[size=xx-large][b]三.工具配置[/b][/size]
接下来就可以修改工具配置文件,我们根据配置文件中的配置来生成一个暂新的eclipse开发工程。
如果是源码构建，则修改genproject/distrib/run目录下的配置文件：config.properties
如果是下载了发布包，则只需要解压genproject.zip包，修改根目录下的config.properties文件即可。
config.properties内容如下：
#工具主程序
mainclass= org.frameworkset.platform.genproject.GenProject
#指定数据库压缩包的存放目录地址
#db_init_tool=D:/d/workspace/bboss-cms/distrib/dbinit-system.zip
#指定平台war包的存放目录地址
#war=D:/d/workspace/bboss-cms/distrib/WebRoot.war
#get lastest version of public development platform from hudson server.
#db_init_tool=http://10.0.15.39:8888/hudson/job/v1.2.1.20150518/lastSuccessfulBuild/artifact/distrib/dbinit-system.zip
#war=http://10.0.15.39:8888/hudson/job/v1.2.1.20150518/lastSuccessfulBuild/artifact/distrib/bboss.war
#get lastest version of public development platform from bboss website.
db_init_tool=http://www.bbossgroups.com/tool/download.htm?fileName=dbinit-system.zip
war=http://www.bbossgroups.com/tool/download.htm?fileName=bboss.war
#if db_init_tool and war not setted,this tool will use dbinit-system.zip and bboss.war which be putted in directory arches.
#生成的eclipse工程存放目录,可以根据实际情况修改
eclipseworkspace=D:/eclipseworkspace
#eclipse工程名称,可以根据实际情况修改
projectname=bboss-test
#生成工程时先清除之前的文件,可以根据实际情况修改
clearproject=true
#标识是否需要执行数据库初始化操作,可以根据实际情况修改
initdb=true
#数据库连接池配置信息,可以根据实际情况修改,也可以使用mysql
#oracle
driverClassName=oracle.jdbc.driver.OracleDriver
url=jdbc:oracle:thin:@//localhost:1521/orcl
username=BBOSSTEST
password=BBOSSTEST
validationQuery=select 1 from dual
#mysql
#driverClassName=com.mysql.jdbc.Driver
#url=jdbc:mysql://10.0.15.134:3306/bbosstest
#username=root
#password=123456
#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数据库引擎必须采用Innodb引擎，数据库字符编码必须采用UTF-8
#mysql
driverClassName=com.mysql.jdbc.Driver
url=jdbc:mysql://10.0.15.134:3306/bbosstest
username=root
password=123456
validationQuery=select 1
根据需要注释或者放开对应的数据库配置。
[color=indigo][size=large][b]如果出现mysql客户端中文乱码问题，可以在url中指定utf-8字符编码，例如：
jdbc:mysql://localhost:3306/itwork?useUnicode=true&characterEncoding=utf-8[/b][/size][/color]
在数据源的配置文件中，需要对&进行特殊处理用cdata转义即可：
<property name="url"><![CDATA[jdbc:mysql://localhost:3306/spiderweb?useUnicode=true&characterEncoding=utf-8]]></property>
[size=xx-large][b]四、运行工具生成开发工程[/b][/size]
修改完毕后保存，接下来执行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
[size=large][color=darkblue][b]其中projectname对应为config.properties文件中的projectname属性，打开的登陆页面输入账号admin，口令123456即可访问新建的项目了。[/b][/color][/size]
[size=large][b]最终生成的eclipse工程目录结构图（假设工程名称为:bboss-test）:[/b][/size]
[img]http://dl2.iteye.com/upload/attachment/0111/3881/a063f563-6488-34f7-9950-bc48eed4d86c.png[/img]
我们直接将生成的工程导入eclipse，编译通过后，将tomcat部署文件bboss-test.xml拷贝到tomcat/conf/Catalina/localhost目录下，然后启动tomcat，在浏览器中输入：
http://localhost:8080/bboss-test
使用账户admin，口令123456即可访问bboss-test这个项目了。
如果需要发布版本只需要配好ant构建环境，然后执行build.bat即可。
如果在tomcat启动过程中出现以下异常：
SEVERE: ContainerBase.addChild: start:
Caused by: java.lang.IllegalStateException: Unable to complete the scan for annotations for web application [/bboss-test] due to a StackOverflowError. Possible root causes include a too low setting for -Xss and illegal cyclic inheritance dependencies. The class hierarchy being processed was [org.jax
en.util.AncestorAxisIterator->org.jaxen.util.AncestorOrSelfAxisIterator->org.jaxen.util.AncestorAxisIterator]
那么可以修改tomcat配置文件apache-tomcat-xxxx\conf\catalina.properties,在配置项
tomcat.util.scan.StandardJarScanFilter.jarsToSkip
（某些版本可能是tomcat.util.scan.DefaultJarScanner.jarsToSkip）
的后面加一个*即可，如下所示：
[img]http://dl2.iteye.com/upload/attachment/0118/0897/6bdbd78c-f0f6-3438-9c60-b0c78746b914.png[/img]
[size=xx-large][b]五、注意事项[/b][/size]
工具在执行过程中会可能会下载平台war包和数据库初始化zip包：
如果config.properties中没有指定db_init_tool和war这两个属性，则直接从genproject/arches目录下查找平台的两个资源包（我们可以手动到bboss官网下载这两个资源包并放入genproject/arches目录：[url=http://www.bbossgroups.com/tool/download.htm?fileName=dbinit-system.zip]dbinit-system.zip[/url]，[url=http://www.bbossgroups.com/tool/download.htm?fileName=bboss.war]bboss.war[/url]，这样就可以把配置文件中的db_init_tool和war这两个属性注释掉）
如果db_init_tool和war两个属性指定为本地目录的其他地址，（我们可以手动到bboss官网下载这两个资源包并放入特定的目录下：[url=http://www.bbossgroups.com/tool/download.htm?fileName=dbinit-system.zip]dbinit-system.zip[/url]，[url=http://www.bbossgroups.com/tool/download.htm?fileName=bboss.war]bboss.war[/url]，这样就可以把配置文件中的db_init_tool和war这两个属性配置对应的目录即可
如果db_init_tool和war两个属性配置为官网地址或者hudson持续集成服务器地址，则在执行过程中自动下载这两个资源包，然后继续生成eclipse工程。
[size=xx-large][b]六、工程环境设置[/b][/size]
[size=large][b]1.eclipse工程编码必须设置为utf-8[/b][/size]
[img]http://dl2.iteye.com/upload/attachment/0114/1725/92fd8d90-8b31-32d1-910b-adcee80c489d.gif[/img]
[size=large][b]2.eclipse工程builder设置[/b][/size]
[img]http://dl2.iteye.com/upload/attachment/0114/1727/18e062bd-1d10-3255-ba9f-0f4da694c613.gif[/img]
[size=large][b]3.eclipse工程jdk版本设置[/b][/size]
[img]http://dl2.iteye.com/upload/attachment/0114/1729/85a18e6c-c724-3e51-8d38-0e2eb55cc3e3.gif[/img]
[size=large][b]4.eclipse tomcat插件设置[/b][/size]
eclipse tomcat plugin下载地址：[url=http://www.eclipsetotale.com/tomcatPlugin.html]下载[/url] 下载完毕解压到eclipse\dropins目录下即可
[img]http://dl2.iteye.com/upload/attachment/0114/1731/ef1eb5d0-6aef-3f5e-ad1d-3b32fdc17a16.gif[/img]
[img]http://dl2.iteye.com/upload/attachment/0114/1735/1d38d660-e9e6-3f37-9841-44d6c81474d5.gif[/img]
tomcat jdk版本设置必须和工程jdk版本一致：
[img]http://dl2.iteye.com/upload/attachment/0114/1733/6182b2d4-0adf-3192-96ec-90b392d77679.gif[/img]
[size=large][b]5.禁用eclipse validation机制[/b][/size]
禁用eclipse validation机制，提升eclipse开发效率，避免不必要的校验操作
[img]http://dl2.iteye.com/upload/attachment/0114/1737/0693d491-3ae1-3e55-8b8f-879b37dabeba.gif[/img]
类似资料：