ibatis自動生成工具abator使用注意事項

2009-07-16 11:40:23

abator是ibatis的自動生成文檔的工具插件,而ibatis則是用于持久層類似Hibernate，但可以手動寫sql，這使得我們的工作更加便捷。但是在使用abator的時候，我們有幾點需要注意。

abator是ibatis的自動生成文檔的工具插件,而ibatis則是用于持久層類似Hibernate，但可以手動寫sql，使得我們的工作更加便捷。

產品鏈接：http://ibatis.apache.org/abator.html

針對我在使用abator時遇到的幾個問題的解決方案：

1.eclipse-rcp-europa-fall2-win32這個版本的eclipse中，使用AbatorForEclipse1.1.0這個版本的abator時，在使用菜單中的[Abator for ibatis configuration file]自動創建abatorConfig.xml這個文件時出現未能正常初始化相應wizard的異常。但是，使用AbatorForEclipse1.0.0版本時正常。

注意：***不要把兩個版本的插件都放一起，如果，你使用links方式安裝插件（該安裝插件的方法請查詢相關文檔），即使未創建相對應的.link文件，也不能把插件放在其他插件一個目錄。可能是我之前使用了AbatorForEclipse1.1.0,但是，我把AbatorForEclipse1.0.0放在和AbatorForEclipse1.1.0一起，但，真正實用了AbatorForEclipse1.0.0版本時，卻還是有異常。具體的大家可以自己嘗試一下。

2.abator1.0.0目前只對DB2和MySql提供支持。我就是在使用sqlserver2000時沒有成功。但是，一方面我電腦好像本來就有問題用別的開源訪問sqlserver的插件也不行，如:Quantum DB。后來在基本上能排除abator配置文件配置錯誤的情況下我又運行了。結果有錯誤可能確實是abator不能支持sqlserver的原因。AbatorForEclipse1.1.0中看資料說已經支持Oracle了。希望能早點支持sqlserver。

3.當有多個jdbc驅動jar包時，如：sqlserver就有三個jar包。要一次分多個。可能不能用";"分號把各個jar包隔開的格式書寫。大家可以自己嘗試一下。

4."/"和"\"這兩個符號，在寫jar文檔路徑時要注意。各個操作系統不能代表的路徑分隔符是不同的。windows系統使用"\"，linux系統使用"/"等。(2008.04.06補充:從我經理給我的文件中發現，windows系統也可以這樣寫。/DriveName:/filepath。如/E:/fy/XXX.jar)

5.我是使用eclipse開發的，在使用快捷菜單[Generate ibatis Artifacts]時，也從來沒有成功過。后來還確實使用原始方法，在命令行下嘗試了幾次才成功的。***次錯誤是因為，我錯誤的認為“abator.jar 這個jar包和其他一樣，添加到Build Path中就可以不用-jar filepath這種形式指明abator.jar的所在位置。”但是，結果確實還是要指明的。注意：在命令行下有提示錯誤，根據錯誤排除后才成功的。

6.targetProject的指明是對于你的abator配置文件的一個相對路徑。這個目錄是用于存放自動生成的文檔的一個臨時目錄。如果要在自己項目中使用這些自動生成的文檔。要另行copy的。推薦方式是在abator的配置文件所在目錄建立一個目錄名為abator的目錄。

7.abator配置文件應該至少包含一個

,也就是至少要用到一個用于自動生成相關文檔的數據庫表。如果沒有table會出現類似下面的異常信息：
XML Parser Errors occured:

XML Parser Error on line 51: The content of element type "abatorContext" is inco
mplete, it must match "(property*,jdbcConnection,javaTypeResolver?,javaModelGene
rator,sqlMapGenerator,daoGenerator?,table+)".

8.包結果的推薦：
yourdomainname.projectname.model
yourdomainname.projectname.persistence.sqlmap
yourdomainname.projectname.persistence.dao

其他注意點會在遇到時添加，你也可以添加。

【編輯推薦】