Spring BootでのSqlLobValueの備忘録

Spring Bootを勉強するためにアプリケーションを開発している中で、BlobやClobに関するデータベース操作に苦戦しました。その過程で、大容量データ（画像や長文テキストなど）をデータベースに格納する際に便利なSqlLobValueクラスを知り、その活用方法を学びました。本記事では、SqlLobValueの基本的な仕組み、具体的な使用例、そして注意点について解説します。

SqlLobValueの概要

SqlLobValueは、Spring JDBCでLob（Large Object）データ型を簡単に操作できるようにするためのクラスです。Lobは通常、以下のようなデータを格納するために使用されます：

データ型	内容	主な用途
CLOB	長文テキストや大量の文字列データ	ブログ記事、メモ、大規模テキストデータの保存
BLOB	画像、音声、PDFなどのバイナリデータ	画像ファイル、動画、音声データの保存

SqlLobValueを利用すると、java.sql.Clobやjava.sql.Blobの操作を簡素化でき、以下のメリットがあります。
・Lobデータの安全な管理：直接的なJDBC操作の複雑さを軽減。
・汎用性の高いデータ操作：JdbcTemplateやSimpleJdbcInsertと連携して利用可能。

CLOB/BLOBデータの取り扱い

1.ファイルの保存
ユーザーがアップロードした画像やPDFファイルなどをデータベースに保存する。

2.大きなテキストデータの保存
ブログ記事や長文メモなど、CLOBタイプのテキストデータを格納する。

3.ストリーミングデータの取り扱い
音声や動画などのデータをストリーム形式で処理し、データベースに保存する。

4.サンプルコード
① CLOBデータの挿入（テキストデータ）

import org.springframework.jdbc.core.JdbcTemplate;
import org.springframework.jdbc.support.lob.SqlLobValue;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Service;
import java.sql.Types;

@Service
public class ContentService {

    @Autowired
    private JdbcTemplate jdbcTemplate;

    public void saveTextContent(String textContent) {
        // CLOBデータをSqlLobValueでラップ
        SqlLobValue lobValue = new SqlLobValue(textContent);
        
        // SQL文の実行
        String sql = "INSERT INTO contents (content) VALUES (?)";
        jdbcTemplate.update(sql, lobValue, Types.CLOB);
    }
}

このコードでは、文字列データをSqlLobValueでラップし、JdbcTemplateを使ってデータベースに挿入しています。

② BLOBデータの挿入（バイナリデータ）

import org.springframework.jdbc.core.JdbcTemplate;
import org.springframework.jdbc.support.lob.SqlLobValue;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Service;
import java.io.File;
import java.nio.file.Files;
import java.sql.Types;

@Service
public class ImageService {

    @Autowired
    private JdbcTemplate jdbcTemplate;

    public void saveImageFile(String imageFilePath) throws Exception {
        // ファイルを読み込んでバイナリデータに変換
        File file = new File(imageFilePath);
        byte[] fileContent = Files.readAllBytes(file.toPath());

        // BLOBデータをSqlLobValueでラップ
        SqlLobValue lobValue = new SqlLobValue(fileContent);
        
        // SQL文の実行
        String sql = "INSERT INTO images (image_data) VALUES (?)";
        jdbcTemplate.update(sql, lobValue, Types.BLOB);
    }
}

バイナリデータも同様に、SqlLobValueを利用して効率的に格納できます。

まとめ

SqlLobValueは、Spring BootでLobデータ（BLOBやCLOB）を効率的に操作するために非常に便利なクラスです。ただし、情報が少なく、利用方法を調べるのに手間取ることもあります。本記事が、その参考として役立てば幸いです。ぜひ、開発に活用してみてください！