Spring JDBCとは？データベース操作を楽にする便利な仕組みを徹底解説

Javaでデータベースを扱うプログラムを書いたことはありますか？

従来のJDBC（Java Database Connectivity）を使うと、たくさんのコードを書かないといけなくて、正直面倒ですよね。接続を開いて、SQLを実行して、結果を取得して、例外処理をして、最後に接続を閉じて…この繰り返しです。

そんな煩わしさから解放してくれるのが「Spring JDBC」です。

今回は、Javaプログラマーなら知っておきたいSpring JDBCについて、初心者の方にも分かりやすく解説していきます。

スポンサーリンク

Spring JDBCとは？

Spring JDBCは、Javaのデータベースアクセスを簡単にするための仕組みです。

SpringフレームワークというJavaの開発フレームワークの一部として提供されています。

もう少し具体的に言うと、Spring JDBCは従来のJDBCを使いやすくラップした（包み込んだ）技術です。面倒な作業を自動で行ってくれるので、プログラマーは本当に必要な部分だけに集中できます。

JDBC（Java Database Connectivity）とは、JavaからデータベースにアクセスするためのJava標準の技術です。しかし、そのままでは使いにくいという問題がありました。

なぜSpring JDBCが必要なのか

従来のJDBCの問題点

まず、従来のJDBCがどれだけ面倒なのか見てみましょう。

ユーザー情報を1件取得するだけでも、こんなに長いコードが必要でした。

Connection conn = null;
PreparedStatement stmt = null;
ResultSet rs = null;

try {
    // データベース接続
    conn = DriverManager.getConnection("jdbc:mysql://localhost/mydb", "user", "pass");

    // SQL文の準備
    stmt = conn.prepareStatement("SELECT * FROM users WHERE id = ?");
    stmt.setInt(1, 1);

    // 実行
    rs = stmt.executeQuery();

    // 結果の取得
    if (rs.next()) {
        String name = rs.getString("name");
        int age = rs.getInt("age");
        // 処理...
    }

} catch (SQLException e) {
    e.printStackTrace();
} finally {
    // リソースのクローズ
    try {
        if (rs != null) rs.close();
        if (stmt != null) stmt.close();
        if (conn != null) conn.close();
    } catch (SQLException e) {
        e.printStackTrace();
    }
}

見ただけで頭が痛くなりそうですね。

やりたいことは「データを1件取得する」だけなのに、接続の管理や例外処理で大量のコードが必要です。しかも、リソースを正しく閉じないとメモリリークの原因にもなります。

Spring JDBCでスッキリ解決

同じ処理をSpring JDBCで書くと、こんなに短くなります。

String sql = "SELECT * FROM users WHERE id = ?";
User user = jdbcTemplate.queryForObject(sql, new Object[]{1}, 
    (rs, rowNum) -> new User(
        rs.getString("name"),
        rs.getInt("age")
    )
);

たったこれだけです！

接続の開閉や例外処理は、Spring JDBCが自動的に行ってくれます。プログラマーは「どんなSQL文を実行するか」と「結果をどう扱うか」だけを書けば良いのです。

Spring JDBCの中心的存在：JdbcTemplate

Spring JDBCの核となるのが「JdbcTemplate」というクラスです。

JdbcTemplateは、データベース操作のためのメソッドをたくさん用意してくれているクラスです。これを使えば、面倒な処理をすべて任せられます。

JdbcTemplateの主な役割

JdbcTemplateは以下のような面倒な作業を自動で行ってくれます。

リソース管理
データベース接続、ステートメント、結果セットの開閉を自動で行います。閉じ忘れの心配がありません。

例外処理の変換
JDBCの検査例外（SQLException）を、Springの非検査例外に変換してくれます。try-catchを書く量が減ります。

SQL実行の簡素化
様々なSQL文（SELECT、INSERT、UPDATE、DELETE）を簡単に実行できるメソッドが用意されています。

パラメータの設定
プリペアドステートメントのパラメータ設定も、配列やMapで簡単に指定できます。

JdbcTemplateの基本的な使い方

JdbcTemplateを使った基本的な操作方法を見ていきましょう。

セットアップ

まず、JdbcTemplateのインスタンスを作成します。

import org.springframework.jdbc.core.JdbcTemplate;
import javax.sql.DataSource;

public class UserDao {
    private JdbcTemplate jdbcTemplate;

    public UserDao(DataSource dataSource) {
        this.jdbcTemplate = new JdbcTemplate(dataSource);
    }
}

