Jpa Patterns

affaan-m/ECC/docs/zh-CN/skills/jpa-patterns

作者 affaan-mef648e01899ba3e8dc6371642deaaf64b4477775無授權條款275K 個星標收錄於 2026年10月9日更新於 2026年10月9日儲存庫4 天前更新

Spring Boot中的JPA/Hibernate模式，用于实体设计、关系处理、查询优化、事务管理、审计、索引、分页和连接池。

僅含說明Software Development

AI 產生的概覽

Spring Boot 中 JPA/Hibernate 模式的指引，涵蓋實體設計、關聯關係、查詢、交易與效能調校。

功能: 此技能為 Spring Boot 中以 JPA/Hibernate 進行的資料建模、儲存庫與效能調校提供參考指引。內容涵蓋實體與資料表對應、關聯關係註解、以擷取策略與 DTO 投影預防 N+1 問題、儲存庫模式、交易、分頁、索引、HikariCP 連線池設定、快取、移轉以及資料存取測試。它產出的是說明性模式與程式碼片段，而非產生的檔案或指令碼。
適用情境: 在設計 JPA 實體與資料表對應、定義關聯關係，或最佳化 Spring Boot 應用程式中的查詢時使用。它也適用於設定交易、稽核、軟刪除、分頁、排序、自訂儲存庫方法、連線池或二級快取的場景。
執行需求: 沒有指令碼或隨附資源，僅為說明性內容。所述模式假定存在使用 JPA/Hibernate 的 Spring Boot 專案，並提及 HikariCP、Flyway 或 Liquibase、Testcontainers 等選用工具。

JPA/Hibernate 模式

用于 Spring Boot 中的数据建模、存储库和性能调优。

何时激活

设计 JPA 实体和表映射时
定义关系时 (@OneToMany, @ManyToOne, @ManyToMany)
优化查询时 (N+1 问题预防、获取策略、投影)
配置事务、审计或软删除时
设置分页、排序或自定义存储库方法时
调整连接池 (HikariCP) 或二级缓存时

实体设计

java

@Entity@Table(name = "markets", indexes = {  @Index(name = "idx_markets_slug", columnList = "slug", unique = true)})@EntityListeners(AuditingEntityListener.class)public class MarketEntity {  @Id @GeneratedValue(strategy = GenerationType.IDENTITY)  private Long id;
  @Column(nullable = false, length = 200)  private String name;
  @Column(nullable = false, unique = true, length = 120)  private String slug;
  @Enumerated(EnumType.STRING)  private MarketStatus status = MarketStatus.ACTIVE;
  @CreatedDate private Instant createdAt;  @LastModifiedDate private Instant updatedAt;}

@Entity@Table(name = "markets", indexes = {  @Index(name = "idx_markets_slug", columnList = "slug", unique = true)})@EntityListeners(AuditingEntityListener.class)public class MarketEntity {  @Id @GeneratedValue(strategy = GenerationType.IDENTITY)  private Long id;
  @Column(nullable = false, length = 200)  private String name;
  @Column(nullable = false, unique = true, length = 120)  private String slug;
  @Enumerated(EnumType.STRING)  private MarketStatus status = MarketStatus.ACTIVE;
  @CreatedDate private Instant createdAt;  @LastModifiedDate private Instant updatedAt;}

启用审计：

关联关系和 N+1 预防

java

@OneToMany(mappedBy = "market", cascade = CascadeType.ALL, orphanRemoval = true)private List<PositionEntity> positions = new ArrayList<>();

@OneToMany(mappedBy = "market", cascade = CascadeType.ALL, orphanRemoval = true)private List<PositionEntity> positions = new ArrayList<>();

默认使用延迟加载；需要时在查询中使用 JOIN FETCH
避免在集合上使用 EAGER；对于读取路径使用 DTO 投影

java

@Query("select m from MarketEntity m left join fetch m.positions where m.id = :id")Optional<MarketEntity> findWithPositions(@Param("id") Long id);

@Query("select m from MarketEntity m left join fetch m.positions where m.id = :id")Optional<MarketEntity> findWithPositions(@Param("id") Long id);

存储库模式

java

public interface MarketRepository extends JpaRepository<MarketEntity, Long> {  Optional<MarketEntity> findBySlug(String slug);
  @Query("select m from MarketEntity m where m.status = :status")  Page<MarketEntity> findByStatus(@Param("status") MarketStatus status, Pageable pageable);}

