Mybatis中使用mybatis-generator结合Ant脚本快速自动生成Model、Mapper等文件

2025-04-17 技术教程

使用过Mybatis的同学都知道，针对每一个项目中使用到的数据库表都需要建立其对应的数据库增删改查xxxMapper.xml文件、实体类xxx.java文件以及其他类用来调用进行数据库操作的xxxMapper.java文件。在开始学习Mybatis时，我相信不少人都是通过手动来建立这些文件的。毫无疑问，如果项目比较大的话还通过手动建立这些文件效率是非常低的，这时我们可以通过mybatis-generator来自动生成这些文件。但是，这个工具默认是以命令行的形式来生成相关文件的，因此我们可以通过写一个Ant脚本，每次需要建立这些文件时在eclipse中执行一下这个Ant脚本就可以自动生成了。完整步骤如下：

一导入相关jar包

要想使用“mybatis-generator”需要在web项目的lib中导入对应的一个mybatis-generator-1.3.x.jar文件，Github上的下载地址：mybatis-generator的jar包下载

二配置mybatis-generator的配置文件

（1）首先在项目中新建几个包用于存放对应的文件：

由上图可以看出，src/main/java用于存放Java源代码；src/main/env/dev用于存放开发环境下的配置文件（如：jdbc，缓存，日志等）；src/main/resources用于存放通用的一些配置文件，在这里我们自动生成的Mapper.xml文件就存放在这个路径下；src/test/java表示测试代码，这里不管

注：如何在eclipse中添加这些源文件夹？

（2）在项目根目录下新建generatorConfig.xml和build_mybatis.xml：

这两个文件分别是“mybatis-generator”的配置文件和自动化的Ant脚本，在项目中的路径如下：

i）generatorConfig.xml：

<?xmlversion="1.0"encoding="UTF-8"?><!DOCTYPEgeneratorConfigurationPUBLIC"-//mybatis.org//DTDMyBatisGeneratorConfiguration1.0//EN""http://mybatis.org/dtd/mybatis-generator-config_1_0.dtd"><generatorConfiguration><classPathEntrylocation="WebContent/WEB-INF/lib/mysql-connector-java-5.1.26-bin.jar"/><contextid="DB2Tables"targetRuntime="MyBatis3"><commentGenerator><propertyname="suppressAllComments"value="true"/><propertyname="suppressDate"value="true"/></commentGenerator><jdbcConnectiondriverClass="com.mysql.jdbc.Driver"connectionURL="jdbc:mysql://127.0.0.1:3306/ehcache_db"userId="root"password="root"></jdbcConnection><javaTypeResolver><propertyname="forceBigDecimals"value="false"/></javaTypeResolver><javaModelGeneratortargetPackage="cn.zifangsky.model"targetProject="src/main/java"><propertyname="enableSubPackages"value="false"/><propertyname="trimStrings"value="true"/></javaModelGenerator><sqlMapGeneratortargetPackage="sqlmaps"targetProject="src/main/resources"><propertyname="enableSubPackages"value="false"/></sqlMapGenerator><javaClientGeneratortype="XMLMAPPER"targetPackage="cn.zifangsky.mapper"targetProject="src/main/java"><propertyname="enableSubPackages"value="false"/></javaClientGenerator><tabletableName="user"domainObjectName="User"enableCountByExample="false"enableUpdateByExample="false"enableDeleteByExample="false"enableSelectByExample="false"selectByExampleQueryId="false"></table></context></generatorConfiguration>

注：需要修改的一些地方可以参照我上面的注释进行修改，同时别忘了数据驱动的jar包

ii）build_mybatis.xml：

<projectdefault="genfiles"basedir="."><propertyname="generated.source.dir"value="${basedir}"/><pathid="ant.run.lib.path"><pathelementlocation="${basedir}/WebContent/WEB-INF/lib/mybatis-generator-core-1.3.2.jar"/></path><targetname="genfiles"description="Generatethefiles"><taskdefname="mbgenerator"classname="org.mybatis.generator.ant.GeneratorAntTask"classpathref="ant.run.lib.path"/><mbgeneratoroverwrite="true"configfile="generatorConfig.xml"verbose="false"><propertyset><propertyrefname="generated.source.dir"/></propertyset></mbgenerator></target></project>

上面的代码就两个地方需要注意：一是“mybatis-generator”的jar包，二是需要对应的“generatorConfig.xml”文件

注：如果对Ant脚本不太熟悉的话，可以参考下我写的这篇文章：http://www.zifangsky.cn/444.html

三测试

进行效果测试时，只需要把“build_mybatis.xml”这个文件拖到Ant视图中，然后点击执行这个脚本就可以自动生成我们需要的文件了，最后就是刷新一下项目结构就可以看到文件了，效果如下：

注：我测试使用到的数据库数据：

SETFOREIGN_KEY_CHECKS=0;--------------------------------Tablestructureforuser------------------------------DROPTABLEIFEXISTS`user`;CREATETABLE`user`(`id`int(11)NOTNULLAUTO_INCREMENT,`name`varchar(32)DEFAULTNULL,`password`varchar(64)DEFAULTNULL,`email`varchar(64)DEFAULTNULL,`birthday`dateDEFAULTNULL,PRIMARYKEY(`id`))ENGINE=InnoDBAUTO_INCREMENT=4DEFAULTCHARSET=utf8;--------------------------------Recordsofuser------------------------------INSERTINTO`user`VALUES('1','admin','123456','admin@qq.com','2000-01-02');INSERTINTO`user`VALUES('2','test','1234','test@zifangsky.cn','1990-12-12');INSERTINTO`user`VALUES('3','xxxx','xx','xx@zifangsky.cn','1723-06-21');