JdbcTemplate基本存取

您可以使用JdbcTemplate的execute()方法執行SQL陳述，例如：

　代碼:

jdbcTemplate.execute("CREATE TABLE USER (user_id integer, name varchar(100))");

　　如果是UPDATE或INSERT，您可以使用update()方法，一個基本的INSERT例子是：

　代碼:

jdbcTemplate.update("INSERT INTO USER VALUES('"+ user.getId() + "', '"                + user.getName() + "', '"
                + user.getSex() + "', '"
                + user.getAge() + "')");

　　使用UPDATE時，您可以在欄位上使用 "?"，並指定參數陣列給對應的欄位，例如：

　代碼:

jdbcTemplate.update("UPDATE USER SET name = ? WHERE user_id = ?", new Object[] {name, id});

　　在上例中所給定的name與id是String物件，它會取代之前對應順序的 "?"，然後執行SQL更新。

　　使用參數陣列來指定SQL中的變量相當方便，上例中的INSERT範例也可以這麼作，減輕撰寫SQL與Java物件結合時的負擔：

　代碼:

jdbcTemplate.update("INSERT INTO USER VALUES(?, ?, ?, ?)",
                new Object[] {user.getId(), user.getName(), user.getSex(), user.getAge()});

　　使用JdbcTemplate進行查詢時，我們可以使用queryForXXX()等方法，例如下面使用queryForInt()方法傳回USER表格中的資料筆數：

　代碼:

int count = jdbcTemplate.queryForInt("SELECT COUNT(*) FROM USER");

　　您也可以使用queryForObject()傳回一個查詢後的結果物件，例如下例傳回一個String物件：

　代碼:

String name = (String) jdbcTemplate.queryForObject("SELECT name FROM USER WHERE user_id = ?", new Object[] {id}, java.lang.String.class);

　　上面兩個例子傳回的都是單一筆資料，如果傳回多筆資料，則可以使用queryForList()方法，例如：

　代碼:

List rows = jdbcTemplate.queryForList("SELECT * FROM USER");

　　傳回的List中包括的是Map物件，每個Map物件代表查詢結果中的一筆資料，每筆資料包括多個欄位內容，要取得欄位中的值，要使用欄位名稱作為key值，例如：

　代碼:

List rows = jdbcTemplate.queryForList("SELECT * FROM USER");
Iterator it = rows.iterator();
while(it.hasNext()) {
    Map userMap = (Map) it.next();
    System.out.print(userMap.get("user_id") + "\t");
    System.out.print(userMap.get("name") + "\t");
    System.out.print(userMap.get("sex") + "\t");
    System.out.println(userMap.get("age") + "\t");
}

　　事實上，JdbcTemplate只是將我們使用JDBC的流程封裝起來而已，包括了例外捕捉、SQL的執行、查詢結果的轉換與傳回等等，之前所用到的參數設定，也只是在方法中幫您作SQL語句組合的動作而已，Spring大量使用Template Method模式來封裝固定流程的動作，XXXTemplate等類別都是基於這種方式實現的。

　　除了大量使用Template Method來封裝一些低層操作細節，Spring也大量使用callback方式來呼叫相關類別之方法以提供傳統JDBC相關類別的功能，使得傳統JDBC的使用者也能清楚瞭解Spring所提供的相關封裝類別方法之使用。

　　例如JDBC的PreparedStatement，我們可以實作PreparedStatementSetter介面來提供：

　代碼:

final String id = user.getId();
final String name = user.getName();
final String sex = user.getSex() + "";
final int age = user.getAge();

jdbcTemplate.update("INSERT INTO USER VALUES(?, ?, ?, ?)",
                     new PreparedStatementSetter() {
                         public void setValues(PreparedStatement ps) throws SQLException {
                             ps.setString(1, id);
                             ps.setString(2, name);
                             ps.setString(3, sex);
                             ps.setInt(4, age);
                         }
                     });

　　您可以實作RowCallbackHandler介面，在查詢到資料之後先作一些處理再傳回，例如下面的例子實現了手動的O/R Mapping：

　代碼:

final User user = new User();
jdbcTemplate.query("SELECT * FROM USER WHERE user_id = ?",
                    new Object[] {id},
                    new RowCallbackHandler() {
                        public void processRow(ResultSet rs) throws SQLException {
                            user.setId(rs.getString("user_id"));
                            user.setName(rs.getString("name"));
                            user.setSex(rs.getString("sex").charAt(0));
                            user.setAge(rs.getInt("age"));
                        }
                    });

　　您更可以實作RowMapper介面將手動的O/R Mapping程式碼獨立撰寫，共用在不同的DAO方法之中：

　代碼:

class UserRowMapper implements RowMapper {
    public Object mapRow(ResultSet rs, int index) throws SQLException {
        User user = new User();

        user.setId(rs.getString("user_id"));
        user.setName(rs.getString("name"));
        user.setSex(rs.getString("sex").charAt(0));
        user.setAge(rs.getInt("age"));

        return user;
    }
}

　　在findAllByRowMapperResultReader()裡面使用UserRowMapper：

　代碼:

public List findAllByRowMapperResultReader() {
    String sql = "SELECT * FROM USER";

    return jdbcTemplate.query(sql, new RowMapperResultReader(new UserRowMapper()));
}

　　在getUser(id)裡面使用UserRowMapper：

　代碼:

public User getUser(final String id) throws DataAccessException {
    String sql = "SELECT * FROM USER WHERE user_id=?";
    final Object[] params = new Object[] { id };
    List list = jdbcTemplate.query(sql, params, new RowMapperResultReader(new UserRowMapper()));

    return (User) list.get(0);
}