Przejdź do treści
Biblioteka skilli
Programowanie · Budowanie i kod

hibernate-orm

/hibernate-orm

Podaje zasady i sprawdzone wzorce kodu Hibernate ORM 7 i Jakarta Persistence 3.2 w zwykłej Javie, na przykład dla encji i zapytań.

Licencja
MIT
Ostatnia zmiana repozytorium
31.10.2026

Ocena i bezpieczeństwo

100/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść35 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
74
Skrypty
26
Komentarze HTML
0
Adresy URL w SKILL.md
0
Przestarzałość

Brak sygnałów. Repozytorium zmienione 31.10.2026, bez odwołań do wycofanych modeli i API.

Licencja

MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.

Co sprawdzić przed instalacją
  • 26 skryptów w paczce. Przejrzyj je przed instalacją, bo Claude może je uruchomić.

Skrypty: evals/bulk-product-import/files/src/main/java/shop/model/Customer.java, evals/bulk-product-import/files/src/main/java/shop/model/Product.java, evals/bulk-product-import/files/src/test/java/shop/SmokeTest.java, evals/bulk-product-import/files/src/test/java/shop/TestDatabase.java, evals/bulk-product-import/place-files.sh, evals/catalog-page-rendering/files/src/main/java/shop/model/Customer.java, eva

Co robi i kiedy

Podaje zasady i sprawdzone wzorce kodu Hibernate ORM 7 i Jakarta Persistence 3.2 w zwykłej Javie, na przykład dla encji i zapytań.

Oryginalny opis (EN)

Rules and verified patterns for writing Hibernate ORM 7 / Jakarta Persistence 3.2 code in plain Java. Use when creating or changing JPA entities (@Entity, @Embeddable), associations (@OneToMany, @ManyToOne, @ManyToMany), HQL/JPQL/native queries, entity graphs, Session/EntityManager/StatelessSession usage, transactions, optimistic locking, or when diagnosing N+1 selects, LazyInitializationException or MultipleBagFetchException.

Jak działa

  1. Workflow
  2. Core rules
Sekcje z nagłówków SKILL.md, w oryginale · 86 linii, 819 słów
Podgląd SKILL.md
---
name: hibernate-orm
description: Rules and verified patterns for writing Hibernate ORM 7 / Jakarta Persistence 3.2 code in plain Java. Use when creating or changing JPA entities (@Entity, @Embeddable), associations (@OneToMany, @ManyToOne, @ManyToMany), HQL/JPQL/native queries, entity graphs, Session/EntityManager/StatelessSession usage, transactions, optimistic locking, or when diagnosing N+1 selects, LazyInitializationException or MultipleBagFetchException.
---

# Hibernate ORM 7 guidelines

Target: **Hibernate ORM 7.x** with **Jakarta Persistence 3.2**, plain Java. Rules tagged ✅ are backed by tests
that pass on Hibernate 7.0 through 7.4.

You already know general Hibernate practice. This skill adds what gets missed without it: a **checklist for
every entity**, this project's **house rules**, and **Hibernate 7 specifics**. Hibernate 5 examples from
memory are often wrong for version 7.

## Workflow

1. Go through the **entity checklist** for every entity you create or change, including entities you only
   touch to add an association. Missing `LAZY` and missing `@Version` are the most common slips.
2. Write the code. Open a reference file only when you need details or examples:
   [entity-mapping](references/entity-mapping.md), [associations](references/associations.md),
   [fetching](references/fetching.md), [querying](references/querying.md),
   [sessions-and-transactions](references/sessions-and-transactions.md), [testing](references/testing.md),
   [anti-patterns](references/anti-patterns.md) (review checklist).
3. Run the checker on the changed code. Fix every ERROR, and fix WARNINGs unless you can say why one doesn't
   apply: `python3 <skill-dir>/scripts/check_entities.py src/main/java`
4. For code that loads data, assert the SQL statement count in a test (`references/testing.md`).

## Core rules

### Entity checklist: every entity you create or change

- **A1** ✅ Every `@ManyToOne` and `@OneToOne` has `fetch = FetchType.LAZY`. The default is EAGER, which loads
  the target for every row, even if it's never used. Never use `FetchType.EAGER`.
