【SpringBoot】JdbcTemplateとSpring Data JPAの違いを整理してみた

@Repository
public class OrderRepositoryJdbc {

    private final JdbcTemplate jdbcTemplate;

    public OrderRepositoryJdbc(JdbcTemplate jdbcTemplate) {
        this.jdbcTemplate = jdbcTemplate;
    }

    // 【全件取得】SELECT * FROM orders
    public List<Order> findAll() {
        String sql = "SELECT id, customer_name, status, created_at, updated_at FROM orders";
        return jdbcTemplate.query(sql, this::mapRow); // 全行を mapRow で変換
    }

    // 【1件取得】SELECT ... WHERE id = ?
    public Optional<Order> findById(Long id) {
        String sql = "SELECT id, customer_name, status, created_at, updated_at "
                   + "FROM orders WHERE id = ?";
        List<Order> result = jdbcTemplate.query(sql, this::mapRow, id);
        return result.stream().findFirst(); // 空なら Optional.empty() を返す
    }

    // 【登録】INSERT INTO orders ...
    public Order save(Order order) {
        String sql = "INSERT INTO orders (customer_name, status, created_at, updated_at) "
                   + "VALUES (?, ?, ?, ?)";
        // KeyHolder で採番された ID を受け取る
        KeyHolder keyHolder = new GeneratedKeyHolder();
        jdbcTemplate.update(conn -> {
            PreparedStatement ps = conn.prepareStatement(sql, Statement.RETURN_GENERATED_KEYS);
            ps.setString(1, order.getCustomerName());
            ps.setString(2, order.getStatus());
            ps.setTimestamp(3, Timestamp.valueOf(LocalDateTime.now()));
            ps.setTimestamp(4, Timestamp.valueOf(LocalDateTime.now()));
            return ps;
        }, keyHolder);
        // 生成された ID を Order にセットして返す
        order.setId(Objects.requireNonNull(keyHolder.getKey()).longValue());
        return order;
    }

    // 【更新】UPDATE orders SET ... WHERE id = ?
    public Order update(Order order) {
        String sql = "UPDATE orders SET customer_name = ?, status = ?, updated_at = ? "
                   + "WHERE id = ?";
        jdbcTemplate.update(sql,
            order.getCustomerName(),
            order.getStatus(),
            Timestamp.valueOf(LocalDateTime.now()),
            order.getId()
        );
        return order;
    }

    // 【削除】DELETE FROM orders WHERE id = ?
    public void deleteById(Long id) {
        jdbcTemplate.update("DELETE FROM orders WHERE id = ?", id);
    }

    // ResultSet（DB の 1 行）を Order オブジェクトに変換
    private Order mapRow(ResultSet rs, int rowNum) throws SQLException {
        Order order = new Order();
        order.setId(rs.getLong("id"));
        order.setCustomerName(rs.getString("customer_name"));
        order.setStatus(rs.getString("status"));
        order.setCreatedAt(rs.getTimestamp("created_at").toLocalDateTime());
        order.setUpdatedAt(rs.getTimestamp("updated_at").toLocalDateTime());
        return order;
    }
}

public interface OrderRepository extends JpaRepository<Order, Long> {}

@Repository
public class PostRepositoryJdbc {

    private final JdbcTemplate jdbcTemplate;

    public PostRepositoryJdbc(JdbcTemplate jdbcTemplate) {
        this.jdbcTemplate = jdbcTemplate;
    }

    // ① ユーザーの投稿一覧を取得
    public List<Post> findByUserId(Long userId) {
        String sql = """
            SELECT id, user_id, category_id,
                   title, body, created_at, updated_at
            FROM   posts
            WHERE  user_id = ?
            """;
        // SQL を実行し、各行を mapRow で Post オブジェクトに変換
        return jdbcTemplate.query(sql, this::mapRow, userId);
    }

    // ② 複数ユーザーの投稿をまとめて取得
    public List<Post> findByUserIdIn(List<Long> userIds) {
        // IN (?, ?, ?) を userIds の件数分だけ動的に組み立てる
        String placeholders = userIds.stream()
            .map(id -> "?")
            .collect(Collectors.joining(","));
        String sql = "SELECT id, user_id, category_id, title, body, created_at, updated_at "
                   + "FROM posts WHERE user_id IN (" + placeholders + ")";
        return jdbcTemplate.query(sql, this::mapRow, userIds.toArray());
    }

    // ③ ユーザーの投稿を全件削除
    public void deleteByUserId(Long userId) {
        jdbcTemplate.update(
            "DELETE FROM posts WHERE user_id = ?",
            userId
        );
    }

    // ④ カテゴリに投稿が紐づいているか確認
    public boolean existsByCategoryId(Long categoryId) {
        // COUNT(*) で件数を取得し、1件でもあれば true を返す
        Integer count = jdbcTemplate.queryForObject(
            "SELECT COUNT(*) FROM posts WHERE category_id = ?",
            Integer.class,
            categoryId
        );
        return count != null && count > 0; // null ガードしないと NullPointerException が起きうる
    }

    // ResultSet（DB から返ってきた 1 行）を Post オブジェクトに変換
    private Post mapRow(ResultSet rs, int rowNum) throws SQLException {
        Post post = new Post();
        post.setId(rs.getLong("id"));
        post.setTitle(rs.getString("title"));
        post.setBody(rs.getString("body"));
        post.setCreatedAt(rs.getTimestamp("created_at").toLocalDateTime());
        post.setUpdatedAt(rs.getTimestamp("updated_at").toLocalDateTime());
        // user_id / category_id から関連エンティティを取り直す処理も別途必要になりがち…
        return post;
    }
}

public interface PostRepository extends JpaRepository<Post, Long> {

    // ① ユーザーの投稿一覧を取得
    List<Post> findByUser_Id(Long userId);

    // ② 複数ユーザーの投稿をまとめて取得（IN 句）
    List<Post> findByUser_IdIn(List<Long> userIds);

    // ③ ユーザーの投稿を全件削除
    void deleteByUser_Id(Long userId);

    // ④ カテゴリに投稿が紐づいているか確認
    boolean existsByCategory_Id(Long categoryId);
}

  例: findByUser_IdIn
    └─ find      → 取得処理
    └─ By        → ここから検索条件
    └─ User_Id   → user.id を条件にする
    └─ In        → IN句

[動詞]By[フィールド名][条件]
  ↑                  ↑
  何をするか          何で絞り込むか