DataSourceは、データベース接続情報を管理するオブジェクトです。Springの設定ファイルで定義しておけば、自動的に注入されます。

データの取得（SELECT）

単一行の取得

1件のデータを取得する場合は、queryForObjectメソッドを使います。

public User findById(int id) {
    String sql = "SELECT * FROM users WHERE id = ?";

    return jdbcTemplate.queryForObject(sql, new Object[]{id},
        (rs, rowNum) -> new User(
            rs.getInt("id"),
            rs.getString("name"),
            rs.getInt("age"),
            rs.getString("email")
        )
    );
}

最後の部分は「RowMapper」と呼ばれる仕組みで、データベースの1行をJavaオブジェクトに変換する処理を書いています。

複数行の取得

複数件のデータを取得する場合は、queryメソッドを使います。

public List<User> findAll() {
    String sql = "SELECT * FROM users";

    return jdbcTemplate.query(sql,
        (rs, rowNum) -> new User(
            rs.getInt("id"),
            rs.getString("name"),
            rs.getInt("age"),
            rs.getString("email")
        )
    );
}

結果はリストとして返されます。

単一の値の取得

カウントや合計など、1つの値だけを取得する場合は、型を指定したqueryForObjectを使います。

public int countUsers() {
    String sql = "SELECT COUNT(*) FROM users";
    return jdbcTemplate.queryForObject(sql, Integer.class);
}

データの追加（INSERT）

新しいデータを追加する場合は、updateメソッドを使います。

public int insertUser(User user) {
    String sql = "INSERT INTO users (name, age, email) VALUES (?, ?, ?)";

    return jdbcTemplate.update(sql, 
        user.getName(),
        user.getAge(),
        user.getEmail()
    );
}

updateメソッドは、影響を受けた行数を返します。

データの更新（UPDATE）

既存のデータを更新する場合も、updateメソッドを使います。

public int updateUser(User user) {
    String sql = "UPDATE users SET name = ?, age = ?, email = ? WHERE id = ?";

    return jdbcTemplate.update(sql,
        user.getName(),
        user.getAge(),
        user.getEmail(),
        user.getId()
    );
}

データの削除（DELETE）

データを削除する場合も、同じくupdateメソッドです。

public int deleteUser(int id) {
    String sql = "DELETE FROM users WHERE id = ?";
    return jdbcTemplate.update(sql, id);
}

INSERTもUPDATEもDELETEも、すべてupdateという同じメソッド名なんですね。

NamedParameterJdbcTemplate

JdbcTemplateには兄弟分の「NamedParameterJdbcTemplate」というクラスもあります。

これは、パラメータに名前を付けられるバージョンです。

通常のJdbcTemplateとの違い

通常のJdbcTemplateでは、パラメータを「?」で指定し、順番通りに値を渡す必要がありました。

String sql = "SELECT * FROM users WHERE name = ? AND age = ?";
jdbcTemplate.queryForObject(sql, new Object[]{"田中", 25}, ...);

パラメータが増えると、順番を間違えやすくなります。

NamedParameterJdbcTemplateなら、名前を付けられるので分かりやすくなります。

String sql = "SELECT * FROM users WHERE name = :name AND age = :age";

Map<String, Object> params = new HashMap<>();
params.put("name", "田中");
params.put("age", 25);

namedParameterJdbcTemplate.queryForObject(sql, params, ...);

「:name」「:age」のように、パラメータに名前を付けています。順番を気にする必要がなくなるので、コードが読みやすくなります。

MapSqlParameterSourceの活用

より便利な書き方として、MapSqlParameterSourceというクラスも使えます。

String sql = "INSERT INTO users (name, age, email) VALUES (:name, :age, :email)";

MapSqlParameterSource params = new MapSqlParameterSource()
    .addValue("name", "佐藤")
    .addValue("age", 30)
    .addValue("email", "sato@example.com");

namedParameterJdbcTemplate.update(sql, params);

メソッドチェーンで書けるので、さらに見やすくなります。

バッチ処理

大量のデータを一度に処理する場合は、バッチ処理が便利です。

batchUpdateメソッド

複数のINSERTやUPDATEを一度に実行する場合に使います。

public int[] insertUsers(List<User> users) {
    String sql = "INSERT INTO users (name, age, email) VALUES (?, ?, ?)";

    List<Object[]> batchArgs = new ArrayList<>();
    for (User user : users) {
        Object[] args = {user.getName(), user.getAge(), user.getEmail()};
        batchArgs.add(args);
    }

    return jdbcTemplate.batchUpdate(sql, batchArgs);
}

