使用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{   //ywjy 文件下载 ，此处的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