iBator 實戰指南：為 iBatis/MyBatis 自動生成持久層代碼

iBator (現更名為 MyBatis Generator) 是 iBatis/MyBatis 官方代碼生成工具，能根據資料庫表結構自動產生 Java 實體類、SQL Map XML、DAO 介面及實作，大幅減少重複性勞動。本文以 Eclipse 環境為例，詳述安裝、配置、生成全流程。

一、Eclipse 安裝 iBator 插件

1. Help > Install New Software (或舊版 Help > Software Updates)
2. Add Site：https://ibatis.apache.org/tools/ibator (現建議使用 MyBatis Generator 更新站點)
3. 選擇 iBator / MyBatis Generator 安裝，重啟 Eclipse

二、建立獨立生成專案 (推薦做法)

不要污染主專案，建立專用專案 (如 IbatorPrj) 存放生成配置與輸出代碼，生成後再複製至目標專案。

1. 右鍵專案 > Add iBATOR to the build path (加入運行時依賴)
2. 建立配置檔 ibator-config.xml (或 generatorConfig.xml)

三、核心配置檔詳解

四、執行生成與結果驗證

1. 右鍵配置檔 > Generate iBatis Artifacts (或 MyBatis Generator > Generate)
2. Console 輸出進度，完成後在 targetProject 目錄下看到生成結構：

   src/
     com/sample/           → 實體類 (JavaBean1.java)
     com/sample/xml/       → SQL Map (JavaBean1_SqlMap.xml)
     com/sample/dao/       → DAO 介面/實作 (JavaBean1DAO.java, JavaBean1DAOImpl.java)
   

3. 檢查生成代碼：CRUD 方法、動態 SQL (where/trim/foreach)、分頁查詢 (若配置) 等

五、進階配置技巧

• 覆蓋策略：<property name="overwrite" value="true"/> 允許覆蓋現有檔案 (預設 false 保護手工修改)
• 自訂註解/註釋：<commentGenerator> 配置是否生成日期、作者、版權等
• 型別處理器：<typeHandler> 映射特殊 JDBC 型別 (JSON, Enum, JodaTime 等)
• 插件擴展：<plugin> 引入 Lombok、Serializable、ToString 等生成增強
• 多資料庫/多 Schema：單一配置檔可定義多個 <ibatorContext> 或多個 <table>

六、遷移至 MyBatis Generator (現代專案)

iBator 已停止維護，新專案請直接使用 MyBatis Generator：

• Maven 插件：org.mybatis.generator:mybatis-generator-maven-plugin 整合建構生命週期
• 配置檔 DTD 更新為 mybatis-generator-config_1_0.dtd，targetRuntime 設為 MyBatis3 或 MyBatis3Simple
• 支援 Mapper 介面 (無需 DAO 實作)、注解映射、Lambda 查詢構建器等現代特性