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包。要一次分多個<classPathEntry />。可能不
能用";"分號把各個jar包隔開的格式書寫。大家可以自己嘗試一下。
(2008.04.06補充:從我經理給我的文件中發現，windos系統也可以這樣寫。/DriveName:/filepath。如/E:/fy/XXX.jar)
4."/"和"/"這兩個符號，在寫jar文檔路徑時要注意。各個操作系統不能代表的路徑分隔符是不同的。
windows系統使用"/"，linux系統使用"/"等。
5.我是使用eclipse開發的，在使用快捷菜單[Generate iBATIS Artifacts]時，也從來沒有成功過。後來
還確實使用原始方法，在命令行下嘗試了幾次才成功的。第一次錯誤是因爲，我錯誤的認爲“abator.jar
這個jar包和其他一樣，添加到Build Path中就可以不用-jar filepath這種形式指明abator.jar的所在位
置。”但是，結果確實還是要指明的。
注意：在命令行下有提示錯誤，根據錯誤排除後才成功的。
6.targetProject的指明是對於你的abator配置文件的一個相對路徑。這個目錄是用於存放自動生成的文檔
的一個臨時目錄。如果要在自己項目中使用這些自動生成的文檔。要另行copy的。推薦方式是在abator的
配置文件所在目錄建立一個目錄名爲abator的目錄。
7.abator配置文件應該至少包含一個<table tableName="XXXX"/>,也就是至少要用到一個用於自動生成相
關文檔的數據庫表。
如果沒有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
其他注意點會在遇到時添加，你也可以添加。
本文檔純屬原創轉載請標註說明。
2008.3.28
fy_kenny