通常のupdateを何度も呼ぶよりも、はるかに高速に処理できます。

データベースとの通信回数が減るため、パフォーマンスが大幅に向上するのです。

トランザクション管理

複数のデータベース操作を一つのまとまりとして扱いたい場合、トランザクション管理が必要です。

トランザクションとは、複数の処理を「全部成功」か「全部失敗」のどちらかにする仕組みです。例えば、銀行の送金処理では「口座Aからお金を引く」と「口座Bにお金を入れる」の両方が成功しないと困りますよね。

Spring JDBCでは、@Transactionalアノテーションを使うだけで、簡単にトランザクション管理ができます。

import org.springframework.transaction.annotation.Transactional;

@Transactional
public void transferMoney(int fromId, int toId, int amount) {
    // 口座Aから引き出し
    String sql1 = "UPDATE accounts SET balance = balance - ? WHERE id = ?";
    jdbcTemplate.update(sql1, amount, fromId);

    // 口座Bに入金
    String sql2 = "UPDATE accounts SET balance = balance + ? WHERE id = ?";
    jdbcTemplate.update(sql2, amount, toId);
}

このメソッドの中で例外が発生すると、両方の処理が自動的にキャンセル（ロールバック）されます。

RowMapperの活用

先ほどから何度も出てきている「RowMapper」について、もう少し詳しく見てみましょう。

RowMapperとは

RowMapperは、データベースの1行（ResultSet）をJavaオブジェクトに変換するためのインターフェースです。

ラムダ式で簡潔に書くこともできますし、専用のクラスを作ることもできます。

ラムダ式での書き方

jdbcTemplate.query(sql,
    (rs, rowNum) -> new User(
        rs.getInt("id"),
        rs.getString("name"),
        rs.getInt("age")
    )
);

短いコードで済むので、シンプルな変換に向いています。

クラスとして定義する書き方

複雑な変換処理や、再利用したい場合は、専用のクラスを作ります。

public class UserRowMapper implements RowMapper<User> {
    @Override
    public User mapRow(ResultSet rs, int rowNum) throws SQLException {
        User user = new User();
        user.setId(rs.getInt("id"));
        user.setName(rs.getString("name"));
        user.setAge(rs.getInt("age"));
        user.setEmail(rs.getString("email"));
        user.setCreatedAt(rs.getTimestamp("created_at").toLocalDateTime());
        return user;
    }
}

使う時はこうなります。

jdbcTemplate.query(sql, new UserRowMapper());

複数の場所で同じ変換処理を使う場合は、この方法が便利です。

SimpleJdbcInsertでさらに簡単に

INSERT文を書くのが面倒な場合、「SimpleJdbcInsert」というクラスも使えます。

SimpleJdbcInsertの基本

SimpleJdbcInsert simpleJdbcInsert = new SimpleJdbcInsert(dataSource)
    .withTableName("users")
    .usingGeneratedKeyColumns("id");

テーブル名と自動生成されるキー（主キー）のカラム名を指定するだけです。

データの挿入

Map<String, Object> params = new HashMap<>();
params.put("name", "鈴木");
params.put("age", 28);
params.put("email", "suzuki@example.com");

Number id = simpleJdbcInsert.executeAndReturnKey(params);

INSERT文を書かなくても、自動的に生成してくれます。

しかも、自動生成されたIDも取得できます。便利ですね。

Spring JDBCのメリット

Spring JDBCを使うメリットをまとめてみましょう。

1. コードが短くなる

従来のJDBCと比べて、コード量が大幅に減ります。

リソース管理や例外処理といった定型的な部分を書く必要がないからです。

2. 保守性が向上する

コードが短くシンプルになることで、読みやすく、修正しやすくなります。

バグも減り、開発効率が上がります。

3. SQLを直接書ける

後述するJPAなどと違い、SQLを直接書けるのが特徴です。

複雑なクエリや、データベース固有の機能も自由に使えます。チューニングもしやすいですね。

4. 学習コストが低い

SQLとJavaの基本的な知識があれば、すぐに使い始められます。

新しい概念を大量に覚える必要がありません。

5. パフォーマンスが良い

ORM（Object-Relational Mapping）と比べて、オーバーヘッドが少なく、軽量です。

必要なSQL文だけを実行できるため、無駄がありません。

Spring JDBCのデメリット

良い面ばかりではありません。デメリットも知っておきましょう。

1. SQLを書く必要がある

メリットの裏返しですが、SQL文を自分で書かないといけません。

