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