bboss 4.10.7及更低版本ant构建方法

本文适用bboss 4.10.7及更低版本，4.10.8及后续版本构建请参考文档：采用gradle构建和发布bboss方法介绍
基于bboss开发项目说明
要做简单的demo，请参考文档
http://yin-bp.iteye.com/blog/1026261

正儿八经的做项目，参考文档搭bboss平台开发环境：
http://yin-bp.iteye.com/blog/2230399

bboss自动代码生成工具使用指南：
http://yin-bp.iteye.com/blog/2256948
    
如需使用bboss中某个模块，那么这个地方可以找到各模块最小依赖eclipse工程，你可以直接在此基础上开启bboss框架开发之旅：
bboss最佳实践案例

本文适用于bboss 4.10.6及后续版本
bboss 版本ant构建方法介绍

一、bboss各个模块目前采用ant进行构建，构建步骤如下：
1.安装好jdk（1.7都可以）,并将jdk设置到环境变量中
2.建立根目录，例如：d:/bbossgroups
3.在执行后续所有步骤之前，必须先下载buildtool项目：buildtool-master.zip

将下载的压缩包buildtool-master.zip包含的antbuildall和apache-ant-1.7.1拷贝解压到目录：
d:/bbossgroups/buildtool
解压后，d:/bbossgroups/buildtool目录内容如下：

buildtool中包含了所有bbossgroups中项目的ant构建指令和ant运行环境。

4.构建
我们可以一次性构建所有bbossgroups中的模块，亦可以单独构建每一个模块，下面分别介绍：
4.1 一次性全部构建所有bbossgroups中的模块

需要下载bbossgroups中的以下项目：
bboss
bigdatas
security
bboss-rpc
bboss-plugins
bboss-gencode
bboss-bestpractice
bboss-genproject
bboss-bboss-site
下载完毕后分别解压，并按照以下目录结构存储：



然后执行指令：d:/bbossgroups/buildtool/antbuildall/build-all-jdk7.bat
执行完毕后，所有构建出来jar包被放置在d:/bbossgroups/distrib目录下，检查里面的内容包含以下包，说明构建成功：
bboss-core.jar
bboss-security.jar
bboss-security-web.jar
bboss-rpc.jar
bboss-event.jar
bboss-jodconverter-core.jar
bboss-mvc.jar
bboss-soa.jar
bboss-schedule.jar
bboss-velocity.jar
bboss-wordpdf.jar
bboss-hessian.jar
ditchnet-tabs-taglib.jar
frameworkset.jar
frameworkset-pool.jar
frameworkset-util.jar
jgroups.jar


构建完毕后会同步更新其他模块下引用的包为最新版本。关于这些文件的详细说明请参考文章《bboss框架发布的jar包和依赖jar包概览》

4.2 单独构建每一个模块

单独构建某个模块，只需要参考4.1中章节中列出的下载地址，下载对应的模块并解压到d:/bbossgroups/目录下即可，独立模块构建说明如下。

4.2.1 bboss核心模块构建

bboss核心模块最新版本下载地址：bboss
将源码包解压到目录：d:/bbossgroups/bboss
bboss目录内容如下：


此时可以按以下顺序执行buildtool/antbuildall目录下与核心模块相关的指令，单独构建每个子模块：
build-bboss-velocity.bat
build-bboss-util.bat
build-bboss-soa.bat
build-bboss-core-only.bat
build-bboss-persistent-jdk7.bat
build-bboss-mvc-only-noresources.bat
build-bboss-taglib.bat
build-bboss-event-only.bat
build-bboss-hessian.bat
build-bboss-schedule.bat

发布的jar包含在每个子工程目录的distrib目录中，例如：
d:\bbossgroups\bboss\bboss-core\distrib
构建完毕后会同步更新其他模块下引用的包为最新版本。

4.2.2 bboss会话共享模块构建

bboss会话共享模块最新版本下载地址：security
将源码包解压到目录：d:/bbossgroups/security
security目录内容如下：


此时可以按以下顺序执行buildtool/antbuildall目录下与会话共享模块相关的指令，单独构建每个子模块：
build-bboss-security.bat
build-bboss-security-web.bat

发布的jar包含在每个子工程目录的distrib目录中，例如：
d:\bbossgroups\security\bboss-security\distrib
构建完毕后会同步更新其他模块下引用的包为最新版本。

4.2.3 bboss bigdatas大数据抽取工具构建

bboss bigdatas大数据抽取工具最新版本下载地址：bigdatas
将源码包解压到目录：d:/bbossgroups/bigdatas
bigdatas目录内容如下：



此时可以按以下顺序执行buildtool/antbuildall目录下与大数据抽取工具构建指令：
build-bboss-bigdata.bat

发布的jar包含在每个子工程目录的distrib目录中，例如：
d:\bbossgroups\bigdatas\bigdata\distrib
构建完毕后会同步更新其他模块下引用的包为最新版本。

4.2.4 bboss rpc模块构建

bboss rpc模块最新版本下载地址：bboss-rpc
将源码包解压到目录：d:/bbossgroups/bboss-rpc
bboss-rpc目录内容如下：




此时可以执行buildtool/antbuildall目录下与RPC模块构建指令：
build-bboss-rpc-only.bat

发布的jar包含在每个子工程目录的distrib目录中，例如：
d:\bbossgroups\bboss-rpc\distrib
构建完毕后会同步更新其他模块下引用的包为最新版本。

4.2.5 bboss plugins模块构建