複雑な処理では、SQL文が長くなることもあります。

2. データベース固有の機能に依存しやすい

SQLを直接書けるため、特定のデータベース専用の機能を使いがちです。

後でデータベースを変更する場合、移行作業が大変になる可能性があります。

3. オブジェクトとテーブルのマッピングは手動

データベースの行とJavaオブジェクトの変換は、RowMapperで自分で書く必要があります。

テーブルが多いと、この作業が少し面倒です。

他の技術との比較

Spring JDBC以外にも、Javaでデータベースを扱う方法はいくつかあります。

JPA（Java Persistence API）との比較

JPAは、オブジェクトとデータベースのテーブルを自動的に関連付けてくれる技術です。

HibernateなどのORM実装がよく使われます。

JPAのメリット

  • SQL文を書かなくても良い
  • データベースに依存しないコードが書ける
  • オブジェクト指向的に開発できる

JPAのデメリット

  • 学習コストが高い
  • 複雑なクエリは書きにくい
  • パフォーマンスチューニングが難しい

シンプルなCRUD（作成・読取・更新・削除）操作が中心ならJPA、複雑なSQLや細かい制御が必要ならSpring JDBCがおすすめです。

MyBatisとの比較

MyBatisは、SQLをXMLファイルやアノテーションで管理できるフレームワークです。

MyBatisのメリット

  • SQLとJavaコードを分離できる
  • 動的SQLが書きやすい
  • 複雑なマッピングに対応できる

MyBatisのデメリット

  • XMLファイルの管理が必要
  • 設定項目が多い

Spring JDBCは軽量でシンプル、MyBatisは柔軟性が高いという違いがあります。

従来のJDBCとの比較

従来のJDBCは、Java標準のデータベースアクセス技術です。

従来のJDBCのメリット

  • 追加のライブラリが不要
  • 低レベルな制御ができる

従来のJDBCのデメリット

  • コード量が多くなる
  • リソース管理が面倒
  • 例外処理が煩雑

現代の開発では、Spring JDBCを使う方が圧倒的に効率的です。

Spring JDBCの実践的な使い方

実際のプロジェクトでSpring JDBCを使う際のポイントをご紹介します。

DAOパターンの活用

DAO（Data Access Object）パターンは、データベースアクセスのロジックを専用のクラスに分離する設計パターンです。

@Repository
public class UserDao {

    @Autowired
    private JdbcTemplate jdbcTemplate;

    public User findById(int id) {
        String sql = "SELECT * FROM users WHERE id = ?";
        return jdbcTemplate.queryForObject(sql, new Object[]{id}, new UserRowMapper());
    }

    public List<User> findAll() {
        String sql = "SELECT * FROM users";
        return jdbcTemplate.query(sql, new UserRowMapper());
    }

    public int insert(User user) {
        String sql = "INSERT INTO users (name, age, email) VALUES (?, ?, ?)";
        return jdbcTemplate.update(sql, user.getName(), user.getAge(), user.getEmail());
    }
}

@Repositoryアノテーションを付けることで、Springが自動的に例外変換などの処理を追加してくれます。

設定ファイルの例

Spring Bootを使う場合、データソースの設定はapplication.propertiesに書きます。

spring.datasource.url=jdbc:mysql://localhost:3306/mydb
spring.datasource.username=myuser
spring.datasource.password=mypassword
spring.datasource.driver-class-name=com.mysql.cj.jdbc.Driver

これだけで、JdbcTemplateが自動的に設定されます。

まとめ

Spring JDBCは、Javaでデータベースを扱う際の強力な味方です。

重要なポイントをおさらいしましょう。

  • Spring JDBCは、従来のJDBCを使いやすくラップした技術
  • JdbcTemplateを使えば、面倒なリソース管理や例外処理が不要になる
  • コード量が減り、保守性が向上する
  • SQLを直接書けるので、柔軟性とパフォーマンスが高い
  • NamedParameterJdbcTemplateを使えば、パラメータに名前を付けられる
  • バッチ処理やトランザクション管理も簡単に実装できる
  • JPAよりシンプルで学習コストが低い

データベースを扱うJavaアプリケーションを開発する時は、Spring JDBCをぜひ活用してください。

煩雑なコードから解放され、本質的なビジネスロジックに集中できるようになります。

最初は慣れないかもしれませんが、一度使い始めれば、その便利さにきっと驚くはずです。

Youtube

神話・歴史・伝承の解説チャンネル

スポンサーリンク

コメント

タイトルとURLをコピーしました