?
本文檔使用 PHP中文網(wǎng)手冊(cè) 發(fā)布
JdbcTemplate是core包的核心類(lèi)。它替我們完成了資源的創(chuàng)建以及釋放工作，從而簡(jiǎn)化了我們對(duì)JDBC的使用。
它還可以幫助我們避免一些常見(jiàn)的錯(cuò)誤，比如忘記關(guān)閉數(shù)據(jù)庫(kù)連接。
JdbcTemplate將完成JDBC核心處理流程，比如SQL語(yǔ)句的創(chuàng)建、執(zhí)行，而把SQL語(yǔ)句的生成以及查詢(xún)結(jié)果的提取工作留給我們的應(yīng)用代碼。
它可以完成SQL查詢(xún)、更新以及調(diào)用存儲(chǔ)過(guò)程，可以對(duì)ResultSet進(jìn)行遍歷并加以提取。
它還可以捕獲JDBC異常并將其轉(zhuǎn)換成org.springframework.dao包中定義的，通用的，信息更豐富的異常。
使用JdbcTemplate進(jìn)行編碼只需要根據(jù)明確定義的一組契約來(lái)實(shí)現(xiàn)回調(diào)接口。
PreparedStatementCreator回調(diào)接口通過(guò)給定的Connection創(chuàng)建一個(gè)PreparedStatement，包含SQL和任何相關(guān)的參數(shù)。
CallableStatementCreateor實(shí)現(xiàn)同樣的處理，只不過(guò)它創(chuàng)建的是CallableStatement。
RowCallbackHandler接口則從數(shù)據(jù)集的每一行中提取值。
我們可以在DAO實(shí)現(xiàn)類(lèi)中通過(guò)傳遞一個(gè)DataSource引用來(lái)完成JdbcTemplate的實(shí)例化，也可以在Spring的IoC容器中配置一個(gè)JdbcTemplate的bean并賦予DAO實(shí)現(xiàn)類(lèi)作為一個(gè)實(shí)例。
需要注意的是DataSource在Spring的IoC容器中總是配制成一個(gè)bean，第一種情況下，DataSource bean將傳遞給service，第二種情況下DataSource bean傳遞給JdbcTemplate bean。
最后，JdbcTemplate中使用的所有SQL將會(huì)以“DEBUG”級(jí)別記入日志（一般情況下日志的category是JdbcTemplate相應(yīng)的全限定類(lèi)名，不過(guò)如果需要對(duì)JdbcTemplate進(jìn)行定制的話(huà)，可能是它的子類(lèi)名）。
下面是一些使用JdbcTemplate類(lèi)的示例。（這些示例并不是完整展示所有的JdbcTemplate所暴露出來(lái)的功能。請(qǐng)查看與之相關(guān)的Javadoc）。
一個(gè)簡(jiǎn)單的例子用于展示如何獲取一個(gè)表中的所有行數(shù)。
int rowCount = this.jdbcTemplate.queryForInt("select count(0) from t_accrual");
一個(gè)簡(jiǎn)單的例子展示如何進(jìn)行參數(shù)綁定。
int countOfActorsNamedJoe = this.jdbcTemplate.queryForInt(
"select count(0) from t_actors where first_name = ?", new Object[]{"Joe"});
查詢(xún)一個(gè)String。
String surname = (String) this.jdbcTemplate.queryForObject(
"select surname from t_actor where id = ?",
new Object[]{new Long(1212)}, String.class);
查詢(xún)并將結(jié)果記錄為一個(gè)簡(jiǎn)單的數(shù)據(jù)模型。
Actor actor = (Actor) this.jdbcTemplate.queryForObject(
"select first_name, surname from t_actor where id = ?",
new Object[]{new Long(1212)},
new RowMapper() {
public Object mapRow(ResultSet rs, int rowNum) throws SQLException {
Actor actor = new Actor();
actor.setFirstName(rs.getString("first_name"));
actor.setSurname(rs.getString("surname"));
return actor;
}
});
查詢(xún)并組裝多個(gè)數(shù)據(jù)模型。
Collection actors = this.jdbcTemplate.query(
"select first_name, surname from t_actor",
new RowMapper() {
public Object mapRow(ResultSet rs, int rowNum) throws SQLException {
Actor actor = new Actor();
actor.setFirstName(rs.getString("first_name"));
actor.setSurname(rs.getString("surname"));
return actor;
}
});
如果最后2個(gè)示例中的代碼出現(xiàn)在同一段程序中，我們有必要去掉這些重復(fù)的RowMapper匿名類(lèi)代碼，將這些代碼抽取到一個(gè)單獨(dú)的類(lèi)中（通常是一個(gè)靜態(tài)的內(nèi)部類(lèi)）。
這樣，這個(gè)內(nèi)部類(lèi)就可以在DAO的方法中被共享。因而，最后2個(gè)示例寫(xiě)成如下的形式將更加好：
public Collection findAllActors() {
return this.jdbcTemplate.query( "select first_name, surname from t_actor", new ActorMapper());
}
private static final class ActorMapper implements RowMapper {
public Object mapRow(ResultSet rs, int rowNum) throws SQLException {
Actor actor = new Actor();
actor.setFirstName(rs.getString("first_name"));
actor.setSurname(rs.getString("surname"));
return actor;
}
}
this.jdbcTemplate.update(
"insert into t_actor (first_name, surname) values (?, ?)",
new Object[] {"Leonor", "Watling"});
this.jdbcTemplate.update(
"update t_actor set weapon = ? where id = ?",
new Object[] {"Banjo", new Long(5276)});
this.jdbcTemplate.update(
"delete from actor where id = ?",
new Object[] {new Long.valueOf(actorId)});
execute(..)方法可以被用作執(zhí)行任何類(lèi)型的SQL，甚至是DDL語(yǔ)句。
這個(gè)方法的實(shí)現(xiàn)需要傳入一個(gè)回調(diào)接口、需要綁定的參數(shù)數(shù)組等作為參數(shù)。
this.jdbcTemplate.execute("create table mytable (id integer, name varchar(100))");
調(diào)用一個(gè)簡(jiǎn)單的存儲(chǔ)過(guò)程（更多復(fù)雜的存儲(chǔ)過(guò)程支持請(qǐng)參見(jiàn)存儲(chǔ)過(guò)程支持）。
this.jdbcTemplate.update(
"call SUPPORT.REFRESH_ACTORS_SUMMARY(?)",
new Object[]{Long.valueOf(unionId)});
JdbcTemplate類(lèi)的實(shí)例是線(xiàn)程安全的實(shí)例。這一點(diǎn)非常重要，正因?yàn)槿绱?，你可以配置一個(gè)簡(jiǎn)單的JdbcTemplate實(shí)例，并將這個(gè)“共享的”、“安全的”實(shí)例注入到不同的DAO類(lèi)中去。
另外， JdbcTemplate 是有狀態(tài)的，因?yàn)樗S護(hù)的DataSource 實(shí)例是有狀態(tài)的，但是這種狀態(tài)是無(wú)法變化的。
使用JdbcTemplate的一個(gè)常見(jiàn)的最佳實(shí)踐（同時(shí)也是SimpleJdbcTemplate和NamedParameterJdbcTemplate
類(lèi)的最佳實(shí)踐）就是在Spring配置文件中配置一個(gè)DataSource實(shí)例，然后將這個(gè)共享的DataSource實(shí)例助于到你的DAO中去。
而JdbcTemplate的實(shí)例將在DataSource的setter方法中被創(chuàng)建。這樣的話(huà)，DAO可能看上去像這樣：
public class JdbcCorporateEventDao implements CorporateEventDao {
private JdbcTemplate jdbcTemplate;
public void setDataSource(DataSource dataSource) {
this.jdbcTemplate = new JdbcTemplate(dataSource);
}
// JDBC-backed implementations of the methods on the CorporateEventDao follow...
}
相關(guān)的配置看上去就像這樣。
<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://www.springframework.org/schema/beans
http://www.springframework.org/schema/beans/spring-beans-2.5.xsd">
<bean id="corporateEventDao" class="com.example.JdbcCorporateEventDao">
<property name="dataSource" ref="dataSource"/>
</bean>
<!-- the DataSource (parameterized for configuration via a PropertyPlaceHolderConfigurer) -->
<bean id="dataSource" destroy-method="close" class="org.apache.commons.dbcp.BasicDataSource">
<property name="driverClassName" value="${jdbc.driverClassName}"/>
<property name="url" value="${jdbc.url}"/>
<property name="username" value="${jdbc.username}"/>
<property name="password" value="${jdbc.password}"/>
</bean>
</beans>
如果你使用Spring提供的JdbcDaoSupport類(lèi)，并且你的那些基于JDBC的DAO都繼承自這個(gè)類(lèi)，那么你會(huì)自動(dòng)地從JdbcDaoSupport類(lèi)中繼承了setDataSource(..)方法。
是否將你的DAO類(lèi)繼承自這些類(lèi)完全取決于你自己的決定，事實(shí)上這并不是必須的，如果你看一下JdbcDaoSupport類(lèi)你會(huì)發(fā)現(xiàn)，這里只是提供了一個(gè)簡(jiǎn)便的方式而已。
無(wú)論你是否使用上述這種初始化方式，都無(wú)需在執(zhí)行某些SQL操作時(shí)多次創(chuàng)建一個(gè)JdbcTemplate實(shí)例。記住，一旦JdbcTemplate被創(chuàng)建，他是一個(gè)線(xiàn)程安全的對(duì)象。
一個(gè)你需要?jiǎng)?chuàng)建多次JdbcTemplate實(shí)例的理由可能在于，你的應(yīng)用需要訪問(wèn)多個(gè)不同的數(shù)據(jù)庫(kù)，從而需要不同的DataSources來(lái)創(chuàng)建不同的JdbcTemplates實(shí)例。
NamedParameterJdbcTemplate類(lèi)為JDBC操作增加了命名參數(shù)的特性支持，而不是傳統(tǒng)的使用（'?'）作為參數(shù)的占位符。NamedParameterJdbcTemplate類(lèi)對(duì)JdbcTemplate類(lèi)進(jìn)行了封裝，
在底層，JdbcTemplate完成了多數(shù)的工作。這一個(gè)章節(jié)將主要描述NamedParameterJdbcTemplate類(lèi)與JdbcTemplate類(lèi)的一些區(qū)別，也就是使用命名參數(shù)進(jìn)行JDBC操作。
// some JDBC-backed DAO class...
private NamedParameterJdbcTemplate namedParameterJdbcTemplate;
public void setDataSource(DataSource dataSource) {
this.namedParameterJdbcTemplate = new NamedParameterJdbcTemplate(dataSource);
}
public int countOfActorsByFirstName(String firstName) {
String sql = "select count(0) from T_ACTOR where first_name = :first_name";
SqlParameterSource namedParameters = new MapSqlParameterSource("first_name", firstName);
return namedParameterJdbcTemplate.queryForInt(sql, namedParameters);
}
注意這里在'sql'中使用了命名參數(shù)作為變量，而這個(gè)名稱(chēng)所對(duì)應(yīng)的值被定義在傳入的'namedParameters'
中作為參數(shù)（也可以傳入到MapSqlParameterSource中作為參數(shù)）。
你也可以傳入許多命名參數(shù)以及他們所對(duì)應(yīng)的值，以Map的方式，作為鍵值對(duì)傳入到NamedParameterJdbcTemplate中。
（其余的被NamedParameterJdbcOperations所暴露的接口以及NamedParameterJdbcTemplate實(shí)現(xiàn)類(lèi)遵循了類(lèi)似的方式，此處不包含相關(guān)內(nèi)容）。
// some JDBC-backed DAO class...
private NamedParameterJdbcTemplate namedParameterJdbcTemplate;
public void setDataSource(DataSource dataSource) {
this.namedParameterJdbcTemplate = new NamedParameterJdbcTemplate(dataSource);
}
public int countOfActorsByFirstName(String firstName) {
String sql = "select count(0) from T_ACTOR where first_name = :first_name";
Map namedParameters = Collections.singletonMap("first_name", firstName);
return this.namedParameterJdbcTemplate.queryForInt(sql, namedParameters);
}
NamedParameterJdbcTemplate類(lèi)所具備的另外一個(gè)比較好的特性就是可以接收SqlParameterSource作為傳入?yún)?shù) (這個(gè)類(lèi)位于相同的包定義中)。
你已經(jīng)在先前的一個(gè)例子中看到了這個(gè)接口的一個(gè)具體實(shí)現(xiàn)類(lèi)。（
MapSqlParameterSource類(lèi)）。而SqlParameterSource
這個(gè)接口對(duì)于NamedParameterJdbcTemplate類(lèi)的操作而言是一個(gè)傳入的參數(shù)。MapSqlParameterSource只是一個(gè)非常簡(jiǎn)單的實(shí)現(xiàn)，使用了java.util.Map作為轉(zhuǎn)接器，
其中，Map中的Key表示參數(shù)名稱(chēng)，而Map中的Value表示參數(shù)值。
另外一個(gè)SqlParameterSource
的實(shí)現(xiàn)類(lèi)是BeanPropertySqlParameterSource。這個(gè)類(lèi)對(duì)傳統(tǒng)的Java進(jìn)行了封裝（也就是那些符合JavaBean標(biāo)準(zhǔn)的類(lèi)），
并且使用了JavaBean的屬性作為參數(shù)的名稱(chēng)和值。
public class Actor {
private Long id;
private String firstName;
private String lastName;
public String getFirstName() {
return this.firstName;
}
public String getLastName() {
return this.lastName;
}
public Long getId() {
return this.id;
}
// setters omitted...
}
// some JDBC-backed DAO class...
private NamedParameterJdbcTemplate namedParameterJdbcTemplate;
public void setDataSource(DataSource dataSource) {
this.namedParameterJdbcTemplate = new NamedParameterJdbcTemplate(dataSource);
}
public int countOfActors(Actor exampleActor) {
// notice how the named parameters match the properties of the above 'Actor' class
String sql = "select count(0) from T_ACTOR where first_name = :firstName and last_name = :lastName";
SqlParameterSource namedParameters = new BeanPropertySqlParameterSource(exampleActor);
return this.namedParameterJdbcTemplate.queryForInt(sql, namedParameters);
}
注意，NamedParameterJdbcTemplate類(lèi)只是封裝了JdbcTemplate模板；
因而如果你需要訪問(wèn)相應(yīng)被封裝的JdbcTemplate類(lèi)，并訪問(wèn)一些只有在JdbcTemplate中擁有的功能，你需要使用getJdbcOperations()方法來(lái)進(jìn)行訪問(wèn)。
請(qǐng)參照第?11.2.1.2?節(jié) “JdbcTemplate 的最佳實(shí)踐”來(lái)獲取一些使用NamedParameterJdbcTemplate的最佳實(shí)踐。
注意
SimpleJdbcTemplate所提供的一些特性必須工作在Java 5及以上版本。
SimpleJdbcTemplate類(lèi)是對(duì)JdbcTemplate類(lèi)進(jìn)行的封裝，從而可以充分利用Java 5所帶來(lái)的varargs和autoboxing等特性。
SimpleJdbcTemplate類(lèi)完全利用了Java 5語(yǔ)法所帶來(lái)的蜜糖效應(yīng)。凡是使用過(guò)Java 5的程序員們?nèi)绻獜腏ava 5遷移回之前的JDK版本，無(wú)疑會(huì)發(fā)現(xiàn)這些特性所帶來(lái)的蜜糖效應(yīng)。
“before and after”示例可以成為SimpleJdbcTemplate類(lèi)所帶來(lái)的蜜糖效應(yīng)的最佳詮釋。
下面的代碼示例首先展示了使用傳統(tǒng)的JdbcTemplate進(jìn)行JDBC訪問(wèn)的代碼，接著是使用SimpleJdbcTemplate類(lèi)做同樣的事情。
// classic JdbcTemplate-style...
private JdbcTemplate jdbcTemplate;
public void setDataSource(DataSource dataSource) {
this.jdbcTemplate = new JdbcTemplate(dataSource);
}
public Actor findActor(long id) {
String sql = "select id, first_name, last_name from T_ACTOR where id = ?";
RowMapper mapper = new RowMapper() {
public Object mapRow(ResultSet rs, int rowNum) throws SQLException {
Actor actor = new Actor();
actor.setId(rs.getLong("id"));
actor.setFirstName(rs.getString("first_name"));
actor.setLastName(rs.getString("last_name"));
return actor;
}
};
// notice the cast, the wrapping up of the 'id' argument
// in an array, and the boxing of the 'id' argument as a reference type
return (Actor) jdbcTemplate.queryForObject(sql, mapper, new Object[] {Long.valueOf(id)});
}
下面是同樣的邏輯，使用了SimpleJdbcTemplate；可以看到代碼“干凈”多了：
// SimpleJdbcTemplate-style...
private SimpleJdbcTemplate simpleJdbcTemplate;
public void setDataSource(DataSource dataSource) {
this.simpleJdbcTemplate = new SimpleJdbcTemplate(dataSource);
}
public Actor findActor(long id) {
String sql = "select id, first_name, last_name from T_ACTOR where id = ?";
ParameterizedRowMapper<Actor> mapper = new ParameterizedRowMapper<Actor>() {
// notice the return type with respect to Java 5 covariant return types
public Actor mapRow(ResultSet rs, int rowNum) throws SQLException {
Actor actor = new Actor();
actor.setId(rs.getLong("id"));
actor.setFirstName(rs.getString("first_name"));
actor.setLastName(rs.getString("last_name"));
return actor;
}
};
return this.simpleJdbcTemplate.queryForObject(sql, mapper, id);
}
請(qǐng)同樣參照第?11.2.1.2?節(jié) “JdbcTemplate 的最佳實(shí)踐”來(lái)獲取一些SimpleJdbcTemplate的最佳實(shí)踐
注意
SimpleJdbcTemplate只是提供了JdbcTemplate所提供的功能的子類(lèi)。
如果你需要使用JdbcTemplate的方法，而這些方法又沒(méi)有在SimpleJdbcTemplate中定義，你需要調(diào)用getJdbcOperations()方法
獲取相應(yīng)的方法調(diào)用。JdbcOperations接口中定義的方法需要在這邊做強(qiáng)制轉(zhuǎn)化才能使用。
為了從數(shù)據(jù)庫(kù)中取得數(shù)據(jù)，我們首先需要獲取一個(gè)數(shù)據(jù)庫(kù)連接。Spring通過(guò)DataSource對(duì)象來(lái)完成這個(gè)工作。
DataSource是JDBC規(guī)范的一部分，它被視為一個(gè)通用的數(shù)據(jù)庫(kù)連接工廠。通過(guò)使用DataSource，
Container或Framework可以將連接池以及事務(wù)管理的細(xì)節(jié)從應(yīng)用代碼中分離出來(lái)。
作為一個(gè)開(kāi)發(fā)人員，在開(kāi)發(fā)和測(cè)試產(chǎn)品的過(guò)程中，你可能需要知道連接數(shù)據(jù)庫(kù)的細(xì)節(jié)。但在產(chǎn)品實(shí)施時(shí)，你不需要知道這些細(xì)節(jié)。通常數(shù)據(jù)庫(kù)管理員會(huì)幫你設(shè)置好數(shù)據(jù)源。
在使用Spring JDBC時(shí)，你既可以通過(guò)JNDI獲得數(shù)據(jù)源，也可以自行配置數(shù)據(jù)源（使用Spring提供的DataSource實(shí)現(xiàn)類(lèi)）。使用后者可以更方便的脫離Web容器來(lái)進(jìn)行單元測(cè)試。
這里我們將使用DriverManagerDataSource，不過(guò)DataSource有多種實(shí)現(xiàn)，
后面我們會(huì)講到。使用DriverManagerDataSource和你以前獲取一個(gè)JDBC連接
的做法沒(méi)什么兩樣。你首先必須指定JDBC驅(qū)動(dòng)程序的全限定名，這樣DriverManager
才能加載JDBC驅(qū)動(dòng)類(lèi)，接著你必須提供一個(gè)url（因JDBC驅(qū)動(dòng)而異，為了保證設(shè)置正確請(qǐng)參考相關(guān)JDBC驅(qū)動(dòng)的文檔），
最后你必須提供一個(gè)用戶(hù)連接數(shù)據(jù)庫(kù)的用戶(hù)名和密碼。下面我們將通過(guò)一個(gè)例子來(lái)說(shuō)明如何配置一個(gè)DriverManagerDataSource：
DriverManagerDataSource dataSource = new DriverManagerDataSource();
dataSource.setDriverClassName("org.hsqldb.jdbcDriver");
dataSource.setUrl("jdbc:hsqldb:hsql://localhost:");
dataSource.setUsername("sa");
dataSource.setPassword("");
SQLExceptionTranslator是一個(gè)接口，如果你需要在
SQLException和org.springframework.dao.DataAccessException之間作轉(zhuǎn)換，那么必須實(shí)現(xiàn)該接口。
轉(zhuǎn)換器類(lèi)的實(shí)現(xiàn)可以采用一般通用的做法(比如使用JDBC的SQLState code)，如果為了使轉(zhuǎn)換更準(zhǔn)確，也可以進(jìn)行定制（比如使用Oracle的error code）。
SQLErrorCodeSQLExceptionTranslator是SQLExceptionTranslator的默認(rèn)實(shí)現(xiàn)。
該實(shí)現(xiàn)使用指定數(shù)據(jù)庫(kù)廠商的error code，比采用SQLState更精確。轉(zhuǎn)換過(guò)程基于一個(gè)JavaBean（類(lèi)型為SQLErrorCodes）中的error code。
這個(gè)JavaBean由SQLErrorCodesFactory工廠類(lèi)創(chuàng)建，其中的內(nèi)容來(lái)自于
“sql-error-codes.xml”配置文件。該文件中的數(shù)據(jù)庫(kù)廠商代碼基于 Database MetaData 信息中的DatabaseProductName，從而配合當(dāng)前數(shù)據(jù)庫(kù)的使用。
SQLErrorCodeSQLExceptionTranslator使用以下的匹配規(guī)則：
首先檢查是否存在完成定制轉(zhuǎn)換的子類(lèi)實(shí)現(xiàn)。通常
SQLErrorCodeSQLExceptionTranslator這個(gè)類(lèi)可以作為一個(gè)具體類(lèi)使用，不需要進(jìn)行定制，那么這個(gè)規(guī)則將不適用。接著將SQLException的error code與錯(cuò)誤代碼集中的error code進(jìn)行匹配。 默認(rèn)情況下錯(cuò)誤代碼集將從
SQLErrorCodesFactory取得。 錯(cuò)誤代碼集來(lái)自classpath下的sql-error-codes.xml文件，它們將與數(shù)據(jù)庫(kù)metadata信息中的database name進(jìn)行映射。使用fallback翻譯器。
SQLStateSQLExceptionTranslator類(lèi)是缺省的fallback翻譯器。
SQLErrorCodeSQLExceptionTranslator可以采用下面的方式進(jìn)行擴(kuò)展：
public class MySQLErrorCodesTranslator extends SQLErrorCodeSQLExceptionTranslator {
protected DataAccessException customTranslate(String task, String sql, SQLException sqlex) {
if (sqlex.getErrorCode() == -12345) {
return new DeadlockLoserDataAccessException(task, sqlex);
}
return null;
}
}
在上面的這個(gè)例子中，error code為'-12345'的SQLException將采用該轉(zhuǎn)換器進(jìn)行轉(zhuǎn)換，而其他的error code將由默認(rèn)的轉(zhuǎn)換器進(jìn)行轉(zhuǎn)換。
為了使用該轉(zhuǎn)換器，必須將其作為參數(shù)傳遞給JdbcTemplate類(lèi)的setExceptionTranslator方法，并在需要使用這個(gè)轉(zhuǎn)換器器的數(shù)據(jù)
存取操作中使用該JdbcTemplate。下面的例子演示了如何使用該定制轉(zhuǎn)換器：
// create aJdbcTemplateand set data source JdbcTemplate jt = new JdbcTemplate(); jt.setDataSource(dataSource); // create a custom translator and set theDataSourcefor the default translation lookup MySQLErrorCodesTransalator tr = new MySQLErrorCodesTransalator(); tr.setDataSource(dataSource); jt.setExceptionTranslator(tr); // use theJdbcTemplatefor thisSqlUpdateSqlUpdate su = new SqlUpdate(); su.setJdbcTemplate(jt); su.setSql("update orders set shipping_charge = shipping_charge * 1.05"); su.compile(); su.update();
在上面的定制轉(zhuǎn)換器中，我們給它注入了一個(gè)數(shù)據(jù)源，因?yàn)槲覀內(nèi)匀恍枰? 使用默認(rèn)的轉(zhuǎn)換器從sql-error-codes.xml中獲取錯(cuò)誤代碼集。
我們僅需要非常少的代碼就可以達(dá)到執(zhí)行SQL語(yǔ)句的目的，一旦獲得一個(gè)
DataSource和一個(gè)JdbcTemplate，
我們就可以使用JdbcTemplate提供的豐富功能實(shí)現(xiàn)我們的操作。下面的例子使用了極少的代碼完成創(chuàng)建一張表的工作。
import javax.sql.DataSource;
import org.springframework.jdbc.core.JdbcTemplate;
public class ExecuteAStatement {
private JdbcTemplate jdbcTemplate;
public void setDataSource(DataSource dataSource) {
this.jdbcTemplate = new JdbcTemplate(dataSource);
}
public void doExecute() {
this.jdbcTemplate.execute("create table mytable (id integer, name varchar(100))");
}
}
除了execute方法之外，JdbcTemplate還提供了大量的查詢(xún)方法。
在這些查詢(xún)方法中，有很大一部分是用來(lái)查詢(xún)單值的。比如返回一個(gè)匯總（count）結(jié)果
或者從返回行結(jié)果中取得指定列的值。這時(shí)我們可以使用queryForInt(..)、
queryForLong(..)或者queryForObject(..)方法。
queryForObject方法用來(lái)將返回的JDBC類(lèi)型對(duì)象轉(zhuǎn)換成指定的Java對(duì)象，如果類(lèi)型轉(zhuǎn)換失敗將拋出
InvalidDataAccessApiUsageException異常。
下面的例子演示了兩個(gè)查詢(xún)的用法，一個(gè)返回int值，另一個(gè)返回String。
import javax.sql.DataSource;
import org.springframework.jdbc.core.JdbcTemplate;
public class RunAQuery {
private JdbcTemplate jdbcTemplate;
public void setDataSource(DataSource dataSource) {
this.jdbcTemplate = new JdbcTemplate(dataSource);
}
public int getCount() {
return this.jdbcTemplate.queryForInt("select count(*) from mytable");
}
public String getName() {
return (String) this.jdbcTemplate.queryForObject("select name from mytable", String.class);
}
public void setDataSource(DataSource dataSource) {
this.dataSource = dataSource;
}
}
除了返回單值的查詢(xún)方法，JdbcTemplate還提供了一組返回List結(jié)果
的方法。List中的每一項(xiàng)對(duì)應(yīng)查詢(xún)返回結(jié)果中的一行。其中最簡(jiǎn)單的是queryForList方法，
該方法將返回一個(gè)List，該List中的每一條
記錄是一個(gè)Map對(duì)象，對(duì)應(yīng)應(yīng)數(shù)據(jù)庫(kù)中某一行；而該Map
中的每一項(xiàng)對(duì)應(yīng)該數(shù)據(jù)庫(kù)行中的某一列值。下面的代碼片斷接著上面的例子演示了如何用該方法返回表中所有記錄：
private JdbcTemplate jdbcTemplate;
public void setDataSource(DataSource dataSource) {
this.jdbcTemplate = new JdbcTemplate(dataSource);
}
public List getList() {
return this.jdbcTemplate.queryForList("select * from mytable");
}
返回的結(jié)果集類(lèi)似下面這種形式：
[{name=Bob, id=1}, {name=Mary, id=2}]
JdbcTemplate還提供了一些更新數(shù)據(jù)庫(kù)的方法。
在下面的例子中，我們根據(jù)給定的主鍵值對(duì)指定的列進(jìn)行更新。
例子中的SQL語(yǔ)句中使用了“?”占位符來(lái)接受參數(shù)（這種做法在更新和查詢(xún)SQL語(yǔ)句中很常見(jiàn)）。
傳遞的參數(shù)值位于一個(gè)對(duì)象數(shù)組中（基本類(lèi)型需要被包裝成其對(duì)應(yīng)的對(duì)象類(lèi)型）。
import javax.sql.DataSource;
import org.springframework.jdbc.core.JdbcTemplate;
public class ExecuteAnUpdate {
private JdbcTemplate jdbcTemplate;
public void setDataSource(DataSource dataSource) {
this.jdbcTemplate = new JdbcTemplate(dataSource);
}
public void setName(int id, String name) {
this.jdbcTemplate.update(
"update mytable set name = ? where id = ?",
new Object[] {name, new Integer(id)});
}
}
JdbcTemplate中有一個(gè)update方法，可以方便地從數(shù)據(jù)庫(kù)中獲取數(shù)據(jù)庫(kù)自動(dòng)創(chuàng)建的主鍵。（這是JDBC 3.0的標(biāo)準(zhǔn) - 可以參見(jiàn)13.6節(jié)獲取詳細(xì)信息）。
這個(gè)方法使用了PreparedStatementCreator接口作為第一個(gè)參數(shù)， 可以通過(guò)這個(gè)接口的實(shí)現(xiàn)類(lèi)來(lái)定義相應(yīng)的Insert語(yǔ)句。另外一個(gè)參數(shù)是KeyHolder，
一旦update方法成功，這個(gè)參數(shù)將包含生成的主鍵。這里對(duì)于創(chuàng)建合適的PreparedStatement并沒(méi)有一個(gè)統(tǒng)一的標(biāo)準(zhǔn)。（這也解釋了函數(shù)簽名如此定義的原因）。下面是一個(gè)在Oracle上運(yùn)行良好的示例，它可能在其他平臺(tái)上無(wú)法工作：
final String INSERT_SQL = "insert into my_test (name) values(?)";
final String name = "Rob";
KeyHolder keyHolder = new GeneratedKeyHolder();
jdbcTemplate.update(
new PreparedStatementCreator() {
public PreparedStatement createPreparedStatement(Connection connection) throws SQLException {
PreparedStatement ps =
connection.prepareStatement(INSERT_SQL, new String[] {"id"});
ps.setString(1, name);
return ps;
}
},
keyHolder);
// keyHolder.getKey() now contains the generated key