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

SpringBoot 4.2 Starter Data JDBC轻量级ORM【简单持久】

浅浩酱_5883

浅浩酱_5883

发布时间:2026-08-07 21:54:25

|

333人浏览过

|

来源于php中文网

原创

在Spring Boot 4.2中,仅用spring-boot-starter-data-jdbc实现轻量CRUD:需正确配置依赖与sql.init.mode,实体字段名须匹配列名或用@Column指定,Repository接口继承JdbcRepository并加@Repository注解,仅支持AUTO_INCREMENT主键回填。

springboot 4.2 starter data jdbc轻量级orm【简单持久】

要在SpringBoot 4.2中用最轻量的方式完成数据库读写,不引入JPA的复杂约定、不依赖MyBatis的XML或注解扫描,只靠Spring官方原生支持的Starter Data JDBC实现对象到表的映射与基础CRUD,你需要避开自动建表陷阱、绕过实体字段名与列名不一致导致的空值问题,并确保查询结果能正确填充Java对象。

添加依赖与启用基础配置

在pom.xml中仅添加两个必要依赖:
① spring-boot-starter-data-jdbc 提供核心模板与Repository自动装配能力;
② 对应数据库驱动(如MySQL需mysql-connector-java,H2则用h2)。

注意:SpringBoot 4.2已将spring-boot-starter-jdbc整合进spring-boot-starter-data-jdbc,【不可再重复引入前者】,否则可能触发Bean定义冲突。

application.yml中配置数据源时,必须显式指定spring.sql.init.mode: always或never,否则4.2默认启用schema初始化,会尝试执行schema.sql——而Starter Data JDBC本身不解析该文件,导致启动失败。

定义实体类与列名映射

实体类无需@Entity或@Table,但字段命名必须严格匹配数据库列名(如数据库列为user_name,Java字段就必须叫user_name)。

若坚持使用驼峰命名(如userName),必须配合@Column注解并指定name = "user_name",否则JDBC Repository无法完成字段绑定,所有值均为null。

实体类必须提供无参构造函数,且每个字段要有标准getter/setter——这是RowMapper反射填充的硬性前提。

编写JdbcRepository接口

创建接口继承JdbcRepository<User, Long>,泛型中User为实体类,Long为主键类型。

接口上必须标注@Repository,否则Spring容器无法识别并注册该Bean。

方法命名遵循简单规则:直接写findById、findAll、save、deleteById即可生效,无需实现类——这些由Spring Data JDBC在运行时动态代理生成。

若需自定义SQL查询,用@Query注解,SQL语句中参数用:paramName占位,对应方法参数加@Param("paramName");【不支持方法名派生查询中的下划线转驼峰】,例如findByUser_name会被解析为列user_name,但findByUserName将查找不存在的列user_name(除非你手动配置NamingStrategy)。

执行插入与主键回填

调用repository.save(user)前,确保user.getId()为null或0——Starter Data JDBC仅支持AUTO_INCREMENT主键,且要求数据库表定义中明确声明id BIGINT AUTO_INCREMENT PRIMARY KEY。

保存后,user.getId()会自动被赋值为数据库生成的主键,无需手动调用getGeneratedKeys()。

如果主键是UUID或业务生成的字符串,必须改用@Insert + 自定义JdbcTemplate,Starter Data JDBC原生不支持非数字自增主键的回填。

查询列表并映射为对象

方法一:直接调用repository.findAll(),返回List<User>,每条记录按字段名1:1映射。

方法二:用@Query("SELECT * FROM users WHERE age > :minAge")定义带条件的查询,参数传入Map.of("minAge", 18)或单个@Param参数。

方法三:若需关联查询(如查用户+部门名称),不能依赖@OneToOne等JPA注解——Starter Data JDBC不处理关联映射。必须手写SQL把所有字段查出来,实体类字段名与结果集列名完全一致,否则缺失字段值为null。

热门AI工具

更多
豆包大模型

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

火山引擎

火山引擎是一款面向企业的云计算与AI服务平台。

LibLibAI
LibLibAI Hot

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

DeepSeek

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

二狗PPT
二狗PPT Hot

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

墨刀AI
墨刀AI Hot

一款AI图像与设计工具,主要用于产品经理的专属智能体,适合需要提升相关任务效率的用户。

SkildArt
SkildArt Hot

SkildArt是一款AI文本写作工具,一站式 AI 视觉创作平台。

UP简历
UP简历 Hot

一款AI办公效率工具,主要用于基于AI技术的免费在线简历制作工具,适合需要提升相关任务效率的用户。

WorkBuddy

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

相关专题

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

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

2191

2025.08.06

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

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

417

2026.01.26

Buffalo框架数据库开发全教程
Buffalo框架数据库开发全教程

本专题围绕Buffalo框架数据库开发,讲解database.yml多环境配置、soda与fizz迁移生成回滚、模型结构体标签、增删改查与条件查询、一对多与多对多关联、数据校验、回调钩子、事务处理及原生SQL执行能力。

80

2026.09.23

Buffalo框架路由与请求处理实操指南
Buffalo框架路由与请求处理实操指南

本专题讲解Buffalo框架路由与请求处理机制,涵盖路由注册与分组、资源路由、Handler编写规范、Context上下文方法、参数绑定、中间件编写挂载、Session与Cookie读写、Flash消息及错误页面定制方法。

20

2026.09.23

Buffalo框架零基础入门教程
Buffalo框架零基础入门教程

本专题整理Buffalo框架入门内容,涵盖Go环境准备、buffalo CLI安装、新项目生成、目录结构说明、dev热加载启动、数据库连接配置与常见报错排查,帮助新手按约定优于配置的思路跑通第一个Buffalo框架应用。

20

2026.09.23

Conan创建软件包配方指南
Conan创建软件包配方指南

本专题介绍通过conanfile.py创建软件包的方法,讲解包名、版本、依赖和构建设置等基础信息,以及source、build、package、package_info等常用方法的作用及编写思路。

20

2026.09.22

Conan二进制包配置指南
Conan二进制包配置指南

本专题介绍Conan根据操作系统、编译器、架构和构建类型生成二进制包的方法,讲解Profile、Settings、Options及Package ID的作用,帮助管理不同平台和编译环境下的包版本。

40

2026.09.22

Conan私有仓库搭建教程
Conan私有仓库搭建教程

本专题系统的讲解Conan私有仓库的搭建流程,涵盖仓库服务部署、存储目录配置、用户认证、权限划分和远程地址添加,并介绍内部C++依赖包的上传、下载及版本维护方法。

20

2026.09.22

loomy官网入口地址合集
loomy官网入口地址合集

本专题汇总了 Loomy 桌面 AI 助理的官方入口地址合集及使用指南。提供 macOS 与 Windows 客户端下载 。Loomy 是讯飞推出的桌面级 AI 工作搭子,支持文件整理、数据分析、网页操作及通过飞书/钉钉远程操控电脑,助你高效完成本地办公任务 。

20

2026.09.22

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Redis6入门到精通超详细教程
Redis6入门到精通超详细教程

共47课时 | 7.1万人学习

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

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