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官网下载安装包:下载 
下安装包后直接解压,解压后的目录结构为: 

bboss自动代码生成工具使用指南_第1张图片 

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

bboss自动代码生成工具使用指南_第2张图片 

如果需要修改代码的存放目录(默认为运行目录下的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 

bboss自动代码生成工具使用指南_第3张图片 

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

bboss自动代码生成工具使用指南_第4张图片 

以上都是在内置的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(代码存放路径)两个参数,根据自己本机的路径修改即可。 

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

bboss自动代码生成工具使用指南_第5张图片 
点击新增DS即可,然修改相关属性(注意数据源名称不能重复,不能使用gencode这个内置数据源名称)。 

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

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

 
选择表 

bboss自动代码生成工具使用指南_第6张图片 
然后点击进入表单配置,即可 
如果需要重新加载数据源中的表结构,可以点击刷新表结构 

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

bboss自动代码生成工具使用指南_第7张图片 
在表单配置界面可以配置三部分内容: 

bboss自动代码生成工具使用指南_第8张图片 

基本信息配置 

模块名称 指定模块英文名称 
模块中文名称 指定模块中文名称 
包路径 指定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对象属性注释,如果不填写字段注释或者表字段没有注释,采用字段中文名称作为注释 

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

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

bboss自动代码生成工具使用指南_第9张图片 

代码配置历史记录管理 

bboss自动代码生成工具使用指南_第10张图片 

在线浏览代码 

bboss自动代码生成工具使用指南_第11张图片 

bboss自动代码生成工具使用指南_第12张图片 

bboss自动代码生成工具使用指南_第13张图片 


你可能感兴趣的:(bboss,代码生成工具,gencode)