bboss plugins模块最新版本下载地址：bboss-plugins
将源码包解压到目录：d:/bbossgroups/bboss-plugins
bboss-plugins目录内容如下：




此时可以按以下顺序执行buildtool/antbuildall目录下与word插件模块相关的指令，单独构建每个子模块：
build-bboss-jodconverter-core.bat
build-bboss-wordpdf.bat

发布的jar包含在每个子工程目录的distrib目录中，例如：
d:\bbossgroups\bboss-plugins\bboss-jodconverter-core\distrib
构建完毕后会同步更新其他模块下引用的包为最新版本。

4.2.6 bboss site（bboss官方网站）构建

bboss site模块最新版本下载地址：bboss-site
将源码包解压到目录：d:/bbossgroups/bboss-site
bboss-site目录内容如下：




此时可以执行buildtool/antbuildall目录下与bboss官方网站构建指令：
build-bboss-site.bat

发布的jar和war包含在工程目录的distrib目录中，例如：
d:\bbossgroups\bboss-site\distrib

4.2.7 bboss gencode自动代码生成工具构建

bboss gencode模块最新版本下载地址：bboss-gencode
将源码包解压到目录：d:/bbossgroups/bboss-gencode
bboss-gencode目录内容如下：



此时可以执行d:/bbossgroups/bboss-gencode目录下与自动代码生成工具构建指令：
build.bat

发布的jar和war包含在工程目录的distrib目录中，例如：
d:\bbossgroups\bboss-gencode\distrib

4.2.8 bboss genproject（bboss平台开发环境搭建工具）构建

bboss genproject模块最新版本下载地址：genproject
将源码包解压到目录：d:/bbossgroups/genproject
genproject目录内容如下：



此时可以执行d:/bbossgroups/genproject目录下与生成平台开发工程工具构建指令：
build.bat

发布的jar和war包含在工程目录的distrib目录中，例如：
d:\bbossgroups\genproject\distrib

bboss独立模块（子模块）目录功能说明及单独ant构建（不更新依赖工程引用包）方法请参考文档：bboss工程目录结构及功能说明



二、平台bboss框架版本升级指南
两种升级方法：
一种从github上下载最新发布版本升级
最新版本下载地址：https://github.com/bbossgroups/bboss/releases，直接下载其中的bboss-vX.XX.X.zip压缩包并解压，然后安装以下步骤升级

1.拷贝lib目录下jar文件到应用的WebRoot/WEB-INF/lib目录替换原来的文件
2.如果是平台项目则将【tld for bboss平台】目录下的pager-taglib.tld文件拷贝到应用的WebRoot/WEB-INF/下，替换原来的文件
3.如果是非平台项目则将【tld for bboss】目录下的pager-taglib.tld文件拷贝到应用的WebRoot/WEB-INF/下，替换原来的文件

一种方法是将构建生成的下述jar包拷贝到平台的WebRoot/WEB-INF/lib目录下替换原来的jar包：
bboss-core.jar
bboss-security.jar
bboss-security-web.jar
bboss-rpc.jar
bboss-event.jar
bboss-jodconverter-core.jar
bboss-mvc.jar
bboss-soa.jar
bboss-schedule.jar
bboss-velocity.jar
bboss-wordpdf.jar
bboss-hessian.jar
ditchnet-tabs-taglib.jar
frameworkset.jar
frameworkset-pool.jar
frameworkset-util.jar
jgroups.jar

评论

4 楼 yin_bp 2014-09-27  

lifengping12345 写道

大神，学习搭建一下你的项目，在一家新公司上班，用的就是您写的框架.   。

有啥问题随时交流，博客文章bboss项目下载地址的后面有bboss交流群号：

github上的最佳实践工程：
https://github.com/bbossgroups/bbossgroups-3.5/tree/master/bestpractice
其中的demoproject是比较完整的bboss demo项目，可以参考一下。

bestpractice目录下eclipse工程说明：
demoproject ----bboss持久层，标签库，mvc，ioc最完整的web eclipse工程，实践项目可以参考这个项目搭建bboss的开发环境
bboss-clientproxy ----bboss rpc框架demo eclipse工程 
bbossupload ----bboss mvc文件上传下载web demo eclipse工程
easyuidatagrid----bboss整合easy ui datagrid的webdemo eclipse工程
i18n --bboss国际化最小依赖的web demo eclipse工程
mvc ----bboss mvc最小依赖web demo eclipse工程
persistent ---bboss持久层最小依赖eclipse工程
session --bboss会话共享最小依赖web demo eclipse工程
sessionmonitor ---bboss会话共享带监控管理最小依赖webdemo工程
xmlrequest ----bboss mvc xml请求响应最小依赖web demo eclipse 工程
xmlserializable ---bboss 序列化demo eclipse工程

3 楼 lifengping12345 2014-09-26  

大神，学习搭建一下你的项目，在一家新公司上班，用的就是您写的框架.   。

2 楼 yin_bp 2012-10-18  

sky_cn 写道

在公司下了几次都没成功感觉太大了点，楼主为什么不用mvn构建项目么，那样就不会有296mb那么庞大了

由于工程一直采用ant构建，所有的依赖库都在相关的eclipse工程里面了，确实有点大，从soureceforge和github下载都有点慢，你可以在官网下载试试，参考文档（里面有官网下载地址）：
《bbossgroups 项目下载地址》

1 楼 sky_cn 2012-10-18  

在公司下了几次都没成功感觉太大了点，楼主为什么不用mvn构建项目么，那样就不会有296mb那么庞大了