讲师中心 微信公众号
AI工具推荐 视频效率加速

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

胖墨同学_8051

胖墨同学_8051

发布时间:2026-08-07 19:41:35

|

898人浏览过

|

来源于php中文网

原创

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")
);

执行带参数的查询(防 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)
);

处理结果集映射(自定义 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"))
    )
);

热门AI工具

更多
LibLibAI
LibLibAI Hot

一款AI视频创作工具,主要用于国内领先的AI创意平台,以海量模型、低门槛操作与“创作-分享-商业化”生态,让小白与专业创作者都能高效实现图文乃至视频创意表达,适合需要提升相关任务效率的用户。

Seko
Seko Hot

一款AI视频创作工具,主要用于商汤科技推出的创编一体的AI短视频创作Agent,适合需要提升相关任务效率的用户。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

PixPix
PixPix Hot

PixPix是一款面向电商视觉生产的AI商品图生成工具。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

UpDream
UpDream Hot

一款AI视频创作工具,主要用于哔哩哔哩推出的自研AI视频创作工具,适合需要提升相关任务效率的用户。

Loomy
Loomy Hot

一款AI工具,主要用于科大讯飞发布的桌面级 AI 助理,比 OpenClaw 更易用、更安全!,适合需要提升相关任务效率的用户。

二狗PPT
二狗PPT Hot

一款AI演示文稿工具,主要用于专为中式职场打造的AI PPT生成工具,适合需要提升相关任务效率的用户。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

相关专题

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

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

2371

2025.08.06

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

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

437

2026.01.26

spring框架介绍
spring框架介绍

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

2371

2025.08.06

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

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

437

2026.01.26

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

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

80

2026.09.30

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

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

80

2026.09.30

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

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

80

2026.09.30

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

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

60

2026.09.30

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

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

60

2026.09.29

热门下载

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

精品课程

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

共0课时 | 0人学习

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

共0课时 | 0人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn