JDBCを使ってデータベースに画像を挿入・保存する方法を徹底解説

setBinaryStream()メソッドとは

PreparedStatementインターフェースが提供するsetBinaryStream()メソッドは、第1引数にパラメータのインデックス（位置）、第2引数にInputStreamオブジェクトを受け取り、指定したプレースホルダに入力ストリームの内容を設定します。画像やファイルなど、サイズの大きなバイナリデータをデータベースへ送信したい場合に、このメソッドが活躍します。

一方、SQLデータベース側にはBLOB（Binary Large Object：バイナリラージオブジェクト）というデータ型が用意されています。この型を使えば、画像のような大きなバイナリデータをそのままカラムに保存できます。

JDBCで画像を保存する基本の手順

JDBCプログラムでデータベースに画像を保存するには、まず画像を格納するためのBLOB型カラムを持つテーブルを作成します。

CREATE TABLE Tutorial(Name VARCHAR(255), Type INT NOT NULL, Logo BLOB);

次に、JDBCでデータベースに接続し、上記テーブルへ値を挿入するためのPreparedStatementを準備します。

String query = "INSERT INTO Tutorial(Name, Type, Logo) VALUES (?, ?, ?)";
PreparedStatement pstmt = con.prepareStatement(query);

プレースホルダには、PreparedStatementの各セッターメソッドで値を設定します。通常の文字列はsetString()を使い、画像などのバイナリデータ（BLOB型）にはsetBinaryStream()メソッドでファイルの入力ストリームを渡します。

FileInputStream fin = new FileInputStream("javafx_logo.jpg");
pstmt.setBinaryStream(3, fin);

サンプルコード：MySQLに画像を挿入して取得する

以下は、JDBCプログラムを使ってMySQLデータベースに画像を挿入する完全なサンプルです。BLOB型カラムを持つテーブルを作成し、setBinaryStream()で画像ファイル（BinaryStream）を挿入した後、テーブルの内容を取得して表示します。

import java.io.FileInputStream;
import java.io.FileNotFoundException;
import java.sql.Connection;
import java.sql.DriverManager;
import java.sql.PreparedStatement;
import java.sql.ResultSet;
import java.sql.SQLException;
import java.sql.Statement;
public class InsertingImageToDatabase {
    public static void main(String args[]) throws Exception {
        // ドライバの登録
        DriverManager.registerDriver(new com.mysql.jdbc.Driver());
        // データベースへの接続
        String mysqlUrl = "jdbc:mysql://localhost/sampleDB";
        Connection con = DriverManager.getConnection(mysqlUrl, "root", "password");
        System.out.println("Connection established......");
        // Statementの作成
        Statement stmt = con.createStatement();
        // BLOB型カラムを持つテーブルを作成
        String createTable = "CREATE TABLE Tutorial( "
            + "Name VARCHAR(255), "
            + "Type VARCHAR(50), "
            + "Logo BLOB)";
        stmt.execute(createTable);
        // データの挿入
        String query = "INSERT INTO Tutorial(Name, Type, Logo) VALUES (?, ?, ?)";
        PreparedStatement pstmt = con.prepareStatement(query);
        pstmt.setString(1, "JavaFX");
        pstmt.setString(2, "Java_library");
        FileInputStream fin = new FileInputStream("E:\\images\\javafx_logo.jpg");
        pstmt.setBinaryStream(3, fin);
        pstmt.execute();

        pstmt.setString(1, "CoffeeScript");
        pstmt.setString(2, "scripting Language");
        fin = new FileInputStream("E:\\images\\coffeescript_logo.jpg");
        pstmt.setBinaryStream(3, fin);
        pstmt.execute();
        pstmt.setString(1, "Cassandra");
        pstmt.setString(2, "NoSQL database");
        fin = new FileInputStream("E:\\images\\cassandra_logo.jpg");
        pstmt.setBinaryStream(3, fin);
        pstmt.execute();
        System.out.println("Data inserted");
        ResultSet rs = stmt.executeQuery("Select *from Tutorial");
        while(rs.next()) {
            System.out.print("Name: "+rs.getString("Name")+", ");
            System.out.print("Tutorial Type: "+rs.getString("Type")+", ");
            System.out.print("Logo: "+rs.getBlob("Logo"));
            System.out.println();
        }
    }
}

実行結果

Connection established......
Data inserted
Name: JavaFX, Tutorial Type: Java_library, Logo: com.mysql.jdbc.Blob@7dc5e7b4
Name: CoffeeScript, Tutorial Type: scripting Language, Logo:
com.mysql.jdbc.Blob@1ee0005
Name: Cassandra, Tutorial Type: NoSQL database, Logo: com.mysql.jdbc.Blob@75a1cd57

まとめ

このように、JDBCではBLOB型のカラムとsetBinaryStream()メソッドを組み合わせることで、画像ファイルを簡単にデータベースへ保存できます。取得時はResultSet#getBlob()を使ってBLOBデータを読み出します。

注意： JDBCプログラムで保存・取得できるのは、.gif / .jpeg / .png 形式などの画像ファイルです。対応していない形式は扱えない点に留意してください。