mybatis 代碼生成器(IDEA, Maven)及配置詳解(部分配置你應該不知道)
在使用 mybatis 過程中, 當手寫 JavaBean和XML 寫的越來越多的時候, 就越來越同意出錯。這種重復性的工作, 我們當然不希望做那麽多。
還好, mybatis 為我們提供了強大的代碼生成--MybatisGenerator。
通過簡單的配置, 我們就可以生成各種類型的實體類, Mapper接口, MapperXML文件, Example對象等。 通過這些生成的文件, 我們就可以方便的進行單表進行增刪改查的操作。
以下的工具使用的都是 IDEA
1 創建代碼生成器
1.1 創建Maven項目
1.1.1 菜單上選擇新建項目
File | New | Project
1.1.2 選擇左側的Maven
由於我們只是創建一個普通的項目, 此處點擊 Next
即可。
1.1.3 輸入GroupId
和ArtifactId
- 在我的項目中,
GroupId 填 com.homejim.mybatis
ArtifactId 填 mybatis-generator
點擊 Next
。
1.1.4 Finish
通過以上步驟, 一個普通的Maven
項目就創建好了。
1.2 配置 generator.xml
其實名字無所謂, 只要跟下面的 pom.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> <!-- 本地數據庫驅動程序jar包的全路徑 --> <classPathEntry location="C:\Users\\Administrator\\.m2\repository\\mysql\\mysql-connector-java\\8.0.12\\mysql-connector-java-8.0.12.jar"/> <context id="context" targetRuntime="MyBatis3"> <commentGenerator> <property name="suppressAllComments" value="false"/> <property name="suppressDate" value="true"/> </commentGenerator> <!-- 數據庫的相關配置 --> <jdbcConnection driverClass="com.mysql.jdbc.Driver" connectionURL="jdbc:mysql://localhost:3306/mybatis" userId="root" password="jim777"/> <javaTypeResolver> <property name="forceBigDecimals" value="false"/> </javaTypeResolver> <!-- 實體類生成的位置 --> <javaModelGenerator targetPackage="com.homejim.mybatis.entity" targetProject=".\src\main\java"> <property name="enableSubPackages" value="false"/> <property name="trimStrings" value="true"/> </javaModelGenerator> <!-- *Mapper.xml 文件的位置 sqlMapGenerator--> <sqlMapGenerator targetPackage="mybatis/mapper" targetProject=".\src\main\resources"> <property name="enableSubPackages" value="false"/> </sqlMapGenerator> <!-- Mapper 接口文件的位置 --> <javaClientGenerator type="XMLMAPPER" targetPackage="com.homejim.mybatis.mapper" targetProject=".\src\main\java"> <property name="enableSubPackages" value="false"/> </javaClientGenerator> <!-- 相關表的配置 --> <table tableName="blog" /> </context> </generatorConfiguration>
需要改一些內容:
- 本地數據庫驅動程序jar包的全路徑(必須要改)。
- 數據庫的相關配置(必須要改)
- 相關表的配置(必須要改)
- 實體類生成存放的位置。
- MapperXML 生成文件存放的位置。
- Mapper 接口存放的位置。
如果不知道怎麽改, 請看後面的配置詳解。
1.3 配置 pom.xml
在原基礎上添加一些內容。
<?xml version="1.0" encoding="UTF-8"?> <project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd"> <modelVersion>4.0.0</modelVersion> <groupId>com.homejim.mybatis</groupId> <artifactId>mybatis-generator</artifactId> <version>1.0-SNAPSHOT</version> <!--在原基礎上添加 這些就好了--> <build> <finalName>mybatis-generator</finalName> <plugins> <plugin> <groupId>org.mybatis.generator</groupId> <artifactId>mybatis-generator-maven-plugin</artifactId> <version>1.3.7</version> <configuration> <!--此處需要註意, 文件與上面的文件匹配--> <configurationFile>src/main/resources/generator.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.7</version> </dependency> </dependencies> </plugin> </plugins> </build> <!--到此結束--> </project>
需要註意的是 configurationFile 中的文件指的是 generator.xml。 因此路徑寫的是該文件的相對路徑, 名稱也跟該文件相同。
到此, mybatis-generator 就可以使用啦。
1.4 使用及測試
1.4.1 打開 Maven Projects 視圖
在 IDEA 上, 打開:
View | Tools | Windwos | Maven Projects
1.4.2 Maven Projects 中雙擊 mybatis-generator
在右側此時可以看到 Maven Projects 了。找到 mybatis-generator 插件。
mybatis-generator | Plugins | mybatis-generator | mybatis-generator
1.4.3 雙擊運行
運行正確後, 生成代碼, 得到如下的結構
2 XML 配置詳解
僅僅是上面那麽簡單的使用還不夠爽。 那麽我們就可以通過更改 generator.xml 配置文件的方式進行生成的配置。
2.1 優先
推薦查看官方的文檔。
英文不錯的: 官方網站。
中文翻譯版: 翻譯版網站
2.2 官網沒有的
2.2.1 property 標簽
該標簽在官網中只是說用來指定元素的屬性, 至於怎麽用沒有詳細的講解。
2.2.1.1 分隔符相關
<property name="autoDelimitKeywords" value="true"/>
<property name="beginningDelimiter" value="`"/>
<property name="endingDelimiter" value="`"/>
以上的配置對應的是 mysql, 當數據庫中的字段和數據庫的關鍵字一樣時, 就會使用分隔符。
比如我們的數據列是 delete
, 按以上的配置後, 在它出現的地方, 就變成 `delete`
。
2.2.1.2 編碼
默認是使用當前的系統環境的編碼, 可以配置為 GBK 或 UTF-8。
<property name="javaFileEncoding" value="UTF-8"/>
我想項目為 UTF-8, 如果指定生成 GBK, 則自動生成的中文就是亂碼。
2.2.1.3 格式化
<!--格式化生成的 Java 代碼-->
<property name="javaFormatter" value="org.mybatis.generator.api.dom.DefaultJavaFormatter"/>
<!--格式化生成的 XML-->
<property name="xmlFormatter" value="org.mybatis.generator.api.dom.DefaultXmlFormatter"/>
這些顯然都是可以自定義實現的的。
2.2.2 plugins 標簽
plugins 標簽用來擴展或修改代碼生成器生成的代碼。
在生成的 XML 中, 是沒有 <cache> 這個標簽的。 該標簽是配置緩存的。
如果我們想生成這個標簽, 那麽可以 plugins 中進行配置。
<plugin type="org.mybatis.generator.plugins.CachePlugin" >
<property name="cache_eviction" value="LRU"/>
</plugin>
比如你想生成的 JavaBean 中自行實現 Serializable 接口。
<plugin type="org.mybatis.generator.plugins.SerializablePlugin" />
還能自定義插件。
這些插件都蠻有用的, 感覺後續可以專門開一篇文章來講解。
2.2.3 commentGenerator 標簽
看名稱, 就知道是用來生成註釋用的。
默認配置:
<commentGenerator >
<property name="suppressAllComments" value="false"/>
<property name="suppressDate" value="false"/>
<property name="addRemarkComments" value="false"/>
</commentGenerator>
suppressAllComments: 阻止生成註釋, 默認值是false。
suppressDate: 阻止生成的註釋包含時間戳, 默認為false。
addRemarkComments: 註釋中添加數據庫的註釋, 默認為 false。
還有一個就是我們可以通過 type 屬性指定我們自定義的註解實現類, 生成我們自己想要的註解。 自定義的實現類需要實現 org.mybatis.generator.api.CommentGenerator
。
2.2.4 待續
待添加。
Github
mybatis-examples 項目中的 mybatis-generator 即本文使用到的所有代碼。
mybatis 代碼生成器(IDEA, Maven)及配置詳解(部分配置你應該不知道)