412-frameworks-quarkus-panache

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Chinese

Apply Panache patterns for Hibernate ORM in Quarkus.

What is covered in this Skill?

Active record (PanacheEntity) vs PanacheRepository — when to use each
Parameterized HQL / Panache queries: positional (?1) and named (:param) — no unsafe concatenation
@NamedQuery on entities for reusable, build-time validated queries
DTO projections with project(Class) to avoid exposing managed entities
Pagination with Page.of(pageIndex, pageSize) and query.count()
N+1 avoidance with JOIN FETCH in HQL queries
Optimistic locking with @Version and handling OptimisticLockException
@Transactional application services
@TestTransaction for automatic rollback in @QuarkusTest tests
Mapping entities vs exposing DTOs at REST boundaries
Pairing with
```
@411
```
for raw SQL when needed

Scope: Apply recommendations based on the reference rules and good/bad code examples.

在Quarkus中应用Panache模式操作Hibernate ORM。

本Skill涵盖哪些内容？

范围： 根据参考规则和代码示例的优劣来应用相关建议。

Compile before persistence changes; verify after.

MANDATORY: Run
```
./mvnw compile
```
or
```
mvn compile
```
before applying any change
PREREQUISITE: Project must compile before applying Panache improvements
SAFETY: If compilation fails, stop immediately
BLOCKING CONDITION: Compilation errors must be resolved by the user before proceeding
VERIFY: Run
```
./mvnw clean verify
```
or
```
mvn clean verify
```
after applying improvements
BEFORE APPLYING: Read the reference for detailed rules and examples

在修改持久化代码前先编译；修改后进行验证。

Review Panache entities or repositories in Quarkus
Improve Hibernate ORM data access with Panache
Add DTO projections, JOIN FETCH, pagination, or optimistic locking to Panache queries
Fix N+1 query problems or add @Version concurrency control in Quarkus Panache

For detailed guidance, examples, and constraints, see references/412-frameworks-quarkus-panache.md.

如需详细指导、示例和约束条件，请查看references/412-frameworks-quarkus-panache.md。