Spring--JdbcTemplate简介和常用API

ゝ一纸荒年。 2021-08-13 18:30 455阅读 0赞

#### JdbcTemplate简介 ####

Spring对数据库的操作在jdbc上面做了深层次的封装，使用spring的注入功能，可以把DataSource注册到JdbcTemplate之中。

JdbcTemplate位于 **spring-jdbc-4.3.0.RELEASE.jar** 中。其全限定命名为  
**org.springframework.jdbc.core.JdbcTemplate**。要使用JdbcTemlate还需一个 **spring-tx-4.3.0.RELEASE.jar** , 这个包包含了事务和异常控制。

#### JdbcTemplate主要提供以下方法： ####

##### 1. 构造方法 #####

*  **JdbcTemplate()**  
    为bean的使用构造一个新的JdbcTemplate。
 *  **JdbcTemplate(DataSource dataSource)**  
    构造一个新的JdbcTemplate，给定一个DataSource来获取连接。
 *  **JdbcTemplate(DataSource dataSource, boolean lazyInit)**  
    构造一个新的JdbcTemplate，给定一个DataSource来获取连接，可以指定是否懒加载。

##### 2. execute方法：可以用于执行任何SQL语句，一般用于执行DDL语句 #####

*  Object execute(CallableStatementCreator csc, CallableStatementCallback action)  
    执行JDBC数据访问操作，实现为处理JDBC CallableStatement的回调操作。
 *  Object execute(ConnectionCallback action)  
    执行JDBC数据访问操作，实现为在JDBC连接上进行的回调操作。
 *  Object execute(PreparedStatementCreator psc, PreparedStatementCallback action)  
    执行JDBC数据访问操作，实现为在JDBC PreparedStatement上进行的回调操作。
 *  Object execute(StatementCallback action)  
    执行JDBC数据访问操作，实现为处理JDBC语句的回调操作。
 *  **void execute(String sql)**  
    发出单个SQL执行，通常是DDL语句。
 *  Object execute(String callString, CallableStatementCallback action)  
    执行JDBC数据访问操作，实现为处理JDBC CallableStatement的回调操作。
 *  Object execute(String sql, PreparedStatementCallback action)  
    执行JDBC数据访问操作，实现为在JDBC PreparedStatement上进行的回调操作。
 *  protected Map extractOutputParameters(CallableStatement cs, List parameters)  
    从完成的存储过程中提取输出参数。
 *  protected Map extractReturnedResults(CallableStatement cs, List updateCountParameters, List resultSetParameters, int updateCount)  
    从完成的存储过程中提取返回结果集。

##### 3. query方法及queryForXXX方法：用于执行查询相关语句； #####