public interface MarketRepository extends JpaRepository<MarketEntity, Long> {  Optional<MarketEntity> findBySlug(String slug);
  @Query("select m from MarketEntity m where m.status = :status")  Page<MarketEntity> findByStatus(@Param("status") MarketStatus status, Pageable pageable);}

使用投影进行轻量级查询：

java

public interface MarketSummary {  Long getId();  String getName();  MarketStatus getStatus();}Page<MarketSummary> findAllBy(Pageable pageable);

public interface MarketSummary {  Long getId();  String getName();  MarketStatus getStatus();}Page<MarketSummary> findAllBy(Pageable pageable);

事务

使用 @Transactional 注解服务方法
对读取路径使用 @Transactional(readOnly = true) 以进行优化
谨慎选择传播行为；避免长时间运行的事务

java

@Transactionalpublic Market updateStatus(Long id, MarketStatus status) {  MarketEntity entity = repo.findById(id)      .orElseThrow(() -> new EntityNotFoundException("Market"));  entity.setStatus(status);  return Market.from(entity);}

@Transactionalpublic Market updateStatus(Long id, MarketStatus status) {  MarketEntity entity = repo.findById(id)      .orElseThrow(() -> new EntityNotFoundException("Market"));  entity.setStatus(status);  return Market.from(entity);}

分页

java

PageRequest page = PageRequest.of(pageNumber, pageSize, Sort.by("createdAt").descending());Page<MarketEntity> markets = repo.findByStatus(MarketStatus.ACTIVE, page);

PageRequest page = PageRequest.of(pageNumber, pageSize, Sort.by("createdAt").descending());Page<MarketEntity> markets = repo.findByStatus(MarketStatus.ACTIVE, page);

对于类似游标的分页，在 JPQL 中包含 id > :lastId 并配合排序。

索引和性能

为常用过滤器添加索引（status、slug、外键）
使用与查询模式匹配的复合索引（status, created_at）
避免 select *；仅投影需要的列
使用 saveAll 和 hibernate.jdbc.batch_size 进行批量写入

连接池 (HikariCP)

推荐属性：

spring.datasource.hikari.maximum-pool-size=20spring.datasource.hikari.minimum-idle=5spring.datasource.hikari.connection-timeout=30000spring.datasource.hikari.validation-timeout=5000

spring.datasource.hikari.maximum-pool-size=20spring.datasource.hikari.minimum-idle=5spring.datasource.hikari.connection-timeout=30000spring.datasource.hikari.validation-timeout=5000

对于 PostgreSQL LOB 处理，添加：

缓存

一级缓存是每个 EntityManager 的；避免在事务之间保持实体
对于读取频繁的实体，谨慎考虑二级缓存；验证驱逐策略

迁移

使用 Flyway 或 Liquibase；切勿在生产中依赖 Hibernate 自动 DDL
保持迁移的幂等性和可添加性；避免无计划地删除列

测试数据访问

首选使用 Testcontainers 的 @DataJpaTest 来镜像生产环境
使用日志断言 SQL 效率：设置 logging.level.org.hibernate.SQL=DEBUG 和 logging.level.org.hibernate.orm.jdbc.bind=TRACE 以查看参数值

请记住：保持实体精简，查询有针对性，事务简短。通过获取策略和投影来预防 N+1 问题，并根据读写路径建立索引。

來源與署名

來源：affaan-m/ECC位於docs/zh-CN/skills/jpa-patterns提交ef648e0

授權條款：無授權條款

內容歸原作者所有。SourceWeft 從公開儲存庫中收錄這些內容。

檢舉或申請下架

Jpa Patterns

JPA/Hibernate 模式

何时激活

实体设计

关联关系和 N+1 预防

存储库模式

事务

分页

索引和性能

连接池 (HikariCP)

缓存

迁移

测试数据访问

來源與署名

更多來自 affaan-m/ECC 的技能

Unified Notifications Ops

Verification Loop

Ui To Vue

Unified Memory

Visa Doc Translate

Team Builder

更多Software Development技能

Playground

M5 Onboard

Cardputer Buddy

Web Design Guidelines

Vercel React Native Skills

Vercel React Best Practices