iBaits中SqlMapClientTemplate的使用

Apache iBatis（现已迁至Google Code下发展，更名为MyBatis）是当前IT项目中使用很广泛的一个半自动ORM框架，区别于Hibernate之类的全自动框架，iBatis对数据库的操作拥有更加灵活的控制，对于那些经常需要调用本地数据库函数自定义SQL语句，或是喜欢自己优化SQL执行效率的开发者来说，iBatis是一个非常不错的选择。而得到广泛应用的开源企业架构SpringFramework，也很好的将其进行了集成，使得iBatis在 SpringFramework中的使用更加便利、快捷。开发者所要做的就是继承SpringFramework中提供的 SqlMapClientDaoSupport类即可。下面，我将自己的使用经验与大家分享一下： 

1、SqlMapClientFactoryBean 的装配 
    SqlMapClientFactoryBean是SqlMapClientTemplate使用的基础，如果在 
SpringFramework应用中没有装配SqlMapClientFactoryBean，那么SqlMapClientTemplate将不可用，报空指针错误。 

 <bean id="sqlMapClient" class="org.springframework.orm.ibatis.SqlMapClientFactoryBean">
     <property name="configLocation" value="/WEB-INF/sqlmap-config.xml"/> <!-- iBatis sqlmap config 文件位置 -->
     <property name="dataSource" ref="dataSource"/> <!-- 在SpringFramework配置文件中使用的数据源 -->
     <property name="lobHandler" ref="oracleLobHandler"/> <!-- 如果需要读写Lob字段，需要注入在SpringFramework配置文件中配置好的Handler，这里是Oracle的数据库 -->
 </bean>

2、继承使用SqlMapClientDaoSupport类 
声明Java类： 

    ......
     import org.springframework.orm.ibatis.support.SqlMapClientDaoSupport;
     ......
     public class ReportDAOImpl extends SqlMapClientDaoSupport {
         ......
     }

 SpringFramework配置文件中装配Java类：
     <bean id="reportDao" class="com.test.dao.ReportDAOImpl">
         <property name="sqlMapClient" ref="sqlMapClient"/> <!-- 装配SqlMapClientFactoryBean -->
     </bean>

3、使用SqlMapClientTemplate查询 
Java代码： 
    当执行没有参数的查询时： 

 List result = getSqlMapClientTemplate().queryForList("TestSpace.qryTest");

        "TestSpace"为iBatis SqlMap文件的命名空间；"qryTest"为iBatis SqlMap的查询方法id 

    当按照主键获取某条记录信息时： 
  

 Long id = new Long("2");
    Object resultObj = getSqlMapClientTemplate().queryForObject("TestSpace.getTest", id);

    当按照某些条件查询时： 
   

 ObjectA objA = new ObjectA();
     objA.setParam1("test1");
     objA.setParam2("test2");
     ......
     List result = getSqlMapClientTemplate().queryForList("TestSpace.qryTestByParam", objA);

    如果需要取4~40条数据： 
    List result = getSqlMapClientTemplate().queryForList("TestSpace.qryTestByParam", objA, 4, 40); 
    也可以返回Map 
  

 Map result = getSqlMapClientTemplate().queryForMap("TestSpace.qryTestByParam", objA, "MapKey");

4、使用SqlMapClientTemplate添加数据 
Java代码： 
    ObjectA objA = new ObjectA(); 
  

 objA.setParam1("test1");
    objA.setParam2("test2");
    ......
    getSqlMapClientTemplate().insert("TestSpace.insertTest", objA);

5、使用SqlMapClientTemplate更新数据 
Java代码： 
   

 ObjectA objA = new ObjectA();
     objA.setParam1("test1");
     objA.setParam2("test2");
     ......
     getSqlMapClientTemplate().update("TestSpace.updateTest", objA);

    更新前20条记录： 
   

 getSqlMapClientTemplate().update("TestSpace.updateTest", objA, 20);

6、使用SqlMapClientTemplate删除数据 
Java代码： 
  

 Long id = new Long("2");
    getSqlMapClientTemplate().delete("TestSpace.deleteTest", id);