bboss自动代码生成工具使用指南

本文介绍bboss自动代码生成工具使用方法 

工具在线试用： 
http://gencode.bbossgroups.com 

在介绍之前首先了解一下bboss自动代码生成工具能帮助我们做哪些事情。 
通过自动代码生成框架，根据模板可以自动生成数据库表的增、删、改、分页查询、列表查询、国际化功能对应的java、jsp程序和配置文件，包括： 
1.mvc控制器 
2.业务组件 
3.PO实体类 
4.jsp文件 可以定制不同风格的界面模板，目前提供了一套bboss平台的基础ui风格和一套bboss普通ui风格模板 
5.cxf webservice服务类文件 
6.hessian服务类文件 
7.sql配置文件 
8.ioc/mvc组件装配部署和服务发布配置文件. 
9.国际化属性文件和国际化配置 
10.代码和配置文件集成配置部署readme说明文件 

更多的介绍参考文档： 

http://www.iteye.com/news/31078-bboss-gencode 

下面介绍具体用法。 

第一步 下载安装 
可以从bboss官网下载安装包：下载 
下安装包后直接解压，解压后的目录结构为： 

 

运行解压目录下的startup.bat（linux下执行startup.sh） 
然后在chrome或者火狐浏览器下访问地址： 
http://localhost/gencode 
即可，默认端口为80，如果需要修改端口，可以修改解压目录下的config.properties文件： 
port=80 
config.properties内容如下： 

 

如果需要修改代码的存放目录（默认为运行目录下的sourcecode目录），就打开配置属性sourcepath并修改： 
#sourcepath=d:/sourcecode 

如果需要修改存放表单配置的sqlite数据库的路径（不设置的话默认为运行目录），就打开配置属性sqlitepath并修改： 
#sqlitepath=d:/gencodedb 

默认情况下不需要做任何配置即可运行自动代码生成工具。 
也可以从github下载源码构建安装： 
https://github.com/bbossgroups/bboss-gencode 
svn源码下载地址： 
https://github.com/bbossgroups/bboss-gencode/trunk 
源码下载完毕，采用ant进行构建： 
1.安装ant构建环境和jdk 1.7及以上版本 
2.运行工程根目录下的build.bat指令 
3.构建成功后： 
windows环境下运行distrib/run/startup.bat 
linux/unix/mac os环境下运行distrib/run/startup.sh 

 

即可启动自动代码生成框架应用，在浏览器端（支持谷歌或者火狐浏览器）访问以下地址，可以在界面中配置数据源，配置表单，生成源代码并打包下载生成的源码文件，浏览源码部署集成说明： 
http://localhost/gencode   
如果看到以下界面说明安装成功： 

 

以上都是在内置的jetty容器中运行自动代码生成工具，如果需要在tomcat等容器中运行，则需要将构建生成的gencode.war包部署到tomcat中即可，但是需要修改war包中文件WEB-INF/web.xml的相关内容： 

Xml代码  

1. <init-param>  

2.             <param-name>iocLifeCycleEventListenerParams</param-name>  

3.             <!-- 指定sqlite数据库文件路径参数sqlitepath和源代码存放目录路径参数sourcepath  

4.             sourcepath：如果没有设置sourcepath参数，那么需要在代码配置界面上或者代码生成组件上指定源码存放路径  

5.              -->  

6.             <param-value>sqlitepath=d:/gencodedb|sourcepath=d:/sourcecode</param-value>  

7.         </init-param>  

参数iocLifeCycleEventListenerParams中维护了sqlitepath（sqlite数据库文件路径）和sourcepath（代码存放路径）两个参数，根据自己本机的路径修改即可。 

第二步 添加数据源 
为了能够对数据库中的表生成代码，需要配置相应的数据源,参考下图： 

 
点击新增DS即可，然修改相关属性（注意数据源名称不能重复，不能使用gencode这个内置数据源名称）。 

同时也可以修改和删除已有数据源。 

第三步 选择数据库表并生成代码 
选择数据源： 

 
选择表 

 
然后点击进入表单配置，即可 
如果需要重新加载数据源中的表结构，可以点击刷新表结构 

第四步 配置表单 
选择好表并进入表单界面： 

 
在表单配置界面可以配置三部分内容： 

 

基本信息配置 

模块名称 指定模块英文名称 
模块中文名称 指定模块中文名称 
包路径 指定java程序存放的包路径 
jsp相对路径 指定jsp文件存放的相对路径 
系统名称  指定模块对应的系统名称，一般不需要指定 
界面风格  default|common 指定ui风格模块，default针对bboss平台，common针对bboss框架 
代码控制参数 控制生成的代码范围，取值范围（可以根据需要进行选择配置）： 
geni18n 选中则生成国际化配置功能 
clearSourcedir 生成代码时清除之前的文件 
genRPC  生成webservice和hessian服务 
autopk  自动生成主键 默认采用UUID生成主键，也可以结合tableinfo表中表主键生成 
print  自定生成打印功能（暂未实现） 
genwf  自动生成工作流功能（暂未实现） 

excel版本号 设置excel导出功能，暂未实现 
唯一标识字段  指定表的唯一标识字段 
主键SEQ名称  tableinfo表中主键配置信息（正对bboss平台） 

版权信息配置 
作者 
公司 
版本号 
字段信息配置 
字段信息配置可以指定每个字段的配置： 
java类型 
中文名称 
日期格式 
数字格式 
查询条件 
查询方式 
日期范围查询 
排序字段 
排序方式 
列表字段  控制字段在列表中显示、隐藏（作为隐藏域）、忽略（不在列表页面出现，也不隐藏） 
编辑控制： 控制字段在编辑页面显示、隐藏、忽略、只读、可编辑、必填 
添加控制： 控制字段在编辑页面显示、隐藏、忽略、只读、可编辑、必填 
查看控制： 控制字段在编辑页面显示、隐藏、忽略 
默认值 
类型校验 
显示长度 根据指定长度在列表页面对字段值进行截取 
替换串 根据指定长度在列表页面对字段值进行截取，截取部分用替换串进行替换 
字段注释：维护PO对象属性注释，默认采用表字段注释作为PO对象属性注释，如果不填写字段注释或者表字段没有注释，采用字段中文名称作为注释 

字段列表中除了可以配置字段外，可以调整字段的顺序，只要鼠标拖拉字段到对应的位置就可以进行排序。 

配置完毕后点击暂存和生成代码即可,代码生成好后立马可以查看部署说明、下载代码、在线浏览源码。 

 

代码配置历史记录管理 

 

在线浏览代码