Jpa Patterns

affaan-m/ECC/docs/ja-JP/skills/jpa-patterns

作者 affaan-mef648e01899ba3e8dc6371642deaaf64b4477775无许可证275K 个星标收录于 2026年10月9日更新于 2026年10月9日仓库4天前更新

JPA/Hibernate patterns for entity design, relationships, query optimization, transactions, auditing, indexing, pagination, and pooling in Spring Boot.

仅含说明Software Development

AI 生成的概览

Spring Boot 中 JPA/Hibernate 实体设计、查询、事务、索引与连接池的参考模式。

功能: 提供在 Spring Boot 中建模 JPA/Hibernate 实体的指导与代码片段，涵盖实体注解、审计、关联关系与 N+1 预防。还说明仓储模式、DTO 投影、事务与分页用法、索引、HikariCP 连接池、缓存、迁移以及数据访问测试。产出为教学性参考资料，而非生成的文件或脚本。
适用场景: 适用于设计或审查 Spring Boot 应用的 JPA/Hibernate 持久层。适合处理实体映射、抓取策略、查询优化、事务、索引或连接池相关问题。
运行要求: 不附带脚本或工具，仅为说明性内容。应用这些模式需具备使用 JPA/Hibernate 的 Spring Boot 项目，并提及可选使用 Flyway 或 Liquibase、Testcontainers 与 HikariCP。

JPA/Hibernate パターン

Spring Bootでのデータモデリング、リポジトリ、パフォーマンスチューニングに使用します。

エンティティ設計

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処理には、次を追加:

キャッシング

1次キャッシュはEntityManagerごと。トランザクション間でエンティティを保持しない
読み取り集約型エンティティには、2次キャッシュを慎重に検討。退避戦略を検証

マイグレーション

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/ja-JP/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