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