- **C1** ✅ `@Version private int version;` on every entity that is **modified after creation**. Skip it only
  for insert-only/immutable entities. Never set it yourself.
- **M3** ✅ `equals`/`hashCode`: compare a `@NaturalId` if one exists. Otherwise compare the non-null generated
  id and return a **constant** `hashCode` (e.g. `Order.class.hashCode()`). Use `instanceof` and getters on the
  other object, because it may be a proxy. Never `Objects.hash(id)`.
- **M7** ✅ `toString()` contains no associations. No Lombok `@Data`/`@EqualsAndHashCode`/`@ToString` on
  entities (`@Getter`/`@Setter` are fine).
- **M4** ✅ Enums are `@Enumerated(EnumType.STRING)`.
- **M6** ✅ Non-`final` class with a `protected` no-arg constructor. Hibernate can't proxy a final class, so
  LAZY associations to it are silently loaded eagerly.
- **A6** ✅ A `@OneToMany` collection only if the domain **bounds** it (order lines, invoice positions).
  Children that accumulate over time (orders, reviews, events, transactions) get only the `@ManyToOne` on the
  child and are queried with paging. If unsure, ask; when in doubt, don't map the collection.
- **A2** ✅ Bidirectional: the `@ManyToOne` side owns the foreign key. Provide `addX`/`removeX` helpers that set
  both sides, and expose the collection read-only.
- **A3** ✅ Cascade only parent → child. Never cascade `REMOVE`/`ALL` on `@ManyToOne` or `@ManyToMany`.
- **M1** `jakarta.persistence.*` imports. **M2** `GenerationType.SEQUENCE`, unless the project already uses
  `IDENTITY` (which disables insert batching).

### House rules

- **F5** ✅ Lists, reports, exports and API responses use DTO projections (records), not entities. Load entities
  only when the use case modifies them.
- **S2** ✅ To apply changes from a form/request/DTO: `find` + setters on the managed entity, not `merge` of a
  client-built object (merge overwrites fields the client never sent). If you do merge, use the returned instance.
- **S4** Every unit of work runs in a transaction (`sessionFactory.inTransaction(s -> …)` /
  `fromTransaction(s -> …)`). Never share a `Session` between threads or requests. After any exception from
  Hibernate, roll back and discard the session; retry in a new one.
- **Q2** Use the query API the project already uses (JPA `createQuery` or Hibernate
  `createSelectionQuery`/`createMutationQuery`); don't mix them. Always pass the result type.

### Hibernate 7 specifics

- **S3** Removed in 7: `save`, `update`, `saveOrUpdate`, `delete`, `load(Class, id)`. Use `persist`, `merge`,
  `remove`, `getReference`/`find`. The legacy `Criteria` API is gone (use HQL or `CriteriaBuilder`).
- Record DTOs need no `select new`: `createSelectionQuery("select b.isbn, b.title from Book b", BookSummary.class)`.
- **F4** ✅ Pagination with a collection `join fetch` runs **in SQL from 7.4.0** (1 statement). **Up to 7.3** it
  loads all rows and pages in memory. Below 7.4 or in version-independent code, page the ids first, then fetch.
  Set `hibernate.query.fail_on_pagination_over_collection_fetch=true` where you control the configuration.
- **M5** ✅ Records work as `@Embeddable` and as DTOs, never as entities.
- **S5** ✅ Bulk work: `sessionFactory.inStatelessTransaction(s -> …)` with `s.insert(…)`. A regular session keeps
  every entity in memory, so use `flush()` + `clear()` every N there. `session.setJdbcBatchSize(50)` enables
  JDBC batching for one session without touching the configuration.

### General practice (details in the reference files)

- **F1** ✅ No lazy access in loops (N+1): `join fetch` what the use case needs, or **F2** ✅ an entity graph;
  **F3** ✅ `hibernate.default_batch_fetch_size` is a safety net, not a fix.
- **F6** ✅ Fix `LazyInitializationException` in the query. Never with EAGER, `enable_lazy_load_no_trans` or
  open-session-in-view.
