1、mybatis-generator 概述
MyBatis官方提供了逆向工程 mybatis-generator,可以針對數據庫表自動生成MyBatis執行所需要的代碼(如Mapper.java、Mapper.xml、POJO)。
mybatis-generator 有三種用法:命令行、eclipse插件、maven插件。而maven插件的方式比較通用,本文也將概述maven插件的使用方式。
2、pom.xml中配置plugin
<build>
<plugins>
<!-- mybatis-generator -->
<plugin>
<groupId>org.mybatis.generator</groupId>
<artifactId>mybatis-generator-maven-plugin</artifactId>
<version>1.3.2</version>
<configuration>
<!-- mybatis-generator的配置文件,根據情況調整位置 -->
<configurationFile>src/main/resources/generatorConfig.xml</configurationFile>
<verbose>true</verbose>
<overwrite>true</overwrite>
</configuration>
<executions>
<execution>
<id>Generate MyBatis Artifacts</id>
<goals>
<goal>generate</goal>
</goals>
</execution>
</executions>
<dependencies>
<dependency>
<groupId>org.mybatis.generator</groupId>
<artifactId>mybatis-generator-core</artifactId>
<version>1.3.2</version>
</dependency>
</dependencies>
</plugin>
</plugins>
</build>
31
1
<build>
2
<plugins>
3
<!-- mybatis-generator -->
4
<plugin>
5
<groupId>org.mybatis.generator</groupId>
6
<artifactId>mybatis-generator-maven-plugin</artifactId>
7
<version>1.3.2</version>
8
<configuration>
9
<!-- mybatis-generator的配置文件,根據情況調整位置 -->
10
<configurationFile>src/main/resources/generatorConfig.xml</configurationFile>
11
<verbose>true</verbose>
12
<overwrite>true</overwrite>
13
</configuration>
14
<executions>
15
<execution>
16
<id>Generate MyBatis Artifacts</id>
17
<goals>
18
<goal>generate</goal>
19
</goals>
20
</execution>
21
</executions>
22
<dependencies>
23
<dependency>
24
<groupId>org.mybatis.generator</groupId>
25
<artifactId>mybatis-generator-core</artifactId>
26
<version>1.3.2</version>
27
</dependency>
28
</dependencies>
29
</plugin>
30
</plugins>
31
</build>
3、generatorConfig.xml配置文件
稍微詳細一點如下:
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE generatorConfiguration
PUBLIC "-//mybatis.org//DTD MyBatis Generator Configuration 1.0//EN"
"http://mybatis.org/dtd/mybatis-generator-config_1_0.dtd">
<generatorConfiguration>
<!--JDBC驅動jar包的位置-->
<classPathEntry location="C:/workspace/project/learning/mybatis/lib/mysql-connector-java-5.1.6.jar"/>
<context id="default" targetRuntime="MyBatis3">
<!--創建Java類時是否取消生成注釋-->
<commentGenerator>
<property name="suppressDate" value="true"/>
<property name="suppressAllComments" value="true"/>
</commentGenerator>
<!--JDBC數據庫連接-->
<jdbcConnection driverClass="com.mysql.jdbc.Driver"
connectionURL="jdbc:mysql://localhost:3306/test"
userId="root"
password="dev">
</jdbcConnection>
<!--
Model模型生成器,用來生成含有主鍵key的類,記錄類 以及查詢Example類
targetPackage 指定生成的model生成所在的包名
targetProject 指定在該項目下所在的路徑
-->
<javaModelGenerator targetPackage="dulk.learn.mybatis.generator.pojo"
targetProject="./src/main/java">
<!-- 是否允許子包,即targetPackage.schemaName.tableName -->
<property name="enableSubPackages" value="false"/>
<!-- 是否對model添加構造函數 -->
<property name="constructorBased" value="true"/>
<!-- 是否對類CHAR類型的列的數據進行trim操作 -->
<property name="trimStrings" value="true"/>
<!-- 建立的Model對象是否 不可改變 即生成的Model對象不會有 setter方法,只有構造方法 -->
<property name="immutable" value="false"/>
</javaModelGenerator>
<!--
mapper映射文件生成所在的目錄 為每一個數據庫的表生成對應的SqlMap文件
-->
<sqlMapGenerator targetPackage="generator"
targetProject="./src/main/resources">
<property name="enableSubPackages" value="false"/>
</sqlMapGenerator>
<!--
客戶端代碼,生成易於使用的針對Model對象和XML配置文件的代碼
type="ANNOTATEDMAPPER",生成Java Model和基於注解的Mapper對象
type="MIXEDMAPPER",生成基於注解的Java Model和相應的Mapper對象
type="XMLMAPPER",生成SQLMap XML文件和獨立的Mapper接口
-->
<javaClientGenerator type="XMLMAPPER"
targetPackage="dulk.learn.mybatis.generator.mapper"
targetProject="./src/main/java">
<property name="enableSubPackages" value="false"/>
</javaClientGenerator>
<!--tables-->
<table tableName="author" domainObjectName="Author"
enableCountByExample="false" enableUpdateByExample="false"
enableDeleteByExample="false" enableSelectByExample="false"
selectByExampleQueryId="false">
</table>
<table tableName="book" domainObjectName="Book"
enableCountByExample="false" enableUpdateByExample="false"
enableDeleteByExample="false" enableSelectByExample="false"
selectByExampleQueryId="false">
</table>
</context>
</generatorConfiguration>
x
1
2
3
4
5
6
<generatorConfiguration>
7
8
<!--JDBC驅動jar包的位置-->
9
<classPathEntry location="C:/workspace/project/learning/mybatis/lib/mysql-connector-java-5.1.6.jar"/>
10
11
<context id="default" targetRuntime="MyBatis3">
12
13
<!--創建Java類時是否取消生成注釋-->
14
<commentGenerator>
15
<property name="suppressDate" value="true"/>
16
<property name="suppressAllComments" value="true"/>
17
</commentGenerator>
18
19
<!--JDBC數據庫連接-->
20
<jdbcConnection driverClass="com.mysql.jdbc.Driver"
21
connectionURL="jdbc:mysql://localhost:3306/test"
22
userId="root"
23
password="dev">
24
</jdbcConnection>
25
26
<!--
27
Model模型生成器,用來生成含有主鍵key的類,記錄類 以及查詢Example類
28
targetPackage 指定生成的model生成所在的包名
29
targetProject 指定在該項目下所在的路徑
30
-->
31
<javaModelGenerator targetPackage="dulk.learn.mybatis.generator.pojo"
32
targetProject="./src/main/java">
33
<!-- 是否允許子包,即targetPackage.schemaName.tableName -->
34
<property name="enableSubPackages" value="false"/>
35
<!-- 是否對model添加構造函數 -->
36
<property name="constructorBased" value="true"/>
37
<!-- 是否對類CHAR類型的列的數據進行trim操作 -->
38
<property name="trimStrings" value="true"/>
39
<!-- 建立的Model對象是否 不可改變 即生成的Model對象不會有 setter方法,只有構造方法 -->
40
<property name="immutable" value="false"/>
41
</javaModelGenerator>
42
43
<!--
44
mapper映射文件生成所在的目錄 為每一個數據庫的表生成對應的SqlMap文件
45
-->
46
<sqlMapGenerator targetPackage="generator"
47
targetProject="./src/main/resources">
48
<property name="enableSubPackages" value="false"/>
49
</sqlMapGenerator>
50
51
<!--
52
客戶端代碼,生成易於使用的針對Model對象和XML配置文件的代碼
53
type="ANNOTATEDMAPPER",生成Java Model和基於注解的Mapper對象
54
type="MIXEDMAPPER",生成基於注解的Java Model和相應的Mapper對象
55
type="XMLMAPPER",生成SQLMap XML文件和獨立的Mapper接口
56
-->
57
<javaClientGenerator type="XMLMAPPER"
58
targetPackage="dulk.learn.mybatis.generator.mapper"
59
targetProject="./src/main/java">
60
<property name="enableSubPackages" value="false"/>
61
</javaClientGenerator>
62
63
64
<!--tables-->
65
<table tableName="author" domainObjectName="Author"
66
enableCountByExample="false" enableUpdateByExample="false"
67
enableDeleteByExample="false" enableSelectByExample="false"
68
selectByExampleQueryId="false">
69
</table>
70
<table tableName="book" domainObjectName="Book"
71
enableCountByExample="false" enableUpdateByExample="false"
72
enableDeleteByExample="false" enableSelectByExample="false"
73
selectByExampleQueryId="false">
74
</table>
75
76
</context>
77
</generatorConfiguration>
有些默認配置不必顯性去配置,所以簡化一下快速配置的話也可以這樣:
(注意:配置中文件的生成地址等根據個人實際情況進行調整,另外,若有其他配置想要調整請參考官方文檔)
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE generatorConfiguration
PUBLIC "-//mybatis.org//DTD MyBatis Generator Configuration 1.0//EN"
"http://mybatis.org/dtd/mybatis-generator-config_1_0.dtd">
<generatorConfiguration>
<classPathEntry location="C:/workspace/project/learning/mybatis/lib/mysql-connector-java-5.1.6.jar"/>
<context id="default" targetRuntime="MyBatis3">
<commentGenerator>
<property name="suppressDate" value="true"/>
<property name="suppressAllComments" value="true"/>
</commentGenerator>
<jdbcConnection driverClass="com.mysql.jdbc.Driver"
connectionURL="jdbc:mysql://localhost:3306/test"
userId="root"
password="dev">
</jdbcConnection>
<javaModelGenerator targetPackage="dulk.learn.mybatis.generator.pojo"
targetProject="./src/main/java">
<property name="trimStrings" value="true"/>
</javaModelGenerator>
<sqlMapGenerator targetPackage="generator"
targetProject="./src/main/resources">
</sqlMapGenerator>
<javaClientGenerator type="XMLMAPPER"
targetPackage="dulk.learn.mybatis.generator.mapper"
targetProject="./src/main/java">
</javaClientGenerator>
<table tableName="author" domainObjectName="Author"
enableCountByExample="false" enableUpdateByExample="false"
enableDeleteByExample="false" enableSelectByExample="false"
selectByExampleQueryId="false">
</table>
<table tableName="book" domainObjectName="Book"
enableCountByExample="false" enableUpdateByExample="false"
enableDeleteByExample="false" enableSelectByExample="false"
selectByExampleQueryId="false">
</table>
</context>
</generatorConfiguration>
1
2
3
4
5
6
<generatorConfiguration>
7
8
<classPathEntry location="C:/workspace/project/learning/mybatis/lib/mysql-connector-java-5.1.6.jar"/>
9
10
<context id="default" targetRuntime="MyBatis3">
11
12
<commentGenerator>
13
<property name="suppressDate" value="true"/>
14
<property name="suppressAllComments" value="true"/>
15
</commentGenerator>
16
17
<jdbcConnection driverClass="com.mysql.jdbc.Driver"
18
connectionURL="jdbc:mysql://localhost:3306/test"
19
userId="root"
20
password="dev">
21
</jdbcConnection>
22
23
<javaModelGenerator targetPackage="dulk.learn.mybatis.generator.pojo"
24
targetProject="./src/main/java">
25
<property name="trimStrings" value="true"/>
26
</javaModelGenerator>
27
28
<sqlMapGenerator targetPackage="generator"
29
targetProject="./src/main/resources">
30
</sqlMapGenerator>
31
32
<javaClientGenerator type="XMLMAPPER"
33
targetPackage="dulk.learn.mybatis.generator.mapper"
34
targetProject="./src/main/java">
35
</javaClientGenerator>
36
37
<table tableName="author" domainObjectName="Author"
38
enableCountByExample="false" enableUpdateByExample="false"
39
enableDeleteByExample="false" enableSelectByExample="false"
40
selectByExampleQueryId="false">
41
</table>
42
<table tableName="book" domainObjectName="Book"
43
enableCountByExample="false" enableUpdateByExample="false"
44
enableDeleteByExample="false" enableSelectByExample="false"
45
selectByExampleQueryId="false">
46
</table>
47
48
</context>
49
</generatorConfiguration>
另,配置文件中諸如 javaModelGenerator / sqlMapGenerator / javaClientGenerator 等配置的順序不要輕易改變,可能會導致插件執行時失敗。
4、使用方式
mvn mybatis-generator:generate
如果是在IDEA環境中,直接鼠標點擊執行即可:

目錄結構如下:

注:建表時,字段名稱建議用"_"分隔多個單詞,比如:author_id...,這樣生成的model,屬性名稱就會變成的駝峰命名,即:authorId