用途:为 Spring Data JPA 持久层提供实现模式,适用于创建带 CRUD 的仓库、配置实体关系、使用 @Query 注解、分页、审计或 UUID 主键等场景。
主要能力:仓库接口可继承 JpaRepository,使用派生查询(如 findByEmail、findByStatusOrderByCreatedDateDesc)或 @Query 自定义查询;实体使用 @Entity、@Table、@Id、@GeneratedValue、@Column 等注解,关系用 @OneToMany 等并配置级联类型;支持 @CreatedDate、@LastModifiedDate、@CreatedBy 审计字段;分页使用 Pageable 与 PageRequest;更新删除用 @Modifying;事务用 @Transactional(readOnly = true) 标记只读操作。
使用方式:定义仓库接口并继承合适接口,编写派生查询或 @Query;实体加注解并配置关系与级联;审计需 @EntityListeners(AuditingEntityListener.class);分页通过 PageRequest.of(page, size, Sort.by(...)) 实现。
适用场景:Spring 应用的持久层开发,包括 CRUD、复杂查询、分页、审计与事务管理。
限制与警告:不要在 REST API 直接暴露 JPA 实体,应使用 DTO;用 @EntityGraph 或 JOIN FETCH 避免 N+1;慎用大集合上的 CascadeType.REMOVE;集合不要用 EAGER;避免长事务;只读操作加 @Transactional(readOnly = true);注意一级缓存;UUID 主键可能造成索引碎片;大数据集分页需正确索引。级联行为应在小数据集上测试后再用于生产。