- **A4** ✅ `Set` for `@ManyToMany`; never `join fetch` two `List` collections in one query.
  **A5** ✅ `orphanRemoval = true` for children that can't exist without their parent.
- **Q1** ✅ Always bind parameters; never concatenate values into queries.
  **Q4** ✅ Bulk `update`/`delete` bypasses loaded entities: run first, or `refresh`/`clear` after.
  **Q5** ✅ Never put a `where` on a join-fetched collection alias; filter with `exists`.
- **S1** ✅ Managed entities are saved automatically at commit; no `merge`/`persist` after setters.
Pliki w paczce (74)
  • SKILL.md 6 KB
  • evals/bulk-product-import/case.yaml 1 KB
  • evals/bulk-product-import/place-files.sh 1 KB
  • evals/bulk-product-import/prompt.md 1 KB
  • evals/bulk-product-import/files/pom.xml 2 KB
  • evals/bulk-product-import/files/src/main/java/shop/model/Customer.java 1 KB
  • evals/bulk-product-import/files/src/main/java/shop/model/Product.java 1 KB
  • evals/bulk-product-import/files/src/test/java/shop/SmokeTest.java 1 KB
  • evals/bulk-product-import/files/src/test/java/shop/TestDatabase.java 1 KB
  • evals/bulk-product-import/graders/01-importproducts-imports-all-50000-rows-with.md 1 KB
  • evals/bulk-product-import/graders/02-the-import-does-not-keep-all.md 1 KB
  • evals/bulk-product-import/graders/03-importing-50000-rows-takes-less-than.md 1 KB
  • evals/bulk-product-import/graders/04-the-projects-own-test-suite-mvn.md 1 KB
  • evals/catalog-page-rendering/case.yaml 1 KB
  • evals/catalog-page-rendering/place-files.sh 1 KB
  • evals/catalog-page-rendering/prompt.md 1 KB
  • evals/catalog-page-rendering/files/pom.xml 2 KB
  • evals/catalog-page-rendering/files/src/main/java/shop/model/Customer.java 1 KB
  • evals/catalog-page-rendering/files/src/main/java/shop/model/Product.java 1 KB
  • evals/catalog-page-rendering/files/src/test/java/shop/SmokeTest.java 1 KB
  • evals/catalog-page-rendering/files/src/test/java/shop/TestDatabase.java 1 KB
  • evals/catalog-page-rendering/graders/01-categorypage-returns-the-right-page-in.md 1 KB
  • evals/catalog-page-rendering/graders/02-categorypage-for-10-categories-with-5.md 1 KB
  • evals/catalog-page-rendering/graders/03-products-added-with-categoryaddproduct-are-stored.md 1 KB
  • evals/catalog-page-rendering/graders/04-all-manytoone-onetoone-associations-are-lazy.md 1 KB
  • evals/catalog-page-rendering/graders/05-the-projects-own-test-suite-mvn.md 1 KB
  • evals/order-history-paging/case.yaml 1 KB
  • evals/order-history-paging/place-files.sh 1 KB
  • evals/order-history-paging/prompt.md 1 KB
  • evals/order-history-paging/files/pom.xml 2 KB
  • evals/order-history-paging/files/src/main/java/shop/model/Customer.java 1 KB
  • evals/order-history-paging/files/src/main/java/shop/model/Product.java 1 KB
  • evals/order-history-paging/files/src/test/java/shop/SmokeTest.java 1 KB
  • evals/order-history-paging/files/src/test/java/shop/TestDatabase.java 1 KB
  • evals/order-history-paging/graders/01-orderhistory-returns-correct-pages-20-.md 1 KB
  • evals/order-history-paging/graders/02-orderhistory-for-a-page-of-20.md 1 KB
  • evals/order-history-paging/graders/03-customer-has-no-collection-field-for.md 1 KB
  • evals/order-history-paging/graders/04-all-manytoone-onetoone-associations-are-lazy.md 1 KB
  • evals/order-history-paging/graders/05-the-projects-own-test-suite-mvn.md 1 KB
  • evals/product-edit-form/case.yaml 1 KB
  • evals/product-edit-form/place-files.sh 1 KB
  • evals/product-edit-form/prompt.md 1 KB
  • evals/product-edit-form/files/pom.xml 2 KB
  • evals/product-edit-form/files/src/main/java/shop/model/Customer.java 1 KB
  • evals/product-edit-form/files/src/main/java/shop/model/Product.java 1 KB
  • evals/product-edit-form/files/src/test/java/shop/SmokeTest.java 1 KB
  • evals/product-edit-form/files/src/test/java/shop/TestDatabase.java 1 KB
  • evals/product-edit-form/graders/01-updateproduct-changes-name-and-price.md 1 KB
  • evals/product-edit-form/graders/02-updateproduct-leaves-stock-and-description-unchanged.md 1 KB
  • evals/product-edit-form/graders/03-unknown-id-creates-no-product.md 1 KB
  • evals/product-edit-form/graders/04-product-has-a-version-attribute-optimistic.md 1 KB
  • evals/product-edit-form/graders/05-the-projects-own-test-suite-mvn.md 1 KB
  • evals/product-reviews/case.yaml 1 KB
  • evals/product-reviews/place-files.sh 1 KB
  • evals/product-reviews/prompt.md 1 KB
  • evals/product-reviews/files/pom.xml 2 KB
  • evals/product-reviews/files/src/main/java/shop/model/Customer.java 1 KB
  • evals/product-reviews/files/src/main/java/shop/model/Product.java 1 KB
  • evals/product-reviews/files/src/test/java/shop/SmokeTest.java 1 KB
  • evals/product-reviews/files/src/test/java/shop/TestDatabase.java 1 KB
  • evals/product-reviews/graders/01-deletereview-deletes-only-that-review-customer.md 1 KB
  • evals/product-reviews/graders/02-ratingsummary-returns-the-correct-count-and.md 1 KB
  • evals/product-reviews/graders/03-ratingsummary-runs-a-single-sql-statement.md 1 KB
  • evals/product-reviews/graders/04-product-has-no-collection-field-for.md 1 KB
  • evals/product-reviews/graders/05-no-cascade-remove-all-on-manytoone.md 1 KB
  • evals/product-reviews/graders/06-the-projects-own-test-suite-mvn.md 1 KB
  • references/anti-patterns.md 4 KB
  • references/associations.md 7 KB
  • references/entity-mapping.md 7 KB
  • references/fetching.md 6 KB
  • references/querying.md 5 KB
  • references/sessions-and-transactions.md 8 KB
  • references/testing.md 2 KB
  • scripts/check_entities.py 13 KB

