在使用 mybatis 过程中,当手写 JavaBean和XML 写的越来越多的时候,就越来越容意出错。这种重复性的工作,我们当然不希望做那么多。
还好, mybatis 为我们提供了强大的代码生成--MybatisGenerator。
通过简单的配置,我们就可以生成各种类型的实体类,Mapper接口,MapperXML文件,Example对象等。通过这些生成的文件, 我们就可以方便的进行单表进行增删改查的操作。
以下的工具使用的都是 IDEA
创建Maven项目
菜单上选择新建项目
File | New | Project
选择左侧的Maven
由于我们只是创建一个普通的项目, 此处点击Next即可。
输入groupId和artifactid
在我的项目中:
GroupId 填 com.homejim.mybatis
ArtifactId 填 mybatis-generator
点击 Next。Finish。
通过以上步骤, 一个普通的Maven项目就创建好了。
配置generator.xml
需要改一些内容:
本地数据库驱动程序jar包的全路径(必须要改)。
数据库的相关配置(必须要改)
相关表的配置(必须要改)
实体类生成存放的位置。
MapperXML 生成文件存放的位置。
Mapper 接口存放的位置。
如果不知道怎么改, 请看后面的配置详解。
配置pom.xml
在原基础上添加一些内容。
4.0.0
com.homejim.mybatis
mybatis-generator
1.0-SNAPSHOT
mybatis-generator
org.mybatis.generator
mybatis-generator-maven-plugin
1.3.7
src/main/resources/generator.xml
true
true
Generate MyBatis Artifacts
generate
org.mybatis.generator
mybatis-generator-core
1.3.7
需要注意的是 configurationFile 中的文件指的是 generator.xml。因此路径写的是该文件的相对路径, 名称也跟该文件相同。到此, mybatis-generator 就可以使用啦。
使用及测试
打开Maven Projects 视图
在 IDEA 上, 打开:View | Tools | Windwos | Maven Projects
Projects 中双击 mybatis-generator
在右侧此时可以看到 Maven Projects 了。找到 mybatis-generator 插件。
mybatis-generator | Plugins | mybatis-generator | mybatis-generator
双击运行
运行正确后, 生成代码, 得到如下的结构
仅仅是上面那么简单的使用还不够爽。那么我们就可以通过更改 generator.xml 配置文件的方式进行生成的配置。
文档
推荐查看官方的文档。
英文不错的:MyBatis Generator Core – MyBatis Generator XML Configuration File Reference
中文翻译版:http://mbg.cndocs.ml/index.html
官网没有的property标签
该标签在官网中只是说用来指定元素的属性, 至于怎么用没有详细的讲解。
分隔符相关
以上的配置对应的是 mysql, 当数据库中的字段和数据库的关键字一样时, 就会使用分隔符。
比如我们的数据列是 delete, 按以上的配置后, 在它出现的地方, 就变成`delete`。
编码
默认是使用当前的系统环境的编码, 可以配置为 GBK 或 UTF-8。
我想项目为 UTF-8, 如果指定生成 GBK, 则自动生成的中文就是乱码。
格式化
这些显然都是可以自定义实现的的。
plugins标签
plugins 标签用来扩展或修改代码生成器生成的代码。
在生成的 XML 中, 是没有
比如你想生成的 JavaBean 中自行实现 Serializable 接口。
还能自定义插件。
这些插件都蛮有用的, 感觉后续可以专门开一篇文章来讲解。看名称, 就知道是用来生成注释用的。
默认配置:
suppressAllComments: 阻止生成注释, 默认值是false。
suppressDate: 阻止生成的注释包含时间戳, 默认为false。
addRemarkComments: 注释中添加数据库的注释, 默认为 false。
还有一个就是我们可以通过 type 属性指定我们自定义的注解实现类, 生成我们自⼰想要的注解 。自定义的实现类需要 实现 org.mybatis.generator.api.CommentGenerator。
源码
https://github.com/homejim/mybatis-cn