使用Spring JdbcTemplate實現CLOB和BLOB的存取

概述

本文講述通過Spring的JdbcTemplate來讀寫數據庫大字段的實現方案，在一位網友的一篇博客的基礎上，查看api文檔整理而成。

寫實現

JdbcTemplate jdbcTemplate = new JdbcTemplate(dataSource);  // reusable object
 LobHandler lobHandler = new DefaultLobHandler();  // reusable object

 jdbcTemplate.execute(
     "INSERT INTO imagedb (image_name, content, description) VALUES (?, ?, ?)",
     new AbstractLobCreatingPreparedStatementCallback(lobHandler) {
       protected void setValues(PreparedStatement ps, LobCreator lobCreator) throws SQLException {
         ps.setString(1, name);
         lobCreator.setBlobAsBinaryStream(ps, 2, contentStream, contentLength);
         lobCreator.setClobAsString(ps, 3, description);
       }
     }
 );

類介紹

以下內容不求精准，加入了自己的理解和猜測，勿作學術用。

• JdbcTemplate
  負責翻譯，向JDBC接口提供可執行的指令
• AbstractLobCreatingPreparedStatementCallBack
  負責提供參數設置的方法模板，並提供LobCreator實例
• LobHandler
  負責提供LobCreator - AbstractLobCreatingPreparedStatementCallBack借助於它來提供LobCreator
• LobCreator
  負責簡化大字段的寫入庫

LobCreator API

LobCreator提供了多個接口來簡化大字段的寫入：對於BLOB，內容來源可以是InputStream、byte[]；對於CLOB，內容來源可以是InputStream（自行確保都是ascii字符）、Reader、String。

讀實現

JdbcTemplate jdbcTemplate = new JdbcTemplate(dataSource);  // reusable object
 final LobHandler lobHandler = new DefaultLobHandler();  // reusable object

 jdbcTemplate.query(
                 "SELECT content FROM imagedb WHERE image_name=?", new Object[] {name},
                 new AbstractLobStreamingResultSetExtractor() {
                         public void streamData(ResultSet rs) throws SQLException, IOException {
                                 FileCopyUtils.copy(lobHandler.getBlobAsBinaryStream(rs, 1), contentStream);
                         }
                 }
 );

批量讀取

上述實現僅僅針對一條記錄的讀取，如果要讀取多條記錄，需要注意ResultSet實例已經指向了第一條記錄（上述代碼也沒有調用rs.next()），可參考實現：

public List<DFCL> batchRead(String sql, final String colNameFileName,
        final String colNameFileContent) {
    JdbcTemplate jt = JdbcService.getInstance().getJdbcTemplate();
     
    final LobHandler lobHandler = new DefaultLobHandler();
    final List<DFCL> dfclList = new ArrayList<DFCL>();
    jt.query(sql, new AbstractLobStreamingResultSetExtractor() {
        protected void streamData(ResultSet rs) throws SQLException,
                IOException, DataAccessException {
            do{   //SINOBEST 文件下載 ，此處的rs初始化時已經指向第一條記錄  
                String name = rs.getString(colNameFileName);
                String content = lobHandler.getClobAsString(rs, colNameFileContent);
                
                DFCL cl = new DFCL(name, content);
                dfclList.add(cl);
            }while(rs.next());  
        }
    });
    return dfclList;
}

類介紹

以下內容不求精准，加入了自己的理解和猜測，勿作學術用。

• JdbcTemplate
  同上
• AbstractLobStreamingResultSetExtractor
  提供解析數據的方法模板，並提供ResultSet對象實例
• LobHandler
  簡化大字段的讀取
• FileCopyUtils
  spring提供的工具類，簡化文件內容的傳輸

LobHandler API

LobHandler提供了多個接口來簡化大字段的讀入：對於BLOB，可以讀為InputStream、byte[]；對於CLOB，可以讀為InputStream、Reader、String。和LobCreator的寫入簡化是對應的。

FileCopyUtils API