Wersje

W bazie nie ma innych skilli o nazwie hibernate-orm.

Migawka bazy z 13.11.2026 · wersja paczki c46c8efb147c (skrót SHA-256 całej paczki)

Pobrania w ostatnich 30 dniach: 0 · ranking

Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.

Podobne skille

  • 90java-hibernate-jpa
    Diagnozuje i naprawia problemy Hibernate ORM i Jakarta Persistence: N+1, lazy loading, generowanie identyfikatorów, kaskady, paginację, blokowanie i różnice Hibernate 6 i 7.
  • 100kotlin-backend-jpa-entity-mapping
    Pomaga poprawnie modelować encje Kotlin dla Spring Data JPA i Hibernate: tożsamość, relacje, ograniczenia unikalności, plany pobierania i pułapki ORM, jak N+1 czy LazyInitializationException.
  • 100orm-patterns
    Pisze wydajne zapytania ORM, np. w Prisma, Hibernate, EF Core czy SQLAlchemy: wykrywa N+1, ładowanie danych, transakcje i bezpieczny surowy SQL.
  • 100spring-data-jpa
    Generuje i refaktoryzuje encje, repozytoria, projekcje i zapytania JPA w Spring Boot 4 z Hibernate 7.
  • 95jpa-patterns
    Wyjaśnia wzorce JPA i Hibernate oraz typowe pułapki: problem N+1, leniwe ładowanie, transakcje i zapytania.
  • 100hibernate-upgrade
    Migruje Hibernate 5 do Hibernate 6 ze Spring Boot 3: naprawia parsowanie zapytań HQL i JPQL, usuwa przestarzałe Criteria API, aktualizuje strategie generowania ID i diagnozuje zmiany N+1.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.