本文介绍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代码
<init-param>
<param-name>iocLifeCycleEventListenerParams</param-name>
<!-- 指定sqlite数据库文件路径参数sqlitepath和源代码存放目录路径参数sourcepath
sourcepath:如果没有设置sourcepath参数,那么需要在代码配置界面上或者代码生成组件上指定源码存放路径
-->
<param-value>sqlitepath=d:/gencodedb|sourcepath=d:/sourcecode</param-value>
</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对象属性注释,如果不填写字段注释或者表字段没有注释,采用字段中文名称作为注释
字段列表中除了可以配置字段外,可以调整字段的顺序,只要鼠标拖拉字段到对应的位置就可以进行排序。
配置完毕后点击暂存和生成代码即可,代码生成好后立马可以查看部署说明、下载代码、在线浏览源码。
代码配置历史记录管理
在线浏览代码