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);