iBATIS SQL Maps（一）

青旅半醒 2021-09-09 16:06 329阅读 0赞

前段时间写了些 Hibernate 方面的 [系列文章，网友们反映还不错。在接下来的时间里，我将会引入另外一种 O/R Mapping 解决方案——**iBATIS**，本系列将沿用 Hibernate 系列文章的风格。][O_R Mapping _iBATIS_ Hibernate]

**什么是****[iBATIS][]****？**

和众多的 SourceForge 开源项目一样，iBATIS 曾经也是其中的一员。在2004年11月3日成功地成为了 [Apache Incubator][] 下的子项目。 iBATIS 包括 for Java 和 for .NET 两个版本，for Java 版提供了SQL Maps 和 DAO 框架，for .NET 只提供了 SQL Maps 框架。从现在开始我们只对 for Java 版的SQL Maps 展开讨论。

你可以在 [http://www.ibatis.com][iBATIS] 下载 iBATIS for Java，目前最新版本是2.0.9，压缩包里已经包含了 SQL Maps(ibatis-sqlmap-2.jar) 和 DAO 框架(ibatis-dao-2.jar)。

**为什么选择****[iBATIS][]****？**

也许各位看官已在各种不同的技术资料上了解到它的优势。但是对于我来说，选择它的理由只有一个——“ **利用原有资源**”。Hibernate 的却优秀，但是用来整合原有系统，它却很难胜任。例如，以前在进行数据建模时使用了复合主键、跨越多表产生的几十甚至上百行的查询语句、利用原有存储过程… … 当面临这一系列问题时 Hibernate 就显得力不从心了，要想使用 Hibernate就只能改造原有系统！

当我面临系统整合问题时（整合的要求很简单：只需要保留原有系统查询部分），iBATIS 进入了我的视线。原有系统中除 SQL语句需要小小的修改外，数据表、查询结果都不需要改变！也不用像 Hibernate 那样映射出众多的配置文件、POJO，一下子清爽了很多。 **BTW**：Hibernate 这种做法没有错！只是我只需要查询功能，仅仅是取我所好而已，避免了杀鸡用牛刀。

目前，系统整合已经结束，花了一个月时间。如果使用 Hibernate，恐怕我现在还在为怎么设计数据表、怎样下HQL而和同事争论。

**为什么选择****[iBATIS][]****？**

目前，系统整合已经结束，花了一个月时间。如果使用 Hibernate，恐怕我现在还在为怎么设计数据表、怎样下HQL而和同事争论。

**开始另一次** **O/R Mapping** **之旅**

上次 O/R Mapping 之旅的 BO、数据表还可以重用，只是把数据库迁移到了 MySQL。打开 Eclipse，新建一个 Resin 项目。把ibatis-sqlmap-2.jar 和 ibatis-common-2.jar 拷贝到 lib 目录下，再导入项目。和 Hibernate 自动配置、自动映射相比，iBATIS 的一切都是手工完成的。

在 src 下建立配置文件 SqlMapConfig.xml，数据库链接、连接池、SqlMap 映射文件… … 这些都要靠它了。官方参考手册对怎样进行设置有很详细的描述，我只对要用到的地方进行粗略说明。

<table style="WIDTH: 509px; HEIGHT: 100px"> 
 <tbody> 
  <tr> 
   <td> 
    <div> 
     <font>&lt;?xml version="1.0" encoding="UTF-8" ?&gt;<br>&lt;!DOCTYPE sqlMapConfig<br>&nbsp;&nbsp;&nbsp; PUBLIC "-//iBATIS.com//DTD SQL Map Config 2.0//EN"<br>&nbsp;&nbsp;&nbsp; "</font> 
     <a href="http://www.ibatis.com/dtd/sql-map-config-2.dtd" rel="nofollow"><font>http://www.ibatis.com/dtd/sql-map-config-2.dtd</font></a> 
     <font>"&gt;</font> 
    </div> 
    <div> 
     <font>&lt;sqlMapConfig&gt;</font> 
    </div> 
    <div> 
     <font>&nbsp; &lt;settings<br>&nbsp;&nbsp;&nbsp; cacheModelsEnabled="true"<br>&nbsp;&nbsp;&nbsp; enhancementEnabled="true"<br>&nbsp;&nbsp;&nbsp; lazyLoadingEnabled="true"<br>&nbsp;&nbsp;&nbsp; errorTracingEnabled="false"<br>&nbsp;&nbsp;&nbsp; maxRequests="32"<br>&nbsp;&nbsp;&nbsp; maxSessions="10"<br>&nbsp;&nbsp;&nbsp; maxTransactions="5"<br>&nbsp;&nbsp;&nbsp; useStatementNamespaces="false"<br>&nbsp;&nbsp;&nbsp; /&gt;</font> 
    </div> 
    <div> 
     <font>&nbsp; &lt;transactionManager type="JDBC"&gt;<br>&nbsp;&nbsp;&nbsp; &lt;dataSource type="SIMPLE"&gt;<br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; &lt;property name="JDBC.Driver" value="org.gjt.mm.mysql.Driver"/&gt;<br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; &lt;property name="JDBC.ConnectionURL" value="jdbc:mysql://localhost/new_db?useUnicode=true"/&gt;<br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; &lt;property name="JDBC.Username" value="root"/&gt;<br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; &lt;property name="JDBC.Password" value=""/&gt;<br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; &lt;property name="JDBC.DefaultAutoCommit" value="true"/&gt;<br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; &lt;property name="Pool.MaximumActiveConnections" value="10"/&gt;<br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; &lt;property name="Pool.MaximumIdleConnections" value="5"/&gt;<br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; &lt;property name="Pool.MaximumCheckoutTime" value="120000"/&gt;<br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; &lt;property name="Pool.TimeToWait" value="500"/&gt;<br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; &lt;property name="Pool.PingQuery" value="select 1 from ACCOUNT"/&gt;<br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; &lt;property name="Pool.PingEnabled" value="false"/&gt;<br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; &lt;property name="Pool.PingConnectionsOlderThan" value="1"/&gt;<br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; &lt;property name="Pool.PingConnectionsNotUsedFor" value="1"/&gt;<br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; &lt;property name="Pool.QuietMode" value="true"/&gt;<br>&nbsp;&nbsp;&nbsp; &lt;/dataSource&gt;<br>&nbsp; &lt;/transactionManager&gt;</font> 
    </div> 
    <div> 
     <font>&nbsp; &lt;sqlMap resource="bo/mapping/AutoMag.xml"/&gt;<br>&lt;/sqlMapConfig&gt;</font> 
    </div> </td> 
  </tr> 
 </tbody> 
</table>

**transactionManager** 元素定义了 iBATIS 事务管理器。type 可选项包括：

**JDBC**：通过传统 JDBC 来管理事务。

**JTA**：使用一个 JTA 全局事务，使 iBATIS 的事务包括在更大的事务范围内（跨数据库Session的），这个更大的事务范围可能包括了其他的数据库和事务资源。这个配置需要一个 UserTransaction 属性，以便从 JNDI 获得一个 UserTransaction。

**EXTERNAL** ：调用  iBATIS  以外的其他事务管理器来管理事务。

**dataSource** 元素是 transactionManager 的一部分。type 可选项包括：  
  
    **SIMPLE**：SIMPLE 是 iBATIS 内置的 dataSource 实现，其中实现了一个简单的数据库连接池，当无容器提供 DataSource 服务时可以使用该选项，对应 iBATIS 实现类为com.ibatis.sqlmap.engine.datasource.SimpleDataSourceFactory。

    **DBCP:**基于 Apache DBCP 连接池 API 实现的 DataSource，当无容器提供 DataSource 服务时，可以使用该选项，对应 iBATIS 实现类为 com.ibatis.sqlmap.engine.datasource.DbcpDataSourceFactory。

**JNDI**：使用 J2EE 容器提供的 DataSource 实现，DataSource 将通过指定的 JNDI Name 从容器中获取。对应 iBATIS 实现类为 com.ibatis.sqlmap.engine.datasource.JndiDataSourceFactory。

** ** **注意！** 每种 dataSource  元素的  property  都有不同的地方，不能光把  type  名字改了了事。

**sqlMap** 元素定义了映射文件的存放位置，配置文件中可包含多个 sqlMap 元素，比如：

<table style="WIDTH: 514px; HEIGHT: 84px"> 
 <tbody> 
  <tr> 
   <td> 
    <div> 
     <font>&lt;sqlMap resource="mapping/AutoMag1.xml"/&gt;<br>&lt;sqlMap resource="bo/mapping/AutoMag2.xml"/&gt;</font> 
    </div> 
    <div> 
     <font>&lt;sqlMap url="</font> 
     <font>file:///c:/eclipse/workspace/iBATISTest/src/bo/</font> 
     <font> AutoMag2.xml "/&gt;<br>… …</font> 
    </div> </td> 
  </tr> 
 </tbody> 
</table>

你也许已发现，我只定义了单个映射文件。不错，和  Hibernate  的一个表一个映射文件不同， iBATIS  的映射文件个数可以人为控制，颗粒度自己掌握。

光有 BO 和配置文件还不行，还要为本次测试创建测试类 AutoMag.java。完整的布局如下所示：

![r_structure.jpg][]

以下为 iBATIS SQL Maps 工作流程，对于理解概念很有帮助。大意是 1、你可以把 JavaBean、Map 类型、原始变量（或者它们的Wrapper Class）、XML 数据作为传入对象；2、通过配置文件载入映射文件；3、利用框架翻译成 JDBC 来访问数据库；4、执行结果可以是 JavaBean、Map 类型、原始变量的 Wrapper Class、XML 数据。                  
       ![r_map.jpg][]

**（请注意！引用、转贴本文应注明原作者：Rosen Jiang 以及出处：**[**http://blog.csdn.net/rosen**][http_blog.csdn.net_rosen]**）**

![r_structure.jpg][]

**（请注意！引用、转贴本文应注明原作者：Rosen Jiang 以及出处：**[**http://blog.csdn.net/rosen**][http_blog.csdn.net_rosen]**）**

[O_R Mapping _iBATIS_ Hibernate]: http://blog.csdn.net/rosen/archive/2004/11/12/179646.aspx
[iBATIS]: http://www.ibatis.com/
[Apache Incubator]: http://incubator.apache.org/projects/ibatis.html
[r_structure.jpg]: /images/20210720/c42ea3f2ac7542b496aa502d4b4b32a8.png
[r_map.jpg]: /images/20210720/984beda6d6d949bd829663734ee7b3b7.png
[http_blog.csdn.net_rosen]: http://blog.csdn.net/rosen