MyBatis Generator Core 1.3.5 修訂版：中文註釋與功能增強深度解析

MyBatis Generator 核心源碼剖析與客製化擴充實戰

專案簡介

MyBatis Generator 根據資料庫表結構反向生成實體類、Mapper 介面與 XML 映射檔。本專案基於 1.3.5 版本，新增詳細中文註釋並擴充實用功能，原始碼託管於 GitHub。

源碼剖析重點模組

1. org.mybatis.generator.plugins.ToStringPlugin：自動生成 toString() 外掛
2. org.mybatis.generator.plugins.MapperConfigPlugin：Mapper 配置外掛
3. org.mybatis.generator.api.ShellRunner：主程式入口
4. org.mybatis.generator.config.xml.ConfigurationParser：配置檔解析器
5. org.mybatis.generator.config.Context：上下文封裝核心類

核心功能增強

1. 資料表備註資訊自動獲取

在 FullyQualifiedTable 新增 remark 欄位，於 DatabaseIntrospector.calculateIntrospectedTables() 中執行 SQL 獲取表註釋：

Statement stmt = connection.createStatement();
ResultSet rs = stmt.executeQuery(
    "SHOW TABLE STATUS LIKE '" + tableName + "'");
while (rs.next()) {
    table.setRemark(rs.getString("COMMENT"));
}
rs.close();
stmt.close();

2. 非 Model 類別 Example 註釋生成

新增 addExampleClassComment(TopLevelClass) 方法，為 Example 類別生成標準化註釋。

3. 重構生成檔案邏輯

優化 IntrospectedTableMyBatis3Impl.getGeneratedJavaFiles()，支援更靈活的檔案生成控制。

4. 完整中文註釋體系

入口 ShellRunner 及核心流程全部補充中文註釋，註釋模板可於 DefaultCommentGenerator 客製化。

原始碼獲取

GitHub：mybatis-generator-core-chinese-annotation-1.3.5

適用場景

• 團隊需統一代碼生成風格與中文文檔規範
• 需自動同步資料表備註至實體類註釋
• 欲深入理解 MyBatis Generator 內部機制並進行二次開發

此修訂版大幅降低生成代碼的二次修改成本，提升團隊開發效率。