iBATOR是iBATIS的代码生成器. iBATOR内省一个或多个数据库表并生成可用于访问表的iBATIS工件.
稍后您可以编写自定义SQL代码或存储过程以满足您的要求. iBATOR生成以下工件 :
SqlMap XML文件
用于匹配主要的Java类表的键和字段
DAO使用上述对象的类(可选)
iBATOR可以作为独立的JAR文件运行,也可以作为Ant任务运行,也可以作为Eclipse插件运行.本教程描述了从命令行生成iBATIS配置文件的最简单方法.
下载iBATOR
如果您使用的是其他IDE,请下载独立JAR比Eclipse.独立JAR包含运行iBATOR的Ant任务,或者您可以从Java代码的命令行运行iBATOR.
您可以下载zip文件.
您可以查看在线文档: iBATOR文档.
生成配置文件
要运行iBATOR,请执行以下步骤 :
步骤1
适当地创建并填充配置文件ibatorConfig.xml.至少,您必须指定 :
要指定的< jdbcConnection> 元素如何连接到目标数据库.
一个< javaModelGenerator> 元素,用于指定目标包和目标项目生成的Java模型对象.
一个< sqlMapGenerator> 元素,用于指定生成的SQL映射的目标包和目标项目文件.
< daoGenerator> 元素,用于指定生成的DAO接口和类的目标包和目标项目(如果你不想生成DAO,你可以省略< daoGenerator>元素.)
至少有一个数据库< table> 元素
注意:参见 XML配置文件参考页面.
第2步
将文件保存在方便的位置,例如:\ temp \ ibatorConfig.xml.
步骤3
现在从命令行运行iBATOR,如下所示 :
java -jar abator.jar -configfile \temp\abatorConfig.xml -overwrite
它将告诉iBATOR使用您的配置文件运行.它还将告诉iBATOR覆盖任何具有相同名称的现有Java文件.如果要保存任何现有的Java文件,则省略 : overwrite 参数.
如果存在冲突,iBATOR会将新生成的文件保存为唯一名称.
运行iBATOR后,您需要创建或修改标准iBATIS配置文件以使用新生成的代码.这将在下一节中解释.
运行iBATOR后的任务
运行iBATOR后,您需要创建或修改其他iBATIS配置工件.主要任务如下:<
创建或修改SqlMapConfig.xml文件.
创建或修改dao.xml文件(仅当您使用iBATIS DAO框架时).
下面详细描述每个任务 :
更新SqlMapConfig.xml文件
iBATIS使用XML文件(通常名为SqlMapConfig.xml)来指定数据库连接的信息,事务管理方案,以及在iBATIS会话中使用的SQL映射XML文件.
iBATOR无法为您创建此文件,因为它对您的执行环境一无所知.但是,此文件中的某些项目直接与iBATOR生成的项目相关.
配置文件中的iBATOR特定需求如下 :
必须启用语句命名空间.
必须列出iBATOR生成的SQL Map XML文件.
例如,假设iBATOR生成了一个名为MyTable_SqlMap.xml的SQL Map XML文件,并且该文件已放置在项目的test.xml包中. SqlMapConfig.xml文件应该包含以下条目 :
如果有多个SQL Map XML文件(非常常见),则可以按任意顺序列出文件,重复< sqlMap> < transactionManager>之后的元素元素.
更新dao.xml文件
iBATIS DAO框架由通常称为dao.xml的xml文件配置.
iBATIS DAO框架使用此文件来控制DAO的数据库连接信息,并列出DAO实现类和DAO接口.
在此文件中,你应该指定你的SqlMapConfig.xml文件的路径,以及所有iBATOR生成的DAO接口和实现类.
例如,假设iBATOR生成了一个名为MyTableDAO的DAO接口和一个实现类名为MyTableDAOImpl,并且文件已经放在项目的test.dao包中.
dao.xml文件应该包含这些条目 :
注意:只有在为iBATIS DAO框架生成DAO时才需要执行此步骤.