Spring Data JPA参考文档

Spring Data JPA 中文参考手册，在线阅读地址：https://www.springcloud.cc/spring-data-jpa，基于官方1.11.3.RELEASE原版完整汉化，是国内完整、体系化Spring Data JPA中文学习文档，覆盖Repository抽象、查询推导、事务、审计、多数据源、CDI整合全知识点，适配SSM与早期Spring Boot项目开发、面试复习。

一、文档基础信息

• 原版版本：Spring Data JPA 1.11.3.RELEASE，2017官方稳定版
• 原著作者：Oliver Gierke、Thomas Darimont等Spring Data核心团队
• 内容定位：从Repository基础到企业级高级特性完整参考手册
• 授权说明：原版免费开源，中文译本完整保留版权声明，可免费在线查阅
• 适用场景：老Spring Boot 1.x/2.0项目维护、JPA底层原理面试、ORM持久层开发

二、全书完整知识章节体系

1. 前言与版本更新

项目源码、缺陷跟踪、仓库地址；1.10/1.11版本新增特性，兼容Hibernate5.2、QBE示例查询、exists投影等功能介绍。

2. 依赖管理与环境搭建

Spring Data版本火车BOM依赖统一管理；Spring Framework兼容版本；XML、JavaConfig两种仓库扫描配置方式。

3. Spring Data Repository通用核心（全模块通用抽象）

• 核心接口：Repository、CrudRepository、PagingAndSortingRepository
• 查询推导规则：And/Or/Like/Between等关键字、属性嵌套下划线分隔
• 分页、排序、流式、异步返回结果处理
• 自定义仓库实现、全局基础Repository扩展
• 聚合根领域事件@DomainEvents发布机制
• QueryDSL、Spring MVC网页参数自动绑定扩展

4. JPA专属仓库实现（文档核心主体）

• XML/注解两种@EnableJpaRepositories配置方式
• 实体持久化规则、标识符自动判新策略
• 三类查询：方法名自动推导、@Query手动JPQL、原生SQL、命名查询
• 参数绑定、SpEL表达式、分页计数、FetchGraph关联抓取
• @Modifying更新删除、存储过程调用、Example按示例查询
• Specification动态条件、投影DTO返回、批量操作

5. 事务与锁机制

方法级@Transactional配置、只读事务优化；悲观/乐观锁@Lock注解、事务传播行为详解。

6. JPA自动审计功能

@CreatedBy/@CreatedDate/@LastModifiedBy实体审计；AuditorAware当前用户实现、orm.xml监听器配置。

7. 杂项高级企业特性

• JpaContext多持久单元实体管理器获取
• 多EntityManager合并、classpath实体扫描
• CDI容器整合Repository，非Spring环境使用

8. 四大附录速查手册

• 附录A：jpa命名空间全部标签属性说明
• 附录B：数据填充populator配置
• 附录C：Repository全部查询关键字清单
• 附录D：支持的返回类型（Page/Slice/Stream/Optional等）
• 附录E：高频问题排查、术语词汇表

三、文档核心优势

• 完整官方直译：无删减原版全部API与底层原理，区别于碎片化博客教程；
• 分层学习：基础CRUD→自定义查询→事务审计→多数据源整合循序渐进；
• 大量可运行代码：XML配置、JavaConfig、Repository接口示例完整复制使用；
• 底层向讲解：不只是API调用，讲清Repository代理、查询解析底层逻辑；
• 配套速查附录：关键字、返回类型、命名空间标签随时查阅；
• 免费在线无广告，支持页面检索，适合开发随时翻阅。

四、适配学习人群

• 维护Spring Boot 1.x、SSM老项目后端开发；
• 使用JPA/Hibernate做ORM持久层工程师；
• 面试备考：Repository、事务、审计、动态查询高频考点；
• 需要区分MyBatis与JPA开发选型架构师；
• 学习QueryDSL、动态多条件查询的开发者。

五、推荐学习路线

1. 入门：第3章通用Repository，掌握CRUD、分页、方法查询；
2. 核心：第5章JPA专属仓库，@Query、Example、Specification动态查询；
3. 进阶：事务、审计、自定义仓库实现；
4. 高级：多持久单元、CDI整合、Web MVC参数绑定；
5. 速查：附录关键字、返回类型解决开发疑问。