Spring Data JPA & Hibernate

Spring Boot 3 / Hibernate 6: điểm khác

• Package là jakarta.persistence.*, không còn javax.persistence.*
• Cần Java 17 trở lên
• Hibernate tự nhận dialect, thường không cần khai báo
• getReferenceById() thay cho getOne()
• ListCrudRepository trả List thay vì Iterable
• PagingAndSortingRepository không còn extends CrudRepository
• @Where được thay bằng @SQLRestriction (Hibernate 6.3+)

Khi nào dùng cái gì

• CRUD đơn giản, truy vấn theo tên field: derived query
• Truy vấn có join hoặc điều kiện phức tạp: @Query JPQL
• Filter động nhiều điều kiện tùy chọn: Specification
• Báo cáo, hàm đặc thù DB: native query hoặc projection
• Cần kiểm soát sâu session, cache, statistics: unwrap sang Session

Dependency

application.yml

ddl-auto

Bật statistics để đếm query

Cách nhanh nhất để phát hiện N+1: đếm số câu SQL cho một request.

Annotation hay dùng

Chiến lược sinh khóa

Kế thừa

Embedded và khóa phức hợp

AttributeConverter

Mặc định fetch

Owning side và mappedBy

• Bên sở hữu là bên giữ khóa ngoại, thường là phía @ManyToOne
• Bên inverse khai báo mappedBy = "tênFieldBênSởHữu"
• Chỉ thay đổi ở bên sở hữu mới được ghi xuống DB
• Quan hệ hai chiều phải đồng bộ cả hai phía bằng helper method

Nhiều-nhiều

Một-một dùng chung khóa chính

@OneToOne phía inverse (có mappedBy) khó lazy thật sự vì Hibernate phải truy vấn để biết là null hay không. Dùng @MapsId là cách gọn nhất.

CascadeType

orphanRemoval = true: gỡ con khỏi collection của cha thì con bị xóa khỏi DB.

Bẫy hay gặp ở quan hệ

• @OneToMany một chiều không có @JoinColumn sinh thêm bảng nối và câu UPDATE thừa
• toString(), hashCode(), JSON serialize đi vòng giữa hai phía gây StackOverflowError
• Quên gọi helper nên chỉ set một phía, DB không thấy thay đổi
• Trả entity thẳng ra API làm lộ lazy proxy. Dùng DTO

Thao tác của EntityManager

Dirty checking

Entity managed bị sửa thì Hibernate tự UPDATE khi flush. Không cần gọi save().

Cache cấp 1 trong thực tế

Phạm vi của cache cấp 1 là một EntityManager (thường là một transaction).

Lifecycle callback

@PrePersist @PostPersist @PreUpdate @PostUpdate @PreRemove @PostRemove @PostLoad

Dùng merge đúng cách

Hệ phân cấp interface

Method CRUD có sẵn

save() quyết định mới hay cũ thế nào

• Mới (isNew): id null, hoặc cột @Version null → persist
• Còn lại → merge (có thể sinh thêm SELECT)
• Id tự gán tay (không dùng @GeneratedValue) làm mọi lần save đều thành merge, thừa một SELECT. Cách xử lý: implement Persistable<ID> hoặc thêm @Version

Từ khóa derived query

Ví dụ derived query

Phân trang và sắp xếp

Chỉ số trang bắt đầu từ 0.

Projection: chỉ lấy cột cần

Specification (filter động)

Trả null nghĩa là “không thêm điều kiện”. Ngoài ra có Query by Example (repo.findAll(Example.of(probe))) cho trường hợp lọc đơn giản theo ví dụ.

@EntityGraph

Cách khai báo fetch ngay trên method mà không cần viết JPQL.

Custom repository

Tên class implementation phải kết thúc bằng Impl.

N+1 là gì

Phát hiện: bật org.hibernate.SQL hoặc statistics và đếm số câu SQL cho một request.

Cách khắc phục

Ví dụ sửa

MultipleBagFetchException

Xảy ra khi join fetch hai List (bag) trong cùng một query. Cách xử lý:

• Đổi một trong hai sang Set
• Hoặc fetch từng collection bằng query riêng trong cùng transaction
• Hoặc dùng @BatchSize thay cho join fetch

Fetch nhiều collection cùng lúc còn gây tích Descartes, số dòng nhân lên.

LazyInitializationException

Truy cập quan hệ lazy khi session đã đóng (thường ngoài transaction, hoặc ở controller).

• Fetch đủ dữ liệu trong service bằng join fetch / EntityGraph
• Map sang DTO trước khi ra khỏi tầng service
• Không “chữa” bằng cách chuyển sang EAGER hay bật open-in-view

getReferenceById để gán FK

Không cần load nguyên entity chỉ để gán khóa ngoại.

Thuộc tính chính

Propagation

Isolation và hiện tượng đọc

* Theo chuẩn SQL. Một số DB như MySQL InnoDB chặn phần lớn phantom ở mức này.

Khi @Transactional không chạy

• Self-invocation: gọi this.method() trong cùng class không đi qua proxy
• Method private, final hoặc static
• Bean không do Spring quản lý (tự new)
• Checked exception mà không có rollbackFor
• catch exception rồi nuốt mất, transaction thấy như thành công
• Chạy sang thread khác (@Async, parallel stream)

Đặt ở đâu

Đặt ở tầng service, không đặt ở controller hay repository. SimpleJpaRepository đã có sẵn @Transactional(readOnly = true) ở cấp class và @Transactional ở method ghi.

Optimistic lock

Hibernate sinh UPDATE ... WHERE id = ? AND version = ?. Nếu không có dòng nào bị ảnh hưởng, ném OptimisticLockException (Spring dịch thành ObjectOptimisticLockingFailureException).

• Không giữ khóa DB, hợp khi xung đột hiếm
• Xử lý bằng cách retry hoặc báo người dùng tải lại

Pessimistic lock

Sinh SELECT ... FOR UPDATE. Phải chạy trong transaction. Hợp khi xung đột thường xuyên, nhưng dễ deadlock và giảm throughput.

LockModeType

Cache cấp 1 và cấp 2

Bật cache cấp 2 và query cache

Annotation thường gặp

Soft delete

Gọi delete() sẽ thành UPDATE, mọi query tự thêm điều kiện deleted = false.

Truy cập Session

Thuật ngữ tương ứng: EntityManager ↔ Session, EntityManagerFactory ↔ SessionFactory, JPQL ↔ HQL.

Batch insert / update

• Đặt hibernate.jdbc.batch_size (ví dụ 50)
• Bật order_inserts và order_updates
• Dùng SEQUENCE, không dùng IDENTITY
• Với lượng rất lớn: flush() rồi clear() theo từng lô để context không phình ra

Nên

Tránh