spring JdbcTemplate

Spring 的JDBC模板方法
Spring 通过模板方法模式，帮助程序员完成资源创建，资源管理等固定的的工作。程序员可专注于编写sql语句，处理结果集 。



JDBCTemplate 有一个DataSource 类型的成员变量为其创建所需要的连接资源 。



JdbcTemplate t = new JdbcTemplate( DataSource ) ;
t.update( …. ) ;
t.query( …. ) ;


DataSource的使用 ：
Spring 提供几种选择来获得DataSource对象 ：



1，通过 JNDI
         <bean id="dataSource" class="org.springframework.jndi.JndiObjectFactoryBean">
              <property name="jndiName">
                          <value>java:comp/env/jdbc/myDataSource</value>
                     </property>
         </bean>

2，创建DataSource连接池(应用没有运行在AppServer中)


         <bean id="dataSource" class="org.apache.commons.dbcp.BasicDataSource">
                     <property name="driverClassName">
                        <value></value>
                     </property>
                     <property name="url">
                        <value></value>
                     </property>
                     <property name="username">
                        <value></value>
                     </property>
                     <property name="password">
                        <value></value>
                     </property>
         </bean>








3，测试时使用的DataSource
Spring提供了一个简易的DataSource，由于在单元测试时使用 。

DriverManagerDataSource ds = new DriverManagerDataSource();
ds.setDrverClassName( xxx ) ;
ds.setUrl( url ) ;
ds.setUserName( username ) ;
ds.setPassword( password ) ;




在DAO中使用JdbcTemplate ：
基本步骤 ：

1)      声明dataSource

2)      声明JdbcTemplate，向JdbcTemplate中注入dataSource

3)      声明Dao对象，并向dao对象中注入JdbcTemplate,JdbcTemplate是线程安全的，所以对同一个DataSource对象，使用一个JdbcTemplate就可以了。

4)      在Dao对象中使用JdbcTemplate进行JDBC编程 。



声明DataSource 对象 。

<bean id="dataSource" class="org.apache.commons.dbcp.BasicDataSource">
                     <property name="driverClassName">
                        <value></value>
                     </property>
                     <property name="url">
                        <value></value>
                     </property>
                     <property name="username">
                        <value></value>
                     </property>
                     <property name="password">
                        <value></value>
                     </property>
         </bean>
声明JdbcTemplate，向JdbcTemplate中注入dataSource



<bean id=”jdbcTemplate” class=”org.springframework.jdbc.core.JdbcTemplate”>
       <property name=”dataSource”>
              <ref bean=”dataSource”/>
       </property>
</bean>








声明Dao对象，并向dao对象中注入JdbcTemplate,JdbcTemplate

<bean id=”dao” class=”xxxxx.StudentDao>
       <property name=”jdbcTemplate”>
              <ref bean=”jdbcTemplate”/>
       </property>
</bean>


在Dao对象中使用JdbcTemplate进行JDBC编程



public class StudentDao{
       private JdbcTemplate jdbcTemplate ;
       public void setJdbcTemplate( JdbcTemplate jdbcTemplate ){
              this.jdbcTempldate = jdbcTemplate ;
       }
       Public JdbctTemplate getJdbcTemplate(){ return jdbcTemplate ; }


       public void insert( Persion person ){
              String sql = “insert into Person(….) values ( ? , ? , ? ) ;
              Object args[] = { person.getId() , person.getName() , person.getGender() } ;
              jdbcTemplate.update( sql , args ) ;
       }
}


jdbcTempldate.update()方法还有一种重载，多一个int[] 由于指定每一个参数的数据类型，

当参数中有null的时候，这个重载会提供更好的支持 。



       String sql = “insert into …. “ ;
       Object args[] = {  ……. } ;
int types[] = { Types.INTEGER , TYPE.VARCHAR , TYPE.VARCHAR } ;
jdbcTemplate.update( sql , args , types ) ;


使用Batch提高性能
JdbcTemplate中提供了batchUpdate方法来利用Batch提高性能 。

