jdbcTemplateのqueryForObjectの第二引数の指定がわからない

Question

前提・実現したいこと

queryForObjectの第二引数のRowMapper<T>の指定方法がわからない。
Spring BootでログインのDBのデータの件数を取得する処理でエラーが発生。

実現したいことは、現在出ているエラーを解消することです。
いろいろなサイトを参考に作成しているが、今まで携ってきた案件が下記のようなソースコードだったためうろ覚え状態でコーディングしています。
qurtyForObjectの引数が３つあった気がしますが、よくわかっていません、、、

発生している問題・エラーメッセージ

The method queryForObject(String, RowMapper<T>) in the type JdbcTemplate is not applicable for the arguments (String, MapSqlParameterSource)Java(67108979)

該当のソースコード

@Repository
public class SampleRepositoryImpl implements SampleRepository {

    @Autowired
    JdbcTemplate db;

    @Override
    public Integer login(String userName) {
        StringBuilder sb = new StringBuilder();
        MapSqlParameterSource param = new MapSqlParameterSource();
        sb.append(" SELECT ");
        sb.append("   user_name ");
        sb.append(" FROM ");
        sb.append("  users ");
        sb.append(" WHERE ");
        sb.append("  user_name = :userName ");
        param.addValue("userName", userName);
        return db.queryForObject(sb.toString(), param);
    }
}

試したこと

１．return db.queryForObject(sb.toString(), param);
２．return db.queryForObject(sb.toString(), param, Integer.class);
３．return db.queryForObject(sb.toString(), Integer.class);

３の場合のエラー

 Servlet.service() for servlet [dispatcherServlet] in context with path [] threw exception [Request processing failed; 
nested exception is org.springframework.jdbc.BadSqlGrammarException: StatementCallback; bad SQL grammar [ SELECT    user_name  FROM   users  WHERE   user_name = :userName ]; nested exception is org.postgresql.util.PSQLException: ERROR: ":"またはその近辺で構文エラー

org.postgresql.util.PSQLException: ERROR: ":"またはその近辺で構文エラー

補足情報（FW/ツールのバージョンなど）

JAVA 8
Spring Boot 2.3.3

Answer 1

JdbcTemplateのqueryForObjectを使う場合のパラメータ指定ですが、利用するJdbcTemplateで、いわゆるPreparedStatement（?で指定する方法)のSQLを使うか、変数を指定するプレースホルダにする NamedParameterJdbcTemplate を使う方法(id = :id で指定する方法）があります。

例えば、以下で定義されるテーブルで

CREATE TABLE account (id INT, name VARCHAR(256))

このテーブルに対して、id を指定して検索するSQLを、NamedParameterJdbcTemplate ならば

SELECT id, name FROM account WHERE id = :id

素のJdbcTemplateは、

SELECT id, name FROM account WHERE id=?

であるときに、このレコードを受けるクラスが以下で表現した場合、

public class Account {
	private Integer id;
	private String name;
// get|setメソッドならびにデフォルトコンストラクタが必須
}

これを実行する処理は、お使いのJdbcTemplateによりパラメータの格納方法が異なります。
NamedQuery～の方がパラメータの格納がしやすく(※)、視認性もとても高いので、ご希望されているNamedQuery～が良いですね！

※SqlParameterSource param = new MapSqlParameterSource().addValue("id", id); や Beanを丸ごと定義できる BeanPropertySqlParameterSource(..) が使えます。

NamedParameterJdbcTemplate :

import org.springframework.jdbc.core.BeanPropertyRowMapper;
import org.springframework.jdbc.core.namedparam.MapSqlParameterSource;
import org.springframework.jdbc.core.namedparam.NamedParameterJdbcTemplate;
import org.springframework.jdbc.core.namedparam.SqlParameterSource;
import org.springframework.stereotype.Repository;

import lombok.RequiredArgsConstructor;

@Repository
@RequiredArgsConstructor
public class NamedQueryAccountRepository {
	private final NamedParameterJdbcTemplate template;

	public Account findById(Integer id) {
		SqlParameterSource param = new MapSqlParameterSource().addValue("id", id);
		return template.queryForObject("SELECT id, name FROM account WHERE id = :id", param, new BeanPropertyRowMapper<Account>(Account.class));
	}

素のJdbcTemplate :

import org.springframework.jdbc.core.BeanPropertyRowMapper;
import org.springframework.jdbc.core.JdbcTemplate;
import org.springframework.stereotype.Repository;

import lombok.RequiredArgsConstructor;

@Repository
@RequiredArgsConstructor
public class AccountRepository {
	private final JdbcTemplate jdbcTemplate;
	public Account findById(int id) {
		return jdbcTemplate.queryForObject("SELECT id, name FROM account WHERE id=?"
				, new Object[]{id}
				, new BeanPropertyRowMapper<Account>(Account.class));
	}
}

Comments

[ryuxx]

回答ありがとうございました。
いろんなサイトを参考にしていますが、「id=:id」の実装方法があまり乗っていなく苦戦しているため上記での実装方法を教えていただけますでしょうか。

[A-pZ]

@ryuxx さん
NamedQueryの方を回答に追記しました！