JpaRepository và Derived Queries: Truy Vấn Không Cần Viết Code

TL;DR: JpaRepository kế thừa toàn diện từ CrudRepository và PagingAndSortingRepository. Spring Data JPA sử dụng lớp PartTreeJpaQuery để phân tích tên method lúc startup thành câu lệnh JPQL, sau đó Hibernate dịch sang SQL tương ứng với dialect. Bạn hoàn toàn không cần viết một dòng SQL nào. Khi số lượng điều kiện lọc vượt quá 4 hoặc cần tính toán hàm tổng hợp (aggregate), đó là lúc nên chuyển sang @Query.

Cây phân cấp JpaRepository gồm những tầng nào?

Khi một interface kế thừa JpaRepository<Task, Long>, nó thừa hưởng toàn bộ sức mạnh từ cây phả hệ Spring Data:

Trong 99% các tình huống thực tế, ta luôn khai báo kế thừa JpaRepository để sở hữu đầy đủ tiện ích mà không làm phát sinh thêm chi phí overhead.

Cơ chế sinh Proxy tự động lúc Startup

Spring Data không yêu cầu lập trình viên viết code triển khai (implementation class). Thay vào đó:

1. Lúc khởi động ứng dụng, RepositoryFactoryBean tạo ra một JDK Dynamic Proxy.
2. Proxy điều hướng các method CRUD mặc định tới SimpleJpaRepository.
3. Đối với các method tùy biến, proxy kết nối tới cây cú pháp PartTreeJpaQuery đã được biên dịch sẵn.

Cơ chế biến đổi tên phương thức thành câu lệnh SQL ra sao?

Hãy xem xét phương thức sau:

List<Task> findByStatusAndOwnerId(TaskStatus status, Long ownerId);

Spring Data không đối chiếu chuỗi string đơn thuần ở runtime mà thực hiện quy trình chuẩn hóa gồm 3 bước:

1. Phân tích cú pháp (PartTree): Bóc tách findBy (hành động SELECT), Status (thuộc tính 1), And (toán tử logic), OwnerId (thuộc tính 2).
2. Sinh mã JPQL (QueryUtils): Dựng câu truy vấn JPQL trên Entity: SELECT t FROM Task t WHERE t.status = :status AND t.ownerId = :ownerId.
3. Hibernate biên dịch sang SQL: Dựa vào Dialect cơ sở dữ liệu và quy tắc đặt tên (SpringPhysicalNamingStrategy) để sinh SQL thuần: SELECT ... FROM tasks WHERE status = ? AND owner_id = ?.

Cú pháp ngữ pháp (Method Grammar) chuẩn

[verb][Distinct]?[Top N]?By[Property][Keyword][And/Or][Property][Keyword]...[OrderBy...]

Một số tiền tố và từ khóa thông dụng:

• Hành động: find...By, count...By (trả về long), exists...By (trả về boolean), delete...By.
• So sánh: Equals, Not, Like, Containing (tương đương LIKE %?%), StartingWith, Between, In, IsNull.
• Giới hạn & Sắp xếp: Top3By..., OrderByCreatedAtDesc.

public interface TaskRepository extends JpaRepository<Task, Long> {
    Optional<Task> findByTitle(String title);
    List<Task> findByStatusIn(Collection<TaskStatus> statuses);
    List<Task> findByTitleContainingIgnoreCase(String keyword);
    List<Task> findTop5ByProjectIdOrderByCreatedAtDesc(Long projectId);
    long countByStatus(TaskStatus status);
    boolean existsByTitleAndProjectId(String title, Long projectId);
}

Khi nào Derived Query đủ dùng và khi nào nên chuyển sang @Query?

// KHONG NEN: Ten method qua dai gay roi mat
List<Task> findByStatusAndProjectIdAndAssigneeIsNotNullAndDueDateBeforeAndPriorityGreaterThan(
    TaskStatus s, Long pId, Instant d, int minP);

// NEN: Chuyen sang @Query JPQL ro rang
@Query("""
    SELECT t FROM Task t
    WHERE t.status = :status
      AND t.projectId = :projectId
      AND t.assignee IS NOT NULL
      AND t.dueDate < :deadline
      AND t.priority >= :minPriority
""")
List<Task> findUrgentTasks(
    @Param("status") TaskStatus status,
    @Param("projectId") Long projectId,
    @Param("deadline") Instant deadline,
    @Param("minPriority") int minPriority);

Những cạm bẫy phổ biến cần tránh là gì?

1. Lỗi sai tên thuộc tính Entity: Khai báo findByUserId trong khi Entity chỉ có thuộc tính ownerId. Ứng dụng sẽ ném lỗi PropertyReferenceException và dừng ngay khi khởi động.
2. Nguy cơ Out-Of-Memory khi dùng findAll(): Gọi repo.findAll() trên bảng có hàng triệu dòng dữ liệu sẽ tải toàn bộ vào bộ nhớ Heap. Luôn luôn truyền tham số Pageable để phân trang.
3. Dùng Optional cho truy vấn có thể trả về nhiều kết quả: Nếu điều kiện truy vấn khớp từ 2 dòng trở lên, Spring Data sẽ ném lỗi IncorrectResultSizeDataAccessException tại runtime. Chỉ dùng Optional khi trường tìm kiếm có ràng buộc UNIQUE.

Tự kiểm tra kiến thức

Bài tiếp theo: @Query, Modifying & Projection: Truy Vấn Tùy Biến Nâng Cao