jdbcTemplate.batchUpdate( sql , setter ) ;
该函数需要一个BatchPreparedStatementSetter 类型的一个参数，每次添加一个Batch之后，jdbcTempldate都会调用setter的setValue方法，为当前SQL设置SQL 参数。如果我们要使用Batch特性的话，需要自己实现该接口 。



BatchPreparedStatementSetter接口的声明是 ：



public interface BachPreparedStatementSetter{
       int getBatchSize()
     /**
       *@index 用来指定当前是第几次调用setValues方法，或者也可以
       *       理解为是在为第几个Bath设置参数 。
       */
     void setValues( PreparedStatement pstm  , int index ) ;
}


我们自己实现的BatchPreparedStatementSetter ：

Public class MyBatchPreparedStatementSetter(
       private List persons ；
       // getPersons and setPersons ;
       Public int getBatchSize(){ return person.size() ; }
       Public void setValue( PreparedStatement pstm , int idx ){
              Person p = (Person)persons.get( idx ) ;
              Pstm.setInt( 1, p.getId() ) ;
              Pstm.setString( 2 , p.getName ) ;
              ………
}
}




JdbcTemplate中使用到的回调接口 ：


在JdbcTemplate工作的过程中，要使用到很多回调接口，对于这些接口，Spring都提供了相应得实现。



1，PreparedStatementCreator .

   public interface PreparedStatementCreator( Connection conn ){
     PreparedStatement createPreparedStatement( Connection conn ) throws SQLException
   }


   该接口用于创建PreparedStatement对象。JdbcTemplate 在执行sql所需要用到的statement就是通过这个接口创建的。





2， SqlProvider :

      在实现PreparedStatementCreator的同时,通常都会实现SqlProvider接口 ， 该接口的getSql()方法可以向JdbcTemplate类提供SQL语句的字符串。



     

public interface SqlProvider(){
       String getSql();
}


3, PreparedStatementSetter 是PreparedStatementCreator的补充，实现这个接口的类将

  接受到一个PreparedStatement ,然后负责为他设置参数

   public interface PreparedStatementSetter{
       void setValues( PreparedStatement pstm ) throws SQLException ;
   }


   我们传递个JdbcTemplate的sql参数就是通过这个接口设置到PreparedStatement中去的。



  public class MySetter implements PreparedStatementSetter{
         private Student student = null ;
         public void setStudent( Student student ){ this.student = student ; }
         public Student getStudent(){ return this.student ; }
         public void setValues( PreparedStatement pstm ) throws ....{
                     pstm.setInt( 1 , student.getId() ) ;
                     pstm.setString( 2  student.getName() ) ;
       ......
         }
  }


数据查询．
任何查询都需要通过ResultSet获得查询结果，我没只需通过一个回调接口

来告诉Spring如何处理结果集就可以了 。



public interface RowCallBackHandler{
   void processRow( ResultSet rs ) ;
}



当我们的查询需要返回多个结果的时候， 我们可以利用Spring提供的RowMappResultReader 他负责将结果集中的数据封装到一个List中，但是在使用RowMapResultReader时我们需要提供一个RowMapper接口的实现， RowMapper接口是RowMapResultReader要使用的一个工具负责把一条记录封装到一个对象中 ,



public interface RowMapper{
    public Object mapRow( ResultSet rs  ,int idx );
}


在RowMappResultReader中会循环调用RowMapper的mapRow方法，

从而获得一个List



Public List getAllPerson(){
       String sql = “select ……..  “ ;
       Object args = null ;
       List ret = null ;
ret =JdbcTemplate.query( sql , args , new RowMappResultReader( new myRowMapper ) ) ;
return ret ;
}


public class MyRowMapper implements RowMapper{
       public Object mapRow( ResultSet rs  ,int idx ){
              Person p = new Person();
              p.setName( rs.getString(1) );
              p.setAge( rs.getInt(2) )；     
              return  p ;           
       }
}


Spring中的数据访问异常体系
Spring 提供了一套分级的异常体系 。

Spring的DAO没有抛出任何与特定技术细节相关的异常。 所抛出的都是

org.springframework.dao.DataAccessException 及其子类 ，DataAccessException

是RuntimeException的子类，所以可以不被处理 ， 由于这些异常通常都是不可恢复的

所以不强制我们去处理他们 。