Spring 怎么使用 JdbcTemplate 执行原生 SQL 查询

胖墨同学_8051

胖墨同学_8051

2026-08-07

898人浏览

原创

Spring中使用JdbcTemplate执行原生SQL查询需先配置并注入JdbcTemplate实例,再调用queryForObject()查单值、query()查多行(配RowMapper),参数化查询用?占位符防注入,结果映射可选BeanPropertyRowMapper或自定义RowMapper。

spring 怎么使用 jdbctemplate 执行原生 sql 查询

Spring 使用 JdbcTemplate 执行原生 SQL 查询非常直接,核心是注入已配置好的 JdbcTemplate 实例,调用其查询方法并传入 SQL 字符串和参数(如有)。

准备 JdbcTemplate 实例

确保 Spring 容器中已配置好 JdbcTemplate。通常通过 DataSource 自动装配:

@Configuration
public class JdbcConfig {
    @Bean
    public JdbcTemplate jdbcTemplate(DataSource dataSource) {
        return new JdbcTemplate(dataSource);
    }
}

在 DAO 或 Service 类中直接注入使用:

@Repository
public class UserDao {
    private final JdbcTemplate jdbcTemplate;
<pre class="brush:php;toolbar:false;">public UserDao(JdbcTemplate jdbcTemplate) {
    this.jdbcTemplate = jdbcTemplate;
}

}

Java Maven Code Review
Java Maven Code Review

审查Java Maven项目(ZIP压缩包或GitLab仓库URL),检查代码规范、命名、模块边界、可维护性问题以及重复代码。

下载

执行简单查询(无参数)

适合固定 SQL,如统计总数、查单个值等:

  • 查单个结果(如 count、max、字符串)用 queryForObject()
  • 返回多行结果用 query(),需提供 RowMapper 映射每行数据
// 查询用户总数
int count = jdbcTemplate.queryForObject("SELECT COUNT(*) FROM users", Integer.class);
<p>// 查询所有用户名
List<string> names = jdbcTemplate.query(
"SELECT name FROM users WHERE status = 'ACTIVE'",
(rs, rowNum) -> rs.getString("name")
);</string></p>

执行带参数的查询(防 SQL 注入)

永远优先使用占位符 ? + 参数数组/列表,避免拼接字符串:

  • 参数顺序必须与 ? 出现顺序一致
  • 支持基本类型、String、Date、BigDecimal 等常见类型
  • 复杂对象需自定义 RowMapper 或用 BeanPropertyRowMapper
// 根据 ID 查用户
User user = jdbcTemplate.queryForObject(
    "SELECT id, name, email FROM users WHERE id = ?",
    new BeanPropertyRowMapper(User.class),
    123L
);
<p>// 多参数查询
List<user> users = jdbcTemplate.query(
"SELECT * FROM users WHERE status = ? AND created_date > ?",
new BeanPropertyRowMapper(User.class),
"ACTIVE",
LocalDate.of(2024, 1, 1)
);</user></p>

处理结果集映射(自定义 vs 内置)

推荐根据场景选择映射方式:

  • 查单个字段或简单结构 → 匿名 RowMapper 或直接用 queryForObject(Class)
  • 查完整实体类 → BeanPropertyRowMapper(要求列名与属性名匹配,或加 @Column 注解)
  • 需要复杂转换(如枚举、嵌套对象、空值处理)→ 自定义 RowMapper 实现
// 自定义映射:处理 status 字段转为枚举
jdbcTemplate.query(
    "SELECT id, name, status FROM users",
    (rs, rowNum) -> new User(
        rs.getLong("id"),
        rs.getString("name"),
        Status.valueOf(rs.getString("status"))
    )
);

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

java

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
spring框架介绍
spring框架介绍

本专题整合了spring框架相关内容,想了解更多详细内容,请阅读专题下面的文章。

2025.08.06

2351

22

Java Spring Security 与认证授权
Java Spring Security 与认证授权

本专题系统讲解 Java Spring Security 框架在认证与授权中的应用,涵盖用户身份验证、权限控制、JWT与OAuth2实现、跨站请求伪造(CSRF)防护、会话管理与安全漏洞防范。通过实际项目案例,帮助学习者掌握如何 使用 Spring Security 实现高安全性认证与授权机制,提升 Web 应用的安全性与用户数据保护。

2026.01.26

437

25

spring框架介绍
spring框架介绍

本专题整合了spring框架相关内容,想了解更多详细内容,请阅读专题下面的文章。

2025.08.06

2351

22

Java Spring Security 与认证授权
Java Spring Security 与认证授权

本专题系统讲解 Java Spring Security 框架在认证与授权中的应用,涵盖用户身份验证、权限控制、JWT与OAuth2实现、跨站请求伪造(CSRF)防护、会话管理与安全漏洞防范。通过实际项目案例,帮助学习者掌握如何 使用 Spring Security 实现高安全性认证与授权机制,提升 Web 应用的安全性与用户数据保护。

2026.01.26

437

25

LLVM自定义Pass怎么写
LLVM自定义Pass怎么写

本专题聚焦LLVM自定义Pass开发,整理Pass类结构、run()方法、PreservedAnalyses、CMake构建、插件注册、-load-pass-plugin加载和测试用例编写流程。

2026.09.30

80

10

LLVM RISC-V参数配置教程
LLVM RISC-V参数配置教程

本专题介绍LLVM对RISC-V基础ISA和扩展的支持方式,涵盖RV32、RV64、标准扩展、实验性扩展、厂商扩展、-menable-experimental-extensions和版本差异。

2026.09.30

80

14

LLVM IR中间表示入门指南
LLVM IR中间表示入门指南

本专题整理LLVM IR的核心概念,包括中间表示作用、模块结构、函数、基本块、SSA形式、类型系统和常见语法,帮助新手理解LLVM编译流程中的关键层。

2026.09.30

80

12

PDF转图片方法
PDF转图片方法

需要把 PDF 页面用于上传、预览、分享或图片归档时,PDF 转图片方法专题整理 JPG/PNG 格式选择、逐页导出、清晰度设置、批量下载和结果检查等流程,帮助用户稳定完成 PDF 图片化处理。

2026.09.30

60

26

PixTV AI视频生成与无限画布创作
PixTV AI视频生成与无限画布创作

PixTV专题整理AI视频与视觉内容创作相关功能使用教程,涵盖AI生图、视频生成、无限画布、多模型创作、素材管理、声音音乐及视频剪辑等功能,帮助用户快速掌握PixTV从创意到成片的完整制作方法。

2026.09.29

60

15

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
dev.java 官方:Learn Java
dev.java 官方:Learn Java

共0课时 | 0人学习

Java JDBC数据库连接官方教程
Java JDBC数据库连接官方教程

共0课时 | 0人学习