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