*  Object query(PreparedStatementCreator psc, PreparedStatementSetter pss, ResultSetExtractor rse)  
    使用预准备语句进行查询，允许PreparedStatementCreator和PreparedStatementSetter。
 *  Object query(PreparedStatementCreator psc, ResultSetExtractor rse)  
    使用预准备语句进行查询，使用ResultSetExtractor读取ResultSet。
 *  void query(PreparedStatementCreator psc, RowCallbackHandler rch)  
    使用预准备语句进行查询，使用RowCallbackHandler逐行读取ResultSet。
 *  List query(PreparedStatementCreator psc, RowMapper rowMapper)  
    使用预准备语句进行查询，通过RowMapper将每一行映射到Java对象。
 *  **Object query(String sql, Object\[\] args, int\[\] argTypes, ResultSetExtractor rse)**  
    查询给定SQL以从SQL创建预准备语句以及绑定到查询的参数列表，使用ResultSetExtractor读取ResultSet。
 *  **void query(String sql, Object\[\] args, int\[\] argTypes, RowCallbackHandler rch)**  
    查询给定SQL以从SQL创建预准备语句以及绑定到查询的参数列表，使用RowCallbackHandler以每行为基础读取ResultSet。
 *  **List query(String sql, Object\[\] args, int\[\] argTypes, RowMapper rowMapper)**  
    查询给定SQL以从SQL创建预准备语句以及绑定到查询的参数列表，通过RowMapper将每一行映射到Java对象。
 *  **Object query(String sql, Object\[\] args, ResultSetExtractor rse)**  
    查询给定SQL以从SQL创建预准备语句以及绑定到查询的参数列表，使用ResultSetExtractor读取ResultSet。
 *  **void query(String sql, Object\[\] args, RowCallbackHandler rch)**  
    查询给定SQL以从SQL创建预准备语句以及绑定到查询的参数列表，使用RowCallbackHandler以每行为基础读取ResultSet。
 *  **List query(String sql, Object\[\] args, RowMapper rowMapper)**  
    查询给定SQL以从SQL创建预准备语句以及绑定到查询的参数列表，通过RowMapper将每一行映射到Java对象。
 *  **Object query(String sql, PreparedStatementSetter pss, ResultSetExtractor rse)**  
    使用预准备语句进行查询，使用ResultSetExtractor读取ResultSet。
 *  **void query(String sql, PreparedStatementSetter pss, RowCallbackHandler rch)**  
    查询给定SQL以从SQL创建预准备语句和PreparedStatementSetter实现，该实现知道如何将值绑定到查询，使用RowCallbackHandler以每行为基础读取ResultSet。
 *  **List query(String sql, PreparedStatementSetter pss, RowMapper rowMapper)**  
    查询给定SQL以从SQL创建预准备语句和PreparedStatementSetter实现，该实现知道如何将值绑定到查询，通过RowMapper将每一行映射到Java对象。
 *  **Object query(String sql, ResultSetExtractor rse)**  
    在给定静态SQL的情况下执行查询，使用ResultSetExtractor读取ResultSet。
 *  **void query(String sql, RowCallbackHandler rch)**  
    执行给定静态SQL的查询，使用RowCallbackHandler以每行为基础读取ResultSet。
 *  **List query(String sql, RowMapper rowMapper)**  
    执行给定静态SQL的查询，通过RowMapper将每一行映射到Java对象。
 *  **int queryForInt(String sql)**  
    给定静态SQL，执行导致int值的查询。
 *  **int queryForInt(String sql, Object\[\] args)**  
    查询给定SQL以从SQL创建预准备语句以及绑定到查询的参数列表，从而生成int值。
 *  **int queryForInt(String sql, Object\[\] args, int\[\] argTypes)**  
    查询给定SQL以从SQL创建预准备语句以及绑定到查询的参数列表，从而生成int值。
 *  **List queryForList(String sql)**  
    给定静态SQL，执行结果列表的查询。
 *  **List queryForList(String sql, Class elementType)**  
    给定静态SQL，执行结果列表的查询。
 *  **List queryForList(String sql, Object\[\] args)**  
    查询给定SQL以从SQL创建预准备语句以及绑定到查询的参数列表，期望结果列表。
 *  **List queryForList(String sql, Object\[\] args, Class elementType)**  
    查询给定SQL以从SQL创建预准备语句以及绑定到查询的参数列表，期望结果列表。
 *  **List queryForList(String sql, Object\[\] args, int\[\] argTypes)**  
    查询给定SQL以从SQL创建预准备语句以及绑定到查询的参数列表，期望结果列表。
 *  **List queryForList(String sql, Object\[\] args, int\[\] argTypes, Class elementType)**  
    查询给定SQL以从SQL创建预准备语句以及绑定到查询的参数列表，期望结果列表。
 *  **long queryForLong(String sql)**  
    给定静态SQL，执行导致long值的查询。
 *  **long queryForLong(String sql, Object\[\] args)**  
    查询给定SQL以从SQL创建预准备语句以及绑定到查询的参数列表，从而产生长值。
 *  **long queryForLong(String sql, Object\[\] args, int\[\] argTypes)**  
    查询给定SQL以从SQL创建预准备语句以及绑定到查询的参数列表，从而产生长值。
 *  **Map queryForMap(String sql)**  
    给定静态SQL，执行结果Map的查询。
 *  **Map queryForMap(String sql, Object\[\] args)**  
    查询给定SQL以从SQL创建预准备语句以及绑定到查询的参数列表，期望结果Map。
 *  **Map queryForMap(String sql, Object\[\] args, int\[\] argTypes)**  
    查询给定SQL以从SQL创建预准备语句以及绑定到查询的参数列表，期望结果Map。
 *  **Object queryForObject(String sql, Class requiredType)**  
    给定静态SQL，对结果对象执行查询。
 *  **Object queryForObject(String sql, Object\[\] args, Class requiredType)**  
    查询给定SQL以从SQL创建预准备语句以及绑定到查询的参数列表，期望结果对象。
 *  **Object queryForObject(String sql, Object\[\] args, int\[\] argTypes, Class requiredType)**  
    查询给定SQL以从SQL创建预准备语句以及绑定到查询的参数列表，期望结果对象。
 *  **Object queryForObject(String sql, Object\[\] args, int\[\] argTypes, RowMapper rowMapper)**  
    查询给定SQL以从SQL创建预准备语句以及绑定到查询的参数列表，通过RowMapper将单个结果行映射到Java对象。
 *  **Object queryForObject(String sql, Object\[\] args, RowMapper rowMapper)**  
    查询给定SQL以从SQL创建预准备语句以及绑定到查询的参数列表，通过RowMapper将单个结果行映射到Java对象。
 *  **Object queryForObject(String sql, RowMapper rowMapper)**  
    执行给定静态SQL的查询，通过RowMapper将单个结果行映射到Java对象。
 *  **SqlRowSet queryForRowSet(String sql)**  
    给定静态SQL，执行SqlRowSet的查询。
 *  **SqlRowSet queryForRowSet(String sql, Object\[\] args)**  
    查询给定SQL以从SQL创建预准备语句以及绑定到查询的参数列表，期望SqlRowSet。
 *  **SqlRowSet queryForRowSet(String sql, Object\[\] args, int\[\] argTypes)**  
    查询给定SQL以从SQL创建预准备语句以及绑定到查询的参数列表，期望SqlRowSet。

##### 4. update方法及batchUpdate方法：update方法用于执行新增、修改、删除等语句；batchUpdate方法用于执行批处理相关语句 #####

*  **int update(PreparedStatementCreator psc)**  
    使用PreparedStatementCreator发出单个SQL更新操作（例如insert，update或delete语句）以提供SQL和任何必需参数。
 *  **int update(PreparedStatementCreator psc, KeyHolder generatedKeyHolder)**  
    使用PreparedStatementCreator发出更新语句，以提供SQL和任何必需的参数。
 *  \*\* protected int update(PreparedStatementCreator psc, PreparedStatementSetter pss)\*\*
 *  **int update(String sql)**  
    发出单个SQL更新操作（例如插入，更新或删除语句）。
 *  **int update(String sql, Object\[\] args)**  
    通过准备好的语句发出单个SQL更新操作（例如插入，更新或删除语句），绑定给定的参数。
 *  **int update(String sql, Object\[\] args, int\[\] argTypes)**  
    通过准备好的语句发出单个SQL更新操作（例如插入，更新或删除语句），绑定给定的参数。
 *  **int update(String sql, PreparedStatementSetter pss)**  
    使用PreparedStatementSetter发出更新语句，以使用给定的SQL